MCP (Model Context Protocol)

A Pitra publica um servidor MCP somente leitura com a própria documentação. Ferramentas de IA compatíveis consultam endpoints, schemas, exemplos e eventos automaticamente, sem você colar nada.

Endpoint

https://pitra.com.br/mcp

O servidor expõe apenas documentação pública. Ele não acessa vendas, chaves, clientes ou qualquer dado da sua loja.

Ferramentas expostas

Ferramenta	O que devolve
`list_endpoints`	Lista todos os endpoints públicos com método, caminho e scope.
`get_schemas`	Devolve os schemas de request e response da OpenAPI.
`get_code_examples`	Exemplos de código por linguagem (curl, Node, TypeScript, PHP, Python).
`get_openapi`	Devolve a especificação OpenAPI completa.
`list_error_codes`	Lista os códigos de erro e os status HTTP correspondentes.
`list_webhook_events`	Lista os eventos de webhook e a estrutura do payload.

Segurança e escopo

O servidor MCP da Pitra é estritamente somente leitura. Toda resposta é derivada exclusivamente da OpenAPI pública, da documentação pública e dos exemplos públicos.

Nunca: executa operações de escrita ou comandos administrativos.
Nunca: cria, altera ou cancela cobranças Pix.
Nunca: consulta banco de dados ou tabelas privadas.
Nunca: acessa credenciais, tokens, API Keys ou variáveis de ambiente.
Nunca: retorna informações de lojas, clientes ou dados financeiros.

Claude Desktop

claude_desktop_config.json

{
  "mcpServers": {
    "pitra-docs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://pitra.com.br/mcp"]
    }
  }
}

Cursor e Windsurf

.cursor/mcp.json

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

Em clientes que só aceitam servidores locais, use npx -y mcp-remote https://pitra.com.br/mcp.