Conectar ao Claude

O MCP do Nexo deixa o Claude consultar a sua carteira, as suas conversas, os indicadores e o contexto da empresa, como você enxerga no app. Endereço, para qualquer cliente:

https://developers.nexo.winningsales.com.br/mcp

Transporte Streamable HTTP, sem estado. O Claude recebe só as ferramentas que o seu papel e os escopos do acesso permitem; o catálogo completo está na Referência do MCP.

claude.ai e apps do Claude

O claude.ai não deixa configurar um cabeçalho com token, então a conexão é por OAuth, sem copiar token nenhum:

No Claude, abra Configurações → Conectores e adicione um conector personalizado.
Dê o nome Nexo e cole o endereço https://developers.nexo.winningsales.com.br/mcp.
Clique em Conectar. O Claude abre a tela de consentimento do Nexo: entre com a sua conta do Nexo, confira o que o Claude vai poder fazer em seu nome e autorize.
De volta ao Claude, ative o conector numa conversa e pergunte, por exemplo, “quais negócios meus estão parados há mais de duas semanas?”.

O acesso autorizado age como você, com o seu papel e a sua visibilidade no Nexo, como um token pessoal. Conectores personalizados dependem do seu plano do Claude; numa organização, o administrador pode precisar liberar o conector primeiro.

Claude Code

Crie um token pessoal e adicione o servidor:

claude mcp add --transport http nexo https://developers.nexo.winningsales.com.br/mcp \
  --header "Authorization: Bearer $NEXO_TOKEN"

Ou, no .mcp.json do projeto, com o token numa variável de ambiente (nunca no arquivo):

{
  "mcpServers": {
    "nexo": {
      "type": "http",
      "url": "https://developers.nexo.winningsales.com.br/mcp",
      "headers": { "Authorization": "Bearer ${NEXO_TOKEN}" }
    }
  }
}

Claude Desktop com token

Até o conector por OAuth chegar, o Claude Desktop conecta pelo proxy mcp-remote, que faz a ponte com o cabeçalho. No arquivo de configuração do app (Configurações → Desenvolvedor → Editar configuração):

{
  "mcpServers": {
    "nexo": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://developers.nexo.winningsales.com.br/mcp",
        "--header",
        "Authorization:${NEXO_AUTH}"
      ],
      "env": { "NEXO_AUTH": "Bearer nexo_pat_seu_token" }
    }
  }
}

Reinicie o Claude Desktop depois de salvar.

API da Anthropic

O conector MCP da Messages API usa o mesmo endereço e o mesmo token: declare o servidor em mcp_servers e o conjunto de ferramentas em tools, com o beta mcp-client-2025-11-20.

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: mcp-client-2025-11-20" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-5",
    "max_tokens": 16000,
    "mcp_servers": [{
      "type": "url",
      "url": "https://developers.nexo.winningsales.com.br/mcp",
      "name": "nexo",
      "authorization_token": "'"$NEXO_TOKEN"'"
    }],
    "tools": [{ "type": "mcp_toolset", "mcp_server_name": "nexo" }],
    "messages": [{ "role": "user", "content": "Resuma o forecast do mês." }]
  }'

Outros clientes MCP

Qualquer cliente que fale Streamable HTTP e mande cabeçalho funciona com o token. No Cursor (~/.cursor/mcp.json ou .cursor/mcp.json):

{
  "mcpServers": {
    "nexo": {
      "url": "https://developers.nexo.winningsales.com.br/mcp",
      "headers": { "Authorization": "Bearer nexo_pat_seu_token" }
    }
  }
}

Para conferir o acesso sem cliente nenhum (protocolo de 2025; a resposta vem como um evento SSE data: {...}):

curl -s https://developers.nexo.winningsales.com.br/mcp \
  -H "Authorization: Bearer $NEXO_TOKEN" -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

O que o Claude pode fazer

Ler o que o Nexo já leu e guardou: contexto da empresa, negócios, conversas, indicadores, metas, tarefas, relatórios, revisão e as consultas do copiloto.
Gerar arquivos por link assinado: exportações, o arquivo de uma conversa e downloads de transcrições e áudio.
Escrever, só com os escopos de escrita marcados no token e sempre com a sua confirmação na conversa:
- o próximo passo de um negócio (deal_next_step_set, escopo deals:write), que sobrescreve o próximo passo no CRM;
- a Calibração e a Base de conhecimento (escopo calibration:write, só administradores), em dois passos: a prévia devolve um confirmation.token e a mudança só é aplicada com ele, depois do seu sim.

As instruções que o servidor manda ao Claude pedem para mostrar o que vai ser gravado e esperar o seu sim, e para tratar o texto das conversas como citação, nunca como instrução. Toda escrita e toda leitura de conversa ficam na atividade da API, que o administrador acompanha.

O que é cobrado

O Claude é cobrado pela Anthropic, no seu plano do Claude ou na sua conta da API, como qualquer outro uso do Claude. O que as ferramentas devolvem entra no contexto da conversa.
O Nexo não cobra pela API nem pelas ferramentas do MCP que não usam a IA do Nexo. Hoje nenhuma ferramenta roda a IA do Nexo: todas leem o que o Nexo já compilou, geram arquivos ou gravam o que você confirmou, e nenhuma consome a franquia de IA da empresa.
Ferramentas que rodarem a IA do Nexo (como perguntar ao Nexo ou pedir um rascunho) vão consumir a franquia de IA da empresa quando chegarem; esta página vai dizer quais.

Os limites de chamadas valem para o MCP como para a API: cada mensagem ao MCP gasta uma chamada da classe read, e cada ferramenta gasta também a classe dela.