Agentes de IA (MCP)

O Perpetuus CRM disponibiliza um servidor MCP (Model Context Protocol) autônomo. Ele permite que agentes (Cursor, Claude Desktop e SDKs) leiam e editem o CRM com as mesmas permissões do seu usuário.

Setup rápido no Cursor

{
"mcpServers": {
  "perpetuus-crm": {
    "command": "npx",
    "args": ["tsx", "src/stdio.ts"],
    "cwd": "./perpetuus-crm-mcp",
    "env": {
      "STRAPI_URL": "https://api.perpetuus.com.br",
      "MCP_CRM_TENANT_ID": "sua-organizacao",
      "MCP_CRM_USER_TOKEN": "seu_token_de_api"
    }
  }
}
}

Por que MCP?

• Interface unificada: o agente lista boards, busca contatos, move cards e cria tarefas sem decorar paths REST.
• Segurança: o MCP só fala com a API REST — tenant, RBAC e plano continuam no backend.
• Ciclo de vida separado: deploy e auditoria independentes do runtime de mensagens.

Rodando localmente

STDIO (Cursor / VS Code)

STRAPI_URL=https://api.perpetuus.com.br \
MCP_CRM_TENANT_ID=sua-organizacao \
MCP_CRM_USER_TOKEN=seu_token_de_api \
npx tsx src/stdio.ts

HTTP (conexões remotas)

STRAPI_URL=https://api.perpetuus.com.br \
MCP_CRM_TENANT_ID=sua-organizacao \
MCP_CRM_USER_TOKEN=seu_token_de_api \
MCP_CRM_HTTP_PORT=3031 \
npx tsx src/http.ts

curl -fsS http://127.0.0.1:3031/health

Catálogo de ferramentas

Contatos

• crm.search_contacts, crm.get_contact, crm.create_contact, crm.update_contact
• crm.add_contact_note

Boards e pipeline

• crm.list_boards, crm.get_board_structure
• crm.search_cards, crm.create_card, crm.update_card, crm.move_card_phase

Analytics

• crm.get_board_report, crm.aggregate_card_field