IA / MCP
Integre Cursor, Claude, Trae, Lovable e outros assistentes com a API da Nucleo Pay.
O que está disponível
MCP Server
Exponha a API como ferramentas nativas: criar cobrança PIX, consultar status, webhooks e validar assinaturas.
llms.txt + Manifesto
Contexto estruturado para LLMs: /llms.txt e /api/integrations/mcp/manifest.
Instalação rápida
Baixe NUCLEOPAY.md com um comando — sem clonar o repositório.
Configurar MCP por agente
Escolha seu editor ou assistente e copie a configuração. O MCP roda localmente no seu computador.
Cursor
Claude
Trae
LovableCursor Settings → MCP → adicione o servidor abaixo.
python.exe em command. Não use só python — o Cursor usa o Python interno do Hermes e falha com No module named mcp_server.Setup automático: rode
mcp_server\setup-mcp.ps1 dentro de deploy-backend — ele instala e imprime o JSON pronto.Trae: não use
.bat — causa erro cmd.exe ENOENT.
Ferramentas MCP disponíveis
create_pix_charge, get_pix_charge_status, list_pix_charges, list_webhooks, create_webhook, test_webhook, verify_webhook_signature, generate_integration_snippet
Para quem é cada ferramenta
| MCP Server | llms.txt / Manifesto | |
|---|---|---|
| Objetivo | Executar ações na API via IA | Fornecer contexto para gerar código correto |
| Ideal para | Automações, assistentes, agentes | IDEs com AI coding (Cursor, Trae) |
| Formato | Ferramentas MCP em runtime | Arquivos JSON/Markdown lidos pelo editor |
| Requer API key | Sim (NUCLEOPAY_API_TOKEN) | Não (só documentação) |
Instalação local (cada desenvolvedor)
cwd.
Sem clonar o repo: baixe a documentação com um comando. Para MCP completo, clone o repositório público:
git clone https://github.com/nucleocompany/Nucleo-pay-API-SERVERS.git cd Nucleo-pay-API-SERVERS # Windows (recomendado — gera JSON do MCP) powershell -ExecutionPolicy Bypass -File mcp_server\setup-mcp.ps1 # macOS / Linux python3 -m pip install -e .
Repo: github.com/nucleocompany/Nucleo-pay-API-SERVERS