Início rápido

Pré-requisito: uma conta ativa no Nexo (admin, líder de vendas ou vendedor). Não há nada para ligar na empresa: cada pessoa cria o próprio token, e ele enxerga exatamente o que ela enxerga no app.

1. Crie um token

No Nexo, abra Configurações → Tokens de API e crie um token:

• Nome: para reconhecer o token depois (ex.: “Claude Code no notebook”), até 80 caracteres.
• Escopos: o que o token pode fazer. Por padrão, context:read, conversations:read e exports:create (todas as leituras e exportações). Os escopos de escrita, calibration:write e deals:write, só entram se você marcar.
• Validade: 30, 90 (padrão) ou 365 dias.

O token tem o formato nexo_pat_… e aparece uma vez só, na criação: copie e guarde num cofre de senhas ou numa variável de ambiente. Na lista ficam só o começo e os 4 últimos caracteres. Escopos, limites e revogação: Autenticação.

export NEXO=https://developers.nexo.winningsales.com.br/v1
export AUTH="Authorization: Bearer nexo_pat_seu_token"

2. Confira quem é você

GET /v1/me funciona com qualquer token e diz o que ele enxerga:

curl $NEXO/me -H "$AUTH"

{
  "user": {
    "id": "0199c1a2-…",
    "name": "Ana Beatriz Sales",
    "email": "[email protected]",
    "role": "rep"
  },
  "company": { "id": "0199b7f0-…", "name": "Exemplo Ltda", "timezone": "America/Sao_Paulo" },
  "credential": {
    "id": "019fcae7-…",
    "name": "Claude Code no notebook",
    "kind": "pat",
    "scopes": ["context:read", "conversations:read", "exports:create"],
    "expiresAt": "2027-01-08T14:00:00.000Z"
  },
  "rateLimits": {
    "read": {
      "company": { "limit": 300, "windowSeconds": 60, "burst": 60 },
      "credential": { "limit": 120, "windowSeconds": 60, "burst": 30 }
    }
  }
}

(rateLimits traz todas as classes; o exemplo mostra só read.) role é admin, sales_lead ou rep, e define a visibilidade, igual no app.

3. Leia a sua carteira

curl "$NEXO/deals?page=1&size=25&sort=impact" -H "$AUTH"

A resposta traz items (cada negócio com id, name, accountName, etapa, fase, valor em centavos, temperatura, próximo passo, risco e forecast), total, page e size. O vendedor vê só os próprios negócios; admin e líder veem os da empresa e podem filtrar por dono com ownerId.

Com o id de um negócio:

curl $NEXO/deals/<id> -H "$AUTH"               # raio X do negócio
curl $NEXO/deals/<id>/conversations -H "$AUTH" # conversas do negócio (exige conversations:read)

4. Leve o contexto da empresa para qualquer LLM

curl $NEXO/company/context/pack -H "$AUTH"

O campo markdown é o contexto da empresa em Markdown, no mesmo formato que os prompts do próprio Nexo recebem, pronto para colar em qualquer LLM.

5. Conecte o Claude

O mesmo acesso, como ferramentas para uma IA. No Claude Code:

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

Depois pergunte, por exemplo, “quais negócios meus estão em risco esta semana?”. Para o claude.ai, o Claude Desktop e a API da Anthropic, veja Conectar ao Claude.

Próximos passos

• Limites por classe, erros e paginação: Limites e erros.
• Todas as rotas, campo a campo: Referência da API.
• Todas as ferramentas do MCP: Referência do MCP.