Começar

MCP Server

Servidor Model Context Protocol oficial da Magnus — API, docs e ferramentas compostas para agentes

O Magnus MCP Server conecta assistentes de IA (Cursor, Claude Desktop, Claude Code, VS Code e agentes autônomos) diretamente à API Magnus e à documentação — sem adivinhar rotas ou formatos.

O que o MCP oferece

Camada	O que faz
API automática	Uma tool por operação da API (cobrança PIX, consulta, saldo, taxas, saque, transferência, webhooks) + `execute_operation` genérico
Documentação offline	`search_docs` e `fetch_doc` com índice local (instantâneo, sem depender do site)
Ferramentas compostas	`configure_webhook`, `debug_api_key`, `analyze_webhook`, `wait_for_payment`
Descoberta	`list_operations`, `search_operations` e `get_operation` com o schema de cada operação
Resources	`magnus://spec/v1`, `magnus://docs`, `magnus://webhooks`, etc.
Prompts	Fluxos sugeridos: criar PIX, configurar webhook, integrar no projeto, testar API Key

Endpoint

Streamable HTTPtext

https://api.magnuspay.com.br/mcp

Servidor remoto via HTTP — não precisa instalar nada no Cursor, Claude Code ou VS Code. Autentique com a sua API Key (veja Autenticação MCP).

Por que MCP e não só a documentação?

Colar a documentação no chat ajuda a IA a escrever código. Com o MCP ela também executa: testa sua chave, cria uma cobrança real, confere o webhook e lê o resultado, tudo com os schemas oficiais — sem inventar campo ou rota.

	Só documentação	MCP
Consultar a doc	Sim	Sim (search_docs / fetch_doc)
Gerar código de integração	Sim	Sim, com schemas validados
Executar operações reais	Não	Sim, com a sua API Key
Diagnosticar erro de chave/webhook	Não	Sim (debug_api_key / analyze_webhook)

Fluxo típico

1Conecte o MCP no seu editor (Cursor, Claude Desktop, Claude Code ou VS Code).
2Peça: “Use debug_api_key para testar minha API Key”.
3Peça a integração: “Integre a Magnus no meu projeto com cobrança PIX e webhook” — a IA lê a doc e a spec pelo MCP.
4Teste de verdade: “Crie uma cobrança de R$ 5 e acompanhe até ser paga”.

Próximos passos

Página	Para quê
Autenticação MCP	Como enviar a API Key e boas práticas de segurança
Tools	Todas as ferramentas e seus parâmetros
Prompts	Fluxos prontos registrados no servidor
Exemplos	Pedidos prontos para copiar e colar no chat

Autenticação MCP