--- title: "Manual de Conexão do MCP" description: "Como configurar o MCP" url: https://ajuda.customerx.com.br/pt-br/articles/256-manual-de-conexao-do-mcp collection: "MCP" updated: 2026-10-30 language: pt-br --- # Manual de Conexão do MCP Como configurar o MCP ## Conectar um assistente de IA à CustomerX (MCP) Conecte Claude, ChatGPT, Cursor e outros assistentes de IA à CustomerX. Cada assistente enxerga só o que a pessoa que o conectou enxerga. ## Endereço do servidor ```javascript https://mcp.customerx.com.br/mcp ``` Use este endereço em qualquer cliente MCP com transporte HTTP e OAuth 2.1. ## Antes de começar - **O MCP precisa estar liberado para a sua conta.** Sem a liberação, a CustomerX recusa a entrada e mostra o motivo. Peça a liberação ao time da CustomerX. - **Tenha em mãos o seu Token de API.** No menu do seu usuário, no topo da CustomerX, clique em **Ver perfil**. No cartão **API**, clique em **Visualizar Token** e copie o valor de **Seu token de API pessoal**. Mantenha o token em segurança. ## Entrar na CustomerX Na primeira conexão, o assistente abre uma página da CustomerX no navegador: 1. Cole o seu Token de API e clique em **Continuar**. 2. Confira para onde você volta, o e-mail em que o acesso vai valer e o que o assistente vai poder ler. 3. Clique em **Autorizar**. Nos passos abaixo, "entre na CustomerX" quer dizer fazer isso. ## Conectar o seu assistente ### Claude Code 1. No terminal, fora de uma sessão do Claude Code, adicione o servidor na pasta do projeto em que você vai usá-lo: ```javascript claude mcp add --transport http customerx "https://mcp.customerx.com.br/mcp" ``` 2. Entre na CustomerX pelo navegador. Dentro de uma sessão do Claude Code, o comando /mcp faz o mesmo: ```javascript claude mcp login customerx ``` 3. Confira a conexão. O servidor precisa aparecer como **Connected**, porque só adicionar não autoriza: ```javascript claude mcp list ``` ### Claude 1. No [claude.ai](https://claude.ai) ou no Claude para computador, abra **Customize** e depois **Connectors**. Em contas Team e Enterprise, só o Owner adiciona conectores novos. 2. Clique em **Add custom connector**, use customerx em **Name** e informe o endereço em **Remote MCP server URL**: ```javascript https://mcp.customerx.com.br/mcp ``` 3. Deixe as configurações avançadas em branco, clique em **Add** e entre na CustomerX. No celular dá para usar o conector, mas não para criá-lo. ### Cursor 1. Crie ou edite ~/.cursor/mcp.json para valer em todos os projetos, ou .cursor/mcp.json na raiz de um projeto. Servidor remoto leva só a url: ```javascript { "mcpServers": { "customerx": { "url": "https://mcp.customerx.com.br/mcp" } } } ``` 2. Abra a página **Customize** do Cursor (em versões antigas, **Settings** e depois **Tools & MCP**), autorize a conexão do customerx, entre na CustomerX e deixe o servidor ligado. ### VS Code 1. Crie ou edite o .vscode/mcp.json do seu workspace. A chave de topo é servers, não mcpServers, e o VS Code precisa ser 1.101 ou mais novo: ```javascript { "servers": { "customerx": { "type": "http", "url": "https://mcp.customerx.com.br/mcp" } } } ``` 2. Clique em **Start** acima da entrada customerx, confirme a confiança no servidor e entre na CustomerX. ### ChatGPT 1. Só pelo ChatGPT web e como admin ou owner do workspace: ligue o modo desenvolvedor em **Settings**, **Apps**, **Advanced settings**. O suporte completo a MCP está em beta e pede plano Business, Enterprise ou Edu. 2. Em **Apps**, clique em **Create**, use customerx em **Name**, escolha **Public endpoint** e informe o endereço do servidor: ```javascript https://mcp.customerx.com.br/mcp ``` 3. Escolha autenticação **OAuth**, clique em **Scan Tools**, entre na CustomerX e finalize em **Create**. ### Gemini CLI 1. No terminal, cadastre o servidor. Sem --scope user ele vale só na pasta atual: ```javascript gemini mcp add --transport http --scope user customerx "https://mcp.customerx.com.br/mcp" ``` 2. Ou pelo arquivo ~/.gemini/settings.json. O campo é httpUrl: url ali é outro transporte e não conecta. ```javascript { "mcpServers": { "customerx": { "httpUrl": "https://mcp.customerx.com.br/mcp" } } } ``` 3. Abra uma sessão nova do Gemini CLI, rode o comando abaixo e entre na CustomerX: ```javascript /mcp auth customerx ``` ### Codex CLI 1. Adicione o bloco em ~/.codex/config.toml. Precisa do Codex CLI 0.147 ou mais novo: ```javascript [mcp_servers.customerx] url = "https://mcp.customerx.com.br/mcp" auth = "oauth" ``` 2. Entre na CustomerX pelo terminal e confira depois com codex mcp list: ```javascript codex mcp login customerx ``` ### Outros Qualquer cliente MCP com transporte HTTP e OAuth 2.1 com PKCE se conecta pelo endereço do servidor. O cliente se registra sozinho: não é preciso cadastrar nada antes. ```javascript https://mcp.customerx.com.br/mcp ``` ## Desconectar Remover o conector só no assistente não garante que o acesso foi cortado. Para cortar de verdade: 1. Abra [https://mcp.customerx.com.br/revogar](https://mcp.customerx.com.br/revogar) 2. Cole o seu Token de API e clique em **Revogar todos**. - Vale para todos os assistentes que você conectou, de uma vez. Os das outras pessoas da sua empresa continuam conectados. - Trocar o Token de API não desconecta os assistentes. - Para usar de novo, conecte outra vez pelo assistente. ## O que o assistente consegue fazer - Leitura de dados da plataforma operacional (✅ Já funciona) - Leitura de dados do tracking (⏳em breve) - Inserção e alteração de registros (⏳ em breve) Na hora de autorizar, a CustomerX mostra o que ele vai poder ler:

Área

O que inclui

Clientes

Clientes da sua carteira, contatos, health score, receita na ficha do cliente e cadastros da conta.

Contratos e receita

Contratos, financeiro e receita dos clientes da sua carteira, com valores se o seu perfil permite.

Atendimento

Tickets dos clientes da sua carteira, com prazos, SLA e avaliações.

Jornadas e tarefas

Tarefas e jornadas dos clientes, o seu quadro de tarefas e os playbooks da conta.

Pesquisas

Respostas de NPS e CSAT dos clientes da sua carteira, com os comentários.

Churn

Risco de churn dos clientes da sua carteira, oportunidades de upsell e métricas de churn, com valores se o seu perfil permite.