COMECE AQUI

Integração assistida por IA

Se você usa Claude, Cursor, ChatGPT ou Copilot para escrever a integração, conecte a IA à nossa documentação. Ela passa a consultar o contrato real em vez de responder de memória.

Servidor MCP

https://docs.validapay.com.br/mcp

Não exige credencial: o servidor apenas lê a documentação. Ele não acessa sua conta nem cria cobranças.

Instalação

Claude Code

claude mcp add --transport http validapay-docs https://docs.validapay.com.br/mcp

Cursorem ~/.cursor/mcp.json

{
  "mcpServers": {
    "validapay-docs": { "url": "https://docs.validapay.com.br/mcp" }
  }
}

VS Codeem .vscode/mcp.json

{
  "servers": {
    "validapay-docs": { "type": "http", "url": "https://docs.validapay.com.br/mcp" }
  }
}

Claude Desktop e ChatGPT: adicione a URL acima em Configurações › Conectores.

Reinicie a sessão depois de instalar. A IA descobre as ferramentas ao iniciar; um servidor adicionado no meio da conversa só aparece na próxima.

O que a IA passa a poder fazer

search_docs

Localiza rota, campo ou código de erro por assunto.

list_endpoints

Mapa da API com os scopes de cada rota.

get_endpoint

Contrato exato: campos obrigatórios, valores aceitos e erros.

get_guide

Fluxo completo de assinatura, split, webhooks e subcontas.

validate_request

Confere o payload antes de você rodar o código.

Como pedir

Não precisa mencionar as ferramentas. Descreva o que você quer:

Crie um endpoint Node.js que gere uma cobrança Pix da ValidaPay com vencimento em 3 dias, vinculada ao pedido do meu sistema, e valide o payload antes de me entregar.

Sem MCP

Se a sua ferramenta não suporta MCP, cole a URL do índice no chat. Todos os recursos abaixo são públicos.

Contrato OpenAPI 3.1/openapi.jsonÍndice para IA/llms.txtDocumentação completa em texto/llms-full.txtCollection Postman/collection.jsonGuia de integração para IA/api/ai-skill

Acrescente .md a qualquer página da documentação para receber a versão em markdown.

Antes de subir para produção

A IA acerta muito mais com essas ferramentas, mas continua sendo IA. Revise o código e teste em sandbox. Valores são sempre em reais, nunca em centavos — é o erro mais caro quando passa despercebido.

Ver as regras gerais da API