Começar
MCP Server
Servidor Model Context Protocol oficial da VamPay — API, docs e ferramentas compostas para agentes
O VamPay MCP Server conecta assistentes de IA (Cursor, Claude Desktop, Claude Code, VS Code e agentes autônomos) diretamente à API VamPay e à documentação — sem adivinhar rotas ou formatos.
O que é MCP?
MCP (Model Context Protocol) é um padrão aberto que define como assistentes de IA se conectam a ferramentas e dados externos. Pense num cabo universal: em vez de cada IA aprender a falar com cada serviço do seu jeito, o serviço publica um servidor MCP e qualquer cliente compatível usa.
| Papel | Quem é | O que faz |
|---|---|---|
| Cliente | Cursor, Claude Desktop, Claude Code, VS Code | Onde você conversa com a IA e aprova o que ela executa |
| Servidor | VamPay MCP Server | Expõe a API, a documentação e as ferramentas da VamPay num formato que a IA entende |
| Credencial | Sua API Key | Define o que o agente pode fazer na sua conta |
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 | vampay://spec/v1, vampay://docs, vampay://webhooks, etc. |
| Prompts | Fluxos sugeridos: criar PIX, configurar webhook, integrar no projeto, testar API Key |
Endpoint
https://api.vampay.com.br/mcpServidor 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 VamPay 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 |
Perguntas frequentes
| Pergunta | Resposta |
|---|---|
| Preciso instalar alguma coisa? | Não. É um servidor remoto: você só informa a URL e a API Key na configuração do seu editor. |
| O agente pode mexer no meu dinheiro? | Ele executa o que a sua API Key permite, inclusive saques. Teste no modo Sandbox e peça confirmação antes de qualquer operação que mova dinheiro. |
| Funciona em quais ferramentas? | Cursor, Claude Desktop, Claude Code, VS Code e outros clientes compatíveis com MCP remoto. |
| Qual a diferença pro llms.txt? | O llms.txt só ensina a IA a ler a API. O MCP também deixa ela executar. Compare em AI Agents. |