Nexus Leads AI — MCP Bridge V1

Servidor MCP remoto e privado para conectar o Nexus Leads AI a clientes compatíveis com Model Context Protocol.

Arquitetura

ChatGPT / MCP Inspector
        ↓ OAuth 2.1
GitHub OAuth + lista de usuários permitidos
        ↓
Cloudflare Worker: nexus-leads-mcp
        ↓
D1 nexus-leads-db + API do Nexus principal

O MCP fica em um Worker separado para evitar que uma falha no conector derrube o site principal.

Related MCP server: git-mcp

Ferramentas incluídas

Somente leitura

• nexus_system_health

• nexus_command_center

• nexus_list_leads

• nexus_get_lead

• nexus_list_tasks

• nexus_list_proposals

• nexus_list_payments

• nexus_list_projects

• nexus_run_full_audit

• nexus_test_api_endpoints

Testes controlados

• nexus_seed_test_scenario: cria um cenário identificado com prefixo mcp_test_.

• nexus_cleanup_test_data: remove somente os registros de teste MCP e exige confirmação literal.

Todas as chamadas tentam registrar auditoria em mcp_audit_log.

Segurança

• OAuth 2.1 intermediado pelo Worker.

• Login pelo GitHub.

• Lista permitida em ALLOWED_GITHUB_USERS.

• Nenhuma chave do Nexus é enviada ao modelo.

• O token GitHub é usado somente para confirmar identidade e não é salvo como dado de negócio.

• Ferramentas de escrita e exclusão são marcadas corretamente no MCP.

• O servidor MCP usa um Durable Object próprio e o mesmo D1 do Nexus.

Instalação resumida

Siga GUIA_INSTALACAO_PASSO_A_PASSO.md.

1. Execute migrations/0017_mcp_bridge.sql no D1.

2. Crie um KV chamado OAUTH_KV.

3. Cole o ID do KV em wrangler.jsonc.

4. Crie um GitHub OAuth App.

5. Cadastre os quatro secrets.

6. Publique este Worker separado.

7. Teste no MCP Inspector.

8. Em um plano do ChatGPT com Developer Mode, adicione a URL HTTPS terminada em /mcp.

Endpoint esperado

https://nexus-leads-mcp.luizfelipeehsilva.workers.dev/mcp