MCP do Payments Gateway

O servidor MCP do Payments Gateway expõe as APIs do Gateway da Inyo como ferramentas prontas para IA. Ele cuida da autenticação OAuth automaticamente, fazendo cache e atualizando os tokens conforme necessário.

Pacote: @inyo-global/gateway-mcp

Instalação

Escolha seu cliente para começar:

Cursor

Instalar no Cursor

ou configure manualmente

Adicione à sua configuração de MCP do Cursor em ~/.cursor/mcp.json:

{
  "mcpServers": {
    "inyo-gateway": {
      "command": "npx",
      "args": ["-y", "@inyo-global/gateway-mcp@latest"],
      "env": {
        "GATEWAY_BASE_URL": "your-gateway-url",
        "GATEWAY_CLIENT_ID": "your-client-id",
        "GATEWAY_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Ou acesse Settings → MCP Servers no Cursor e adicione a configuração por lá.

VS Code

Instalar no VS Code

ou configure manualmente

Adicione ao arquivo .vscode/mcp.json na raiz do seu projeto:

{
  "mcpServers": {
    "inyo-gateway": {
      "command": "npx",
      "args": ["-y", "@inyo-global/gateway-mcp@latest"],
      "env": {
        "GATEWAY_BASE_URL": "your-gateway-url",
        "GATEWAY_CLIENT_ID": "your-client-id",
        "GATEWAY_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Windsurf

Adicione à sua configuração de MCP do Windsurf em ~/.windsurf/mcp.json:

{
  "mcpServers": {
    "inyo-gateway": {
      "command": "npx",
      "args": ["-y", "@inyo-global/gateway-mcp@latest"],
      "env": {
        "GATEWAY_BASE_URL": "your-gateway-url",
        "GATEWAY_CLIENT_ID": "your-client-id",
        "GATEWAY_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Claude Desktop

Adicione à sua configuração do Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "inyo-gateway": {
      "command": "npx",
      "args": ["-y", "@inyo-global/gateway-mcp@latest"],
      "env": {
        "GATEWAY_BASE_URL": "your-gateway-url",
        "GATEWAY_CLIENT_ID": "your-client-id",
        "GATEWAY_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Reinicie o Claude Desktop após salvar a configuração.

Claude Code (CLI)

Execute o seguinte comando para adicionar o servidor MCP:

claude mcp add inyo-gateway \
  -e GATEWAY_BASE_URL=your-gateway-url \
  -e GATEWAY_CLIENT_ID=your-client-id \
  -e GATEWAY_CLIENT_SECRET=your-client-secret \
  -- npx -y @inyo-global/gateway-mcp@latest

Ou adicione ao arquivo .mcp.json na raiz do seu projeto (ou em ~/.claude/mcp.json globalmente):

{
  "mcpServers": {
    "inyo-gateway": {
      "command": "npx",
      "args": ["-y", "@inyo-global/gateway-mcp@latest"],
      "env": {
        "GATEWAY_BASE_URL": "your-gateway-url",
        "GATEWAY_CLIENT_ID": "your-client-id",
        "GATEWAY_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Variáveis de Ambiente

Variável	Descrição
`GATEWAY_BASE_URL`	URL do endpoint da API do Gateway
`GATEWAY_CLIENT_ID`	Identificador de cliente OAuth
`GATEWAY_CLIENT_SECRET`	Segredo de cliente OAuth

Entre em contato com seu representante de conta Inyo para obter suas credenciais. Para testes em sandbox, use a URL e as credenciais do seu ambiente sandbox.

Ferramentas Disponíveis

Operações de Pagamento

Ferramenta	Descrição
`create-payment`	Cria um novo pagamento (PULL, PUSH, PULLPUSH ou CHECK)
`capture-payment`	Captura um pagamento previamente autorizado
`void-payment`	Cancela (void) um pagamento antes da liquidação
`refund-payment`	Reembolsa um pagamento liquidado

Verificação de Contas

Ferramenta	Descrição
`check-card-account`	Verifica os dados de uma conta de cartão (verificação ANI)
`check-bank-account`	Verifica os dados de uma conta bancária

Operações de Leitura

Ferramenta	Descrição
`authenticate`	Aciona manualmente a autenticação OAuth
`get-payment`	Recupera os detalhes de um pagamento pelo ID

Serviços Adicionais

Ferramenta	Descrição
`create-fx`	Gera uma cotação de câmbio
`create-plaid-link`	Cria um Plaid Link token para vinculação de conta bancária
`get-plaid-link`	Recupera os detalhes de uma sessão do Plaid Link

Tipos de Pagamento

A ferramenta create-payment suporta múltiplos tipos de pagamento:

Tipo	Descrição
PULL	Capta fundos de uma origem de pagamento (cobrança em cartão, débito ACH)
PUSH	Envia fundos a um destinatário (OCT, payout)
PULLPUSH	Capta e envia em uma única operação
CHECK	Verificação de conta sem cobrança

Métodos de Pagamento Suportados

Cartões — Visa, Mastercard, crédito e débito
Contas bancárias — Débito direto ACH
PIX — Pagamentos instantâneos brasileiros
Carteiras digitais — Onde houver suporte

Autenticação

O servidor MCP gerencia os tokens OAuth automaticamente:

Na primeira chamada de ferramenta, o servidor se autentica usando suas credenciais de cliente
O token de acesso é armazenado em cache na memória
Os tokens são renovados automaticamente 60 segundos antes da expiração
Nenhum gerenciamento manual de tokens é necessário

Exemplo de Uso

Depois de configurado, você pode interagir com o Gateway em linguagem natural no seu assistente de IA:

"Crie um pagamento com cartão de $50 usando o token tk_abc123"
"Verifique o status do pagamento pay_xyz789"
"Reembolse o pagamento pay_xyz789 no valor de $25"
"Cancele (void) a autorização do pagamento pay_abc456"
"Verifique esta conta de cartão: 4111111111111111"

O assistente de IA traduz sua solicitação na chamada de ferramenta apropriada, executa-a na API do Gateway e retorna a resposta estruturada.