Usar com IA (MCP)

A SuyPay tem um servidor MCP: conecte num assistente de IA que aceite MCP e peça as coisas em português.

"Cria um Pix de R$ 49,90 para a Maria Silva e me manda o link"
"Quanto eu vendi essa semana, por conta?"
"Cria um Pix Automático mensal de R$ 99 para a Ana, CPF 529.982.247-25"
"Tem alguma contestação para responder?"

Conectar

Crie uma chave em Desenvolvedores → Chaves e MCP. Comece por uma chave de teste. Depois, no seu assistente, adicione um servidor MCP com:

Endereço: https://api.suypay.com/mcp
Cabeçalho: Authorization: Bearer suy_test_... (ou o token de um app OAuth, suy_oat_..., que só vê as ferramentas das permissões aprovadas)

A maioria dos apps aceita este formato:

{
  "mcpServers": {
    "suypay": {
      "type": "http",
      "url": "https://api.suypay.com/mcp",
      "headers": { "Authorization": "Bearer suy_test_..." }
    }
  }
}

Em apps de linha de comando, costuma ser assim:

claude mcp add --transport http suypay https://api.suypay.com/mcp \
  --header "Authorization: Bearer suy_test_..."

Ferramentas

Ferramenta
`create_payment`	criar Pix, boleto ou cartão (devolve o link de pagamento)
`get_payment`	ver uma cobrança e por onde ela passou
`simulate_test_payment`	confirmar uma cobrança da conta de teste da SuyPay, do Asaas sandbox ou do Inter sandbox; exige chave de teste
`list_payments`	listar cobranças
`refund_payment`	devolver dinheiro
`create_pix_automatic`	criar um Pix Automático e o QR Code de aprovação
`list_pix_automatic` / `get_pix_automatic`	ver os Pix Automáticos e os ciclos
`charge_pix_automatic`	cobrar um ciclo (valor variável)
`cancel_pix_automatic`	cancelar um Pix Automático
`list_disputes`	ver MED e chargebacks, com prazo
`submit_dispute_evidence`	responder uma contestação (Stripe e Woovi)
`list_providers`	ver as contas conectadas e as taxas
`simulate_routing`	ver por qual conta uma venda passaria
`get_overview`	resumo de vendas, taxas e valor a receber
`run_reconciliation`	conferir as vendas com as contas

Os erros chegam em português, com o código do motivo (por exemplo [missing_document]), então o assistente sabe o que pedir para você.

Atenção: com uma chave real, o assistente pode devolver dinheiro, cancelar Pix Automático e responder contestações de verdade. A SuyPay pede para ele confirmar com você antes, mas prefira chaves de teste para explorar.