Conecte um cliente de IA ao servidor MCP da Square Cloud

Todos os clientes usam o mesmo endereço, https://mcp.squarecloud.app/mcp. A forma de entrar depende do cliente:

Cliente	Como ele se conecta
Claude (claude.ai e os apps do Claude)	OAuth: cole o endereço e autorize na Square Cloud
ChatGPT	OAuth: cole o endereço e autorize na Square Cloud
Claude Code	Chave de API no header `Authorization`
VS Code	Chave de API no header `Authorization`
Cursor	Chave de API no header `Authorization`
Outros clientes	Chave de API no header `Authorization`

Nos dois casos, sua conta precisa de um plano ativo.

Claude

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.

Informe o endereço

Dê o nome Square Cloud, informe https://mcp.squarecloud.app/mcp e clique em Continue.

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.

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.

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

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.

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.

Crie o servidor

Revise o aviso, selecione I understand and want to continue e depois Create as a plugin.

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.

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

O Claude Code se conecta com uma chave de API em um header, não com OAuth. Guarde a chave na variável de ambiente SQUARECLOUD_API_KEY e execute:

claude mcp add --transport http squarecloud https://mcp.squarecloud.app/mcp \
  --header "Authorization: Bearer $SQUARECLOUD_API_KEY"

O seu shell preenche a chave quando você executa o comando, e o Claude Code a salva na própria configuração. Para compartilhar o servidor com um projeto sem compartilhar a chave, adicione-o ao .mcp.json do projeto; o Claude Code lê a variável toda vez que inicia:

.mcp.json

{
  "mcpServers": {
    "squarecloud": {
      "type": "http",
      "url": "https://mcp.squarecloud.app/mcp",
      "headers": {
        "Authorization": "Bearer ${SQUARECLOUD_API_KEY}"
      }
    }
  }
}

Verifique a conexão com 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

{
  "inputs": [
    {
      "type": "promptString",
      "id": "squarecloud-api-key",
      "description": "Square Cloud API key",
      "password": true
    }
  ],
  "servers": {
    "squarecloud": {
      "type": "http",
      "url": "https://mcp.squarecloud.app/mcp",
      "headers": {
        "Authorization": "Bearer ${input:squarecloud-api-key}"
      }
    }
  }
}

O VS Code pede a chave de API quando o servidor inicia, então ela nunca fica no arquivo. Inicie, pare ou reinicie o servidor com MCP: List Servers.

Isso é diferente da extensão da Square Cloud para VS Code, que gerencia suas aplicações pela barra lateral. Você pode usar as duas.

Cursor

Adicione o servidor ao .cursor/mcp.json do seu projeto, ou ao ~/.cursor/mcp.json para todos os projetos:

.cursor/mcp.json

{
  "mcpServers": {
    "squarecloud": {
      "url": "https://mcp.squarecloud.app/mcp",
      "headers": {
        "Authorization": "Bearer ${env:SQUARECLOUD_API_KEY}"
      }
    }
  }
}

Defina 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ço https://mcp.squarecloud.app/mcp e envie a chave de API no header Authorization. O prefixo Bearer é opcional.

Authorization: Bearer <your API key>

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:read e databases:read.
Para limitar o cliente a algumas aplicações e bancos de dados, restrinja a chave a eles. Veja Chaves restritas.

O segredo aparece uma única vez. Guarde-o em uma variável de ambiente ou no armazenamento de segredos do seu cliente, nunca em um chat ou em um arquivo que você faz commit. As chaves que você cria não expiram: revogue a chave quando parar de usá-la. Uma conta tem até 10 chaves.

Quanto tempo uma conexão dura

Claude e ChatGPT (OAuth). Autorizar cria uma chave de API para aquele cliente, com o nome dele (Claude ou ChatGPT):

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 do Claude e uma do ChatGPT, então conectar uma segunda conta do Claude desconecta a primeira.

Para manter várias conexões ao mesmo tempo, dê a cada conexão extra uma chave de API própria. No Claude, um conector personalizado também pode enviar uma chave de API: escolha No sign in em Authentication e adicione o header 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 chave Claude ou ChatGPT 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.

CLI

VS Code

MCP

SDKs

Conecte um cliente de IA ao servidor MCP da Square Cloud

Claude

ChatGPT

Claude Code

VS Code

Cursor

Outros clientes

Criar uma chave de API

Quanto tempo uma conexão dura

Desconectar

​Claude

​ChatGPT

​Claude Code

​VS Code

​Cursor

​Outros clientes

​Criar uma chave de API

​Quanto tempo uma conexão dura

​Desconectar

Claude

ChatGPT

Claude Code

VS Code

Cursor

Outros clientes

Criar uma chave de API

Quanto tempo uma conexão dura

Desconectar