https://mcp.squarecloud.app/mcp. A forma de entrar depende do cliente:
Nos dois casos, sua conta precisa de um plano ativo.
Claude
1
Adicione um conector personalizado
No Claude, abra Customize > Connectors, clique em + Add e depois em Add custom connector. Nos planos Team e Enterprise, um Owner adiciona o conector antes em Organization settings > Connectors (Add > Custom > Web), e cada membro depois o conecta em Customize > Connectors.
2
Informe o endereço
Dê o nome
Square Cloud, informe https://mcp.squarecloud.app/mcp e clique em Continue.3
Mantenha a identidade própria do Claude
Mantenha uma opção de entrada (Sign in now ou Sign in when needed) e, como cliente OAuth, Use Claude’s published identity (Recommended). Deixe Request headers vazio e clique em Add.
4
Autorize na Square Cloud
O Claude abre uma página da Square Cloud. Entre na sua conta se for preciso, revise as permissões que o Claude pede e clique para autorizar. Você pode desmarcar permissões para dar menos acesso ao Claude;
mcp sempre fica, já que é ele que conecta.5
Use em um chat
De volta ao Claude, clique em + na caixa do chat, abra Connectors e ative Square Cloud.
A Square Cloud só aceita a identidade publicada do Claude. Register automatically e Use your own OAuth client não funcionam com ela.
ChatGPT
1
Adicione um servidor MCP personalizado
Abra os Plugins do ChatGPT, selecione + e depois Add custom MCP server. Dependendo do seu plano do ChatGPT, um administrador do workspace pode precisar liberar servidores MCP personalizados antes.
2
Informe o endereço
Dê o nome
Square Cloud, escolha o endpoint público como conexão e informe https://mcp.squarecloud.app/mcp. Escolha OAuth como autenticação.3
Crie o servidor
Revise o aviso, selecione I understand and want to continue e depois Create as a plugin.
4
Autorize na Square Cloud
Quando o ChatGPT pedir que você entre, ele abre uma página da Square Cloud. Entre na sua conta se for preciso, revise as permissões e clique para autorizar. Você pode desmarcar permissões;
mcp sempre fica.5
Use em um chat
Comece uma nova conversa, digite
@ e escolha Square Cloud.O ChatGPT muda os nomes desses menus de tempos em tempos. Se estiverem diferentes, siga o guia da OpenAI para conectar um servidor MCP.
Claude Code
Adicione o servidor:/mcp dentro do Claude Code, escolha squarecloud e selecione Authenticate. O navegador abre a página de consentimento da Square Cloud: revise as permissões e clique para autorizar. Funciona do mesmo jeito no terminal e na extensão do VS Code.
Com uma chave de API
Em uma máquina sem navegador, ou para conectar o Claude Code em mais de uma máquina (veja Quanto tempo uma conexão dura), envie uma chave de API em um header em vez disso. Guarde a chave na variável de ambienteSQUARECLOUD_API_KEY e execute:
.mcp.json do projeto; o Claude Code lê a variável toda vez que inicia:
.mcp.json
claude mcp list, ou com /mcp dentro do Claude Code.
VS Code
Adicione o servidor ao.vscode/mcp.json do seu projeto, ou à sua configuração de usuário com MCP: Open User Configuration pela paleta de comandos:
.vscode/mcp.json
Cursor
Adicione o servidor ao.cursor/mcp.json do seu projeto, ou ao ~/.cursor/mcp.json para todos os projetos:
.cursor/mcp.json
SQUARECLOUD_API_KEY no seu ambiente antes de abrir o Cursor. Ative o servidor no menu Customize do Cursor; se ele não conectar, o canal MCP Logs do painel Output mostra o motivo.
Outros clientes
Qualquer cliente que suporte servidores MCP remotos via Streamable HTTP com um header personalizado funciona da mesma forma: use o endereçohttps://mcp.squarecloud.app/mcp e envie a chave de API no header Authorization. O prefixo Bearer é opcional.
Criar uma chave de API
Crie a chave nas configurações de segurança da sua conta:- Dê a ela o escopo
mcp, mais os escopos das ferramentas que você quer que o cliente use. Uma chave com acesso total também funciona. Veja Escopos. - Para acesso somente leitura, escolha
mcp,apps:read,files:read,envs:read,snapshots:readedatabases:read. - Para limitar o cliente a algumas aplicações e bancos de dados, restrinja a chave a eles. Veja Chaves restritas.
Quanto tempo uma conexão dura
Claude, ChatGPT e Claude Code (OAuth). Autorizar cria uma chave de API para aquele cliente, com o nome dele (Claude, ChatGPT ou Claude Code):
- Ela dura 90 dias e não tem refresh token. Quando expira, o cliente pede que você entre e autorize de novo.
- Ela só funciona no servidor MCP. Na API REST, responde
403 MISSING_SCOPE. - Conectar o mesmo cliente de novo revoga a chave anterior dele. Cada conta mantém uma conexão por cliente, então conectar uma segunda conta do Claude, ou o Claude Code em uma segunda máquina, desconecta a primeira.
Authorization em Request headers. Nos planos Team e Enterprise, todos que usam esse conector compartilham o acesso da chave.
As chaves de API que você cria não expiram. Seja qual for a forma de conexão, todas as conexões MCP de uma conta compartilham os mesmos limites.
Desconectar
Revogue a chave nas configurações de segurança da sua conta: a chaveClaude, ChatGPT ou Claude Code de uma conexão OAuth, ou a chave que você criou. O acesso termina na próxima requisição do cliente. Remover o conector ou o servidor no cliente faz ele parar de chamar, mas só revogar a chave na Square Cloud a invalida.
