API e MCP do Nexo

O Nexo lê as conversas com clientes (reuniões, ligações, WhatsApp, e-mail e o que está no CRM) e mantém o estado de cada negócio, os indicadores, as metas e o contexto da empresa. A API pública e o MCP deixam você tirar essa informação do Nexo e usá-la nos seus sistemas e na sua IA, com as mesmas permissões que você tem no app.

• API REST em /v1: o contexto da empresa, os negócios, as conversas, os indicadores, as metas, as exportações e a Calibração, em JSON.
• MCP hospedado em /mcp: as mesmas operações como ferramentas para o Claude e outros clientes MCP, mais as consultas do copiloto do Nexo.

Endereço e autenticação

Base URL: https://developers.nexo.winningsales.com.br/v1
MCP:      https://developers.nexo.winningsales.com.br/mcp
Header:   Authorization: Bearer nexo_pat_seu_token

O token é pessoal: você cria o seu no Nexo em Configurações → Tokens de API, e ele age como você, com o seu papel e a sua visibilidade (o vendedor vê os próprios negócios e conversas; admin e líder de vendas veem os da empresa). Teste:

curl https://developers.nexo.winningsales.com.br/v1/me \
  -H "Authorization: Bearer nexo_pat_seu_token"

401 = token ausente, inválido, expirado ou revogado. Detalhes em Autenticação.

Convenções

Convenção	Regra
Erros	application/problem+json: { type, title, status, detail, requestId, meta? }. O type é estável e em inglês (ex.: public_api.rate_limited); o detail é em português
Limites	Por empresa (todos os tokens somados) e por token, por classe de operação. Toda resposta traz RateLimit-Policy e RateLimit; o 429 traz Retry-After
Listas	Por página (page e pageSize, ou size nos negócios) ou por cursor (cursor, limit e nextCursor) nas conversas e na atividade
Arquivos	Nunca no corpo: exportações, downloads e materiais saem por link assinado do S3, com validade curta
Versão	/v1 só recebe mudanças aditivas. Uma mudança incompatível vira /v2, com pelo menos 12 meses de convivência
Cobrança	A API não tem cobrança extra e nenhuma chamada consome a franquia de IA da empresa. Veja o que é cobrado no MCP

Mapa da documentação

• Início rápido — do token à primeira chamada e ao Claude conectado, em poucos minutos.
• Autenticação — tokens pessoais, escopos, papéis, validade e revogação; a conexão do Claude por OAuth.
• Conectar ao Claude — conector no claude.ai, Claude Code, Claude Desktop e a API da Anthropic; o que é cobrado.
• Limites e erros — os limites por classe, os cabeçalhos, o catálogo de erros, a paginação e os links assinados.
• Referência da API — cada rota /v1 campo a campo, gerada do OpenAPI do Nexo. O contrato bruto fica em /v1/openapi.json.
• Referência do MCP — cada ferramenta do MCP com a entrada, o resultado, o escopo e os papéis.