> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Servidor MCP da Square Cloud

> Conecte Claude, ChatGPT, Claude Code, VS Code ou Cursor à sua conta da Square Cloud com o servidor MCP remoto e gerencie aplicações e bancos de dados pelo chat.

O servidor MCP da Square Cloud permite que um cliente de IA trabalhe na sua conta pelo [Model Context Protocol](https://modelcontextprotocol.io). Peça em palavras simples e o cliente chama as [ferramentas](https://docs.squarecloud.app/pt-br/mcp/tools.md) por você: ver status, logs, métricas e tráfego da borda, ler e editar arquivos, gerenciar variáveis de ambiente, iniciar e reiniciar aplicações, criar aplicações, bancos de dados e snapshots, e mais.

* **Remoto, nada para instalar:** um único endereço HTTPS para todos os clientes.
* **Duas formas de conectar:** Claude e ChatGPT entram com OAuth em uma página de consentimento da Square Cloud. Claude Code, VS Code, Cursor e outros clientes enviam uma chave de API.
* **Suas permissões decidem:** uma conexão só vê as ferramentas que os escopos dela cobrem, e uma chave limitada a algumas aplicações e bancos de dados só alcança esses recursos.
* **Seu cliente pergunta, seus dados ficam seguros:** o aviso de permissão do seu cliente decide quais mudanças rodam, e excluir uma aplicação ou um banco de dados ou restaurar um snapshot tira um snapshot de segurança antes.

## Endpoint

```text theme={"system"}
https://mcp.squarecloud.app/mcp
```

Este é o único endereço do servidor MCP. Em `api.squarecloud.app` ou em qualquer outro endereço da Square Cloud, requisições MCP respondem `421 WRONG_HOST` com o endereço certo. No sentido inverso, `mcp.squarecloud.app` serve apenas o servidor MCP, nunca a API REST.

## Requisitos

* **Um [plano](https://docs.squarecloud.app/pt-br/platform/plans.md) ativo.** O servidor MCP faz parte de todos os planos da Square Cloud, do Hobby em diante. Sem um plano ativo, toda requisição responde `403 UPGRADE_REQUIRED`. Se o seu plano expirar, suas conexões são mantidas e voltam a funcionar assim que o plano for renovado.
* **Um cliente MCP que suporte servidores remotos** via Streamable HTTP, como Claude, ChatGPT, Claude Code, VS Code ou Cursor. Veja [Conectar um cliente](https://docs.squarecloud.app/pt-br/mcp/connect.md).

## Protocolo

| Tema | Detalhes |
| - | - |
| Transporte | Streamable HTTP, apenas `POST`. O servidor não mantém sessão, e `GET` responde `405`. |
| Versões do protocolo | `2026-07-28`, `2025-11-25`, `2025-06-18` e `2025-03-26`. Clientes da revisão `2026-07-28` chamam sem handshake; clientes mais antigos começam com `initialize`. Uma requisição sem `MCP-Protocol-Version` é lida como `2025-03-26`, e uma versão não suportada responde `400` com a lista das suportadas. |
| Capacidades | Apenas ferramentas, sem recursos nem prompts. |
| Resultados | Cada ferramenta responde um objeto JSON como bloco de texto, com `ok`, um `summary` e, quando algo falhou ou precisa de você, um `code`. |
| Chamadas longas | Uma chamada que leva mais de alguns segundos é respondida como stream (SSE) com keepalives. Fechar a conexão cancela a chamada, e nenhuma chamada roda por mais de 3 minutos. |

## O que fica fora do MCP

* **Projetos com mais de 1 MB.** O cliente pode enviar um projeto do seu computador como zip de até 1 MB, com `upload_application` para uma nova aplicação ou `commit_application` para uma nova versão, e arquivos de texto com `create_application` e `commit_application`. Para um projeto maior, use a [CLI](https://docs.squarecloud.app/pt-br/cli-reference/deploy.md), a [extensão do VS Code](https://docs.squarecloud.app/pt-br/vscode-extension/features.md) ou [deploys pelo GitHub](https://docs.squarecloud.app/pt-br/cli-reference/github-deploys.md).
* **Downloads de snapshots e de certificados de banco de dados.** O link de download assinado iria parar na conversa e no provedor do modelo de IA. Baixe-os pelo dashboard.
* **Atividade da conta.** Ela mostra os endereços IP e os dispositivos da sua conta, por isso fica no dashboard.
* **Valores secretos.** Valores de variáveis de ambiente, arquivos `.env` e chaves privadas nunca chegam ao cliente de IA. Veja [Segredos](https://docs.squarecloud.app/pt-br/mcp/permissions-and-safety.md#segredos).
* **Configurações da conta, cobrança, chaves de API e membros de workspaces.** Eles são gerenciados no dashboard.

## Próximos passos

> [card] [Conectar um cliente](https://docs.squarecloud.app/pt-br/mcp/connect.md)
>
> Configure Claude, ChatGPT, Claude Code, VS Code ou Cursor.

> [card] [Permissões e segurança](https://docs.squarecloud.app/pt-br/mcp/permissions-and-safety.md)
>
> Escopos, chaves restritas e snapshots de segurança.

> [card] [Ferramentas](https://docs.squarecloud.app/pt-br/mcp/tools.md)
>
> Todas as ferramentas e o escopo de que cada uma precisa.

> [card] [Limites e erros](https://docs.squarecloud.app/pt-br/mcp/limits-and-errors.md)
>
> Os limites de requisições e de ferramentas, e o que cada erro significa.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.