Docs · MCP

Conecte uma IA à sua conta

Cada conta da Profluxus pode expor um servidor MCP próprio. Com ele, um assistente como o Claude passa a enxergar suas conversas, contatos, pedidos e cartões do funil, e a agir sobre eles — sem você escrever uma linha de integração. São 281 ferramentas disponíveis.

O que é, em uma frase

MCP é um padrão aberto que descreve como um assistente de IA descobre e usa ferramentas externas. A Profluxus fala esse padrão nativamente: você gera um endereço e um token, cola no seu assistente, e ele passa a poder listar conversas, responder um cliente, mover um cartão ou consultar um relatório.

1. Ligar o servidor na conta

O recurso é liberado por conta. Com o servidor ligado, crie um endereço pela API — o campo slug é o nome que aparece na URL:

curl -X POST "https://talk.profluxus.com/api/v1/accounts/SUA_CONTA/mcp/servers" \
  -H "api_access_token: SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Claude do comercial", "slug": "comercial", "enabled": true }'

A resposta traz o token do servidor. Para trocá-lo depois: POST /api/v1/accounts/:id/mcp/servers/:id/rotate_token. Isso invalida o anterior na hora.

2. O endereço

https://talk.profluxus.com/mcp/<ID_DA_CONTA>/<SLUG>

Um GET nesse endereço devolve o cartão de visita do servidor: nome, se está ativo e a lista completa de ferramentas. Um POST é onde a conversa JSON-RPC acontece — é o que o assistente usa.

3. Autenticação

Duas formas, e a primeira resolve quase todos os casos.

Leitura exige mcp.read; qualquer chamada de ferramenta exige mcp.write. Sem token válido a resposta é 401 com o cabeçalho WWW-Authenticate apontando para a descoberta.

4. Colar no assistente

Claude Code

claude mcp add profluxus \
  --transport http https://talk.profluxus.com/mcp/SUA_CONTA/comercial \
  --header "Api-Access-Token: SEU_TOKEN_MCP"

Claude Desktop

No arquivo claude_desktop_config.json:

{
  "mcpServers": {
    "profluxus": {
      "url": "https://talk.profluxus.com/mcp/SUA_CONTA/comercial",
      "headers": { "Api-Access-Token": "SEU_TOKEN_MCP" }
    }
  }
}

Qualquer cliente (JSON-RPC direto)

# listar as ferramentas
curl -X POST "https://talk.profluxus.com/mcp/SUA_CONTA/comercial" \
  -H "Api-Access-Token: SEU_TOKEN_MCP" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# chamar uma ferramenta
curl -X POST "https://talk.profluxus.com/mcp/SUA_CONTA/comercial" \
  -H "Api-Access-Token: SEU_TOKEN_MCP" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"conversations_list","arguments":{"status":"open"}}}'

Os métodos aceitos são initialize, ping, tools/list, tools/call, resources/list e prompts/list.

5. O que pedir depois de conectar

Alguns pedidos que funcionam bem no dia a dia, já com o servidor ligado:

• Triagem da manhã. "Liste as conversas abertas sem resposta há mais de 4 horas e me diga o assunto de cada uma."
• Resposta com contexto. "Puxe o histórico do contato pelo telefone, veja o último pedido no Shop e escreva uma resposta sobre o prazo de entrega."
• Higiene do funil. "No Pipeline Board, mostre os cartões parados há mais de 10 dias na etapa de proposta e mova para 'Recuperação' os que não têm tarefa aberta."
• Relatório em texto. "Compare o tempo de primeira resposta desta semana com a passada, por caixa de entrada, e resuma em três linhas."
• Rotina de campanha. "Liste os contatos etiquetados como 'orçamento enviado' nos últimos 7 dias e prepare uma campanha de retorno."

As 281 ferramentas

Cada ferramenta é um atalho para um endpoint da API. O nome segue o padrão recurso_ação, e a coluna da direita mostra o caminho correspondente — útil quando você quer o mesmo efeito via API direta.

Nenhuma ferramenta com esse termo. Tente parte do nome, como contact ou kanban.

Quando o MCP não é a ferramenta certa

MCP é para um agente conversar com a sua conta sob demanda. Se o que você quer é reagir a um evento no instante em que ele acontece — mensagem nova, pedido pago, etapa mudou — use webhooks, que empurram o evento para o seu sistema. E se for uma integração fixa entre dois sistemas seus, a API direta é mais simples de operar e depurar.