Pular para o conteúdo principal
O servidor MCP da Square Cloud permite que um cliente de IA trabalhe na sua conta pelo Model Context Protocol. Peça em palavras simples e o cliente chama as ferramentas 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

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 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.

​
Protocolo

​
O que fica fora do MCP

  • Deploy de uma pasta do seu computador. O MCP trabalha com o que já está na Square Cloud. Envie um projeto pela CLI, pela extensão do VS Code ou por deploys pelo GitHub.
  • 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.
  • Configurações da conta, cobrança, chaves de API e membros de workspaces. Eles são gerenciados no dashboard.

​
Próximos passos

Conectar um cliente

Configure Claude, ChatGPT, Claude Code, VS Code ou Cursor.

Permissões e segurança

Escopos, chaves restritas e snapshots de segurança.

Ferramentas

Todas as ferramentas e o escopo de que cada uma precisa.

Limites e erros

Os limites de requisições e de ferramentas, e o que cada erro significa.