MCP para assistentes de IA

Endpoint Streamable HTTP para Cursor, Claude Desktop, Grok e outros clientes MCP.

AutenticaçãoCopy Anchor Link

Usa o mesmo modelo integration_token da API ERP (PR #42): prefixo kmx_live_…, hash SHA-256, escopos em texto, revogação na UI.

Escopos MCP:

Criar tokenCopy Anchor Link

1. Configuração → Integrações (owner/admin).
2. Escolha Uso: MCP (assistentes de IA) ou ERP + MCP.
3. Crie o token e copie o kmx_live_… (exibido uma vez).

API (sessão):

• POST /api/dashboard/integrations/tokens com corpo JSON, por exemplo {"name":"…","scopes":["mcp:read","mcp:write"]}
• DELETE /api/dashboard/integrations/tokens/:id ou POST .../revoke para revogar

EndpointCopy Anchor Link

Header: Authorization: Bearer kmx_live_…

Rate limit: 120 req/min por token (bucket mcp, chave = id do token).

Cursor / Claude DesktopCopy Anchor Link

{
  "mcpServers": {
    "komexi": {
      "url": "https://app.komexi.com.br/api/mcp/mcp",
      "headers": {
        "Authorization": "Bearer kmx_live_COLE_SEU_TOKEN"
      }
    }
  }
}

Stdio local (proxy HTTP)Copy Anchor Link

export KOMEXI_MCP_URL=http://127.0.0.1:3000/api/mcp/mcp
export KOMEXI_MCP_TOKEN=kmx_live_...
cd apps/cms && bun run mcp:stdio

FerramentasCopy Anchor Link

MCP InspectorCopy Anchor Link

npx @modelcontextprotocol/inspector

Transport Streamable HTTP, URL acima, header Bearer com token MCP.

Diagrama: pareamento via MCPCopy Anchor Link

Ferramentas documentadasCopy Anchor Link

Cada ferramenta tem página em Ferramentas MCP.

Páginas relacionadasCopy Anchor Link

• Criar token no painel
• API de integrações