HyperCash MCP — Documentação de Integração

Guia completo para conectar qualquer SaaS ao processador de pagamentos HyperCash usando o Model Context Protocol (MCP).

Navegação

| Guia | Descrição | |---|---| | Quickstart (5 minutos) | Do zero ao primeiro pagamento aprovado | | Guia para Agentes de IA | Instruções otimizadas para Claude, Cursor e Windsurf | | Dados Sandbox | Cartões, CPFs e PIX para testes | | Referência das Ferramentas | Todas as ferramentas MCP documentadas | | Exemplo Funcional | Projeto completo de checkout para clonar |

O que é o mcp-hyper?

O mcp-hyper é um servidor MCP (Model Context Protocol) que expõe a API de pagamentos da HyperCash como ferramentas que qualquer agente de IA pode chamar diretamente — sem precisar escrever código de integração manual.

Agente de IA (Claude / Cursor / Windsurf)
         ↓  chama ferramenta MCP
    mcp-hyper (servidor MCP)
         ↓  requisição autenticada
  API HyperCash
         ↓  resposta
  Transação criada (PIX / Cartão)

Ferramentas disponíveis

| Ferramenta | O que faz | |---|---| | create_transaction | Cria uma transação (PIX, Cartão de Crédito) | | get_transaction | Consulta o status de uma transação por ID | | list_transactions | Lista transações com filtros e paginação |

Início rápido (30 segundos)

1. Configure no Claude Desktop

// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "hypercash": {
      "command": "npx",
      "args": ["-y", "mcp-hyper"],
      "env": {
        "HYPERCASH_PUBLIC_KEY": "pk_sua_chave_aqui",
        "HYPERCASH_PRIVATE_KEY": "sk_sua_chave_aqui"
      }
    }
  }
}

2. Reinicie o Claude e diga:

"Crie uma transação PIX de R$ 10,00 para João Silva, CPF 529.982.247-25, email [email protected]"

Pronto. O agente cria a transação e retorna o QR Code PIX.

→ Para o fluxo completo de onboarding, veja docs/quickstart.md