Integrar com IA — Servidor MCP
Sandbox
http://localhost:4500/api/v1
Sandbox
http://localhost:4500/api/v1
POST
/mcp
Cursor, etc.) para este endpoint com a chave da sua empresa e ele digita e acompanha
propostas em linguagem natural — sem escrever código de integração.
Conectar (ex.: Claude / Cursor)
{
"mcpServers": {
"nexxus": {
"type": "http",
"url": "https://api.nexxusbank.com.br/api/v1/mcp",
"headers": { "Authorization": "Bearer nxx_pr_SUA_CHAVE" }
}
}
}parcela 300, tabela 1, quitando 1000 do Banco Santander" — o agente chama as tools
e devolve o
codigo da proposta.Tools disponíveis (filtradas pelos escopos da chave)
| Tool | Faz |
|---|---|
nexxus_testar_integridade | Health check da API/banco/chave |
nexxus_minha_conta | Empresa e escopos da chave |
nexxus_listar_tabelas | Tabelas de operação (coeficiente/seguro) |
nexxus_digitar_proposta | Digita proposta na esteira |
nexxus_listar_propostas | Lista com filtros e paginação |
nexxus_consultar_proposta | Fase atual, pendências e eventos |
nexxus_eventos_proposta | Linha do tempo (incremental) |
nexxus_criar_webhook | Registra webhook |
nexxus_listar_webhooks | Lista webhooks ativos |
nexxus_remover_webhook | Desativa webhook |
Protocolo
initialize, tools/list, tools/call,ping. Versões suportadas: 2025-06-18, 2025-03-26, 2024-11-05. Erros de negóciovoltam legíveis (
result.isError) para o agente se autocorrigir. É o mesmo núcleo doREST — tudo que a API faz, a IA faz.
Requisição
Parâmetros Bodyapplication/json
Respostas
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location 'http://localhost:4500/api/v1/mcp' \
--header 'Content-Type: application/json' \
--data '{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-06-18",
"capabilities": {},
"clientInfo": {
"name": "meu-agente",
"version": "1.0"
}
}
}'Response Response Example
{
"error": {
"code": "CHAVE_INVALIDA",
"message": "Chave de API inválida",
"revogada ou empresa inativa.": null
}
}Modificado em 2026-07-08 01:52:25