Manual de Conexão do 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

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:

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:

claude mcp login customerx

3. Confira a conexão. O servidor precisa aparecer como Connected, porque só adicionar não autoriza:

claude mcp list

Claude

1. No 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:

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:

{
  "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:

{
  "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:

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:

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.

{
  "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:

/mcp auth customerx

Codex CLI

1. Adicione o bloco em ~/.codex/config.toml. Precisa do Codex CLI 0.147 ou mais novo:

[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:

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.

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

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: