> ## 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. # Conecte um cliente de IA ao servidor MCP da Square Cloud > Conecte Claude e ChatGPT com OAuth, ou Claude Code, VS Code e Cursor com uma chave de API, ao servidor MCP da Square Cloud, e saiba quanto tempo uma conexão dura. 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) (claude.ai e os apps do Claude) | OAuth: cole o endereço e autorize na Square Cloud | | [ChatGPT](#chatgpt) | OAuth: cole o endereço e autorize na Square Cloud | | [Claude Code](#claude-code) | [Chave de API](#criar-uma-chave-de-api) no header `Authorization` | | [VS Code](#vs-code) | [Chave de API](#criar-uma-chave-de-api) no header `Authorization` | | [Cursor](#cursor) | [Chave de API](#criar-uma-chave-de-api) no header `Authorization` | | [Outros clientes](#outros-clientes) | [Chave de API](#criar-uma-chave-de-api) no header `Authorization` | Nos dois casos, sua conta precisa de um [plano](https://docs.squarecloud.app/pt-br/platform/plans.md) 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**. > [!NOTE] > > 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](https://chatgpt.com/plugins), 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**. > [!NOTE] > > O ChatGPT muda os nomes desses menus de tempos em tempos. Se estiverem diferentes, siga o [guia da OpenAI para conectar um servidor MCP](https://developers.openai.com/apps-sdk/deploy/connect-chatgpt). ## Claude Code O Claude Code se conecta com uma [chave de API](#criar-uma-chave-de-api) em um header, não com OAuth. Guarde a chave na variável de ambiente `SQUARECLOUD_API_KEY` e execute: ```bash theme={"system"} 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: ```json .mcp.json theme={"system"} { "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: ```json .vscode/mcp.json theme={"system"} { "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](#criar-uma-chave-de-api) quando o servidor inicia, então ela nunca fica no arquivo. Inicie, pare ou reinicie o servidor com **MCP: List Servers**. > [!TIP] > > Isso é diferente da [extensão da Square Cloud para VS Code](https://docs.squarecloud.app/pt-br/vscode-extension/installation.md), 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: ```json .cursor/mcp.json theme={"system"} { "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. ```http theme={"system"} Authorization: Bearer ``` ## Criar uma chave de API Crie a chave nas [configurações de segurança da sua conta](https://squarecloud.app/pt-br/account/security): * **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](https://docs.squarecloud.app/pt-br/mcp/permissions-and-safety.md#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](https://docs.squarecloud.app/pt-br/mcp/permissions-and-safety.md#chaves-restritas-a-aplicações-e-bancos-de-dados). 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](https://docs.squarecloud.app/pt-br/mcp/limits-and-errors.md). ## Desconectar Revogue a chave nas [configurações de segurança da sua conta](https://squarecloud.app/pt-br/account/security): 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. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.