Operações de negóciosCódigo-fonte público

MCP Payments

Operações de Pagamento Governadas MCP — intenções de pagamento, portões de aprovação, evidências, reconciliação e auditoria para agentes de IA

Abrir o código-fonte Leia o guia oficial ↗

O que ele oferece a um agente

Uma capacidade feita sob medida por trás de uma conexão MCP.

O servidor possui sua lógica de domínio e publica um contrato de ferramenta que um cliente MCP pode descobrir. O ADK-Rust pode carregar esse contrato em um agente, normalizar cada esquema para o provedor de modelo escolhido e manter o ciclo de vida da conexão fora da lógica de negócio do agente.

Baseado em intenções — agentes criam intenções de pagamento, nunca executam pagamentos diretamente

Sem execução direta — toda ação financeira passa por avaliação de política e portões de aprovação

Dinheiro i64 — todos os valores em unidades menores (centavos/pence), sem ponto flutuante, sem erros de arredondamento

Sem segredos — credenciais ficam em referências de cofre, nunca em parâmetros ou respostas de ferramentas

Idempotência — toda ferramenta de escrita requer idempotency_key para evitar operações duplicadas

Trilho de auditoria — toda ação registra ator, motivo e timestamp para conformidade

Arquitetura

Como MCP Payments se encaixa em um sistema de agente.

O modelo nunca precisa dos detalhes de implementação ou credenciais do sistema por trás do servidor. Ele vê definições de ferramentas revisadas. O cliente MCP lida com descoberta e chamadas, enquanto o servidor mantém a propriedade da validação, política e comunicação com seu sistema de domínio.

Agente ADK-Rust

Escolhe uma capacidade do catálogo de ferramentas revisado.

→

Cliente MCP

Descobre esquemas, envia chamadas e recebe conteúdo tipado.

→

MCP Payments

Valida a solicitação e possui 10 contratos de ferramentas documentados.

→

Sistema de domínio

Mantém a API, dados, credenciais e regras de negócio por trás do servidor.

Conexão: stdio · Framework do servidor: ADK MCP SDK + rmcp

Diagrama de arquitetura de MCP Payments do seu repositório oficial

Catálogo de ferramentas

O que um agente pode pedir para MCP Payments fazer?

Cada ferramenta tem um nome estável, um propósito legível por humanos e um contrato de entrada JSON descoberto durante a inicialização MCP. Classes de risco vêm do manifesto do registro do projeto quando disponível.

10 ferramentas nomeadas

lookup_payment

Consultar intenção de pagamento por ID

read only

list_customer_payments

Listar todos os pagamentos de um cliente

read only

get_payment_status

Obter status atual de uma intenção de pagamento

read only

create_checkout_intent

Criar intenção de pagamento de checkout (Rascunho). Valores > 10000 unidades menores requerem aprovação.

internal write

create_refund_intent

Criar intenção de reembolso para pagamento existente. Direção=Saída.

financial action

create_payout_intent

Criar intenção de pagamento. Direção=Saída. Sempre requer aprovação.

financial action

request_payment_approval

Solicitar aprovação para intenção de pagamento em Rascunho. Move Rascunho → PendenteAprovação.

internal write

execute_approved_intent

Executar intenção de pagamento aprovada. FUNCIONA SOMENTE se status=Aprovado.

financial action

reconcile_payment

Conciliar pagamento contra referência de pedido/fatura.

internal write

attach_payment_evidence

Anexar artefato de evidência a uma intenção de pagamento para trilha de auditoria.

internal write

Governança

Entenda o efeito de cada ferramenta.

Uma conexão de servidor herda a autoridade de suas credenciais e do ambiente de implantação. As declarações abaixo vêm do README deste projeto e do manifesto do registro MCP; sua aplicação ainda decide quais ferramentas um agente recebe e onde a aprovação é necessária.

4 internal write3 read only3 financial action

Identificação do ator — toda escrita requer campo ator identificando quem/o que iniciou
Registro de motivo — toda escrita requer motivo explicando justificativa comercial
Idempotência — toda escrita requer idempotency_key para evitar execução duplicada
Limites de valor — intenções de checkout acima de 10.000 unidades menores requerem aprovação automática
Aprovação de reembolso — todos os reembolsos requerem aprovação do gerente financeiro
Aprovação de pagamento — todos os pagamentos requerem aprovação do gerente financeiro + oficial de conformidade

Superfície MCP

O que a documentação atual declara.

O MCP pode transportar ferramentas, recursos, prompts, resultados estruturados, progresso, cancelamento e trabalhos de longa duração. Este registro destaca os recursos modernos do protocolo explicitamente mencionados por este repositório.

Assinaturas

ADK MCP SDKrmcpManifesto do registro

Instalar e conectar

Siga o ponto de partida documentado do projeto.

Instale o servidor no ambiente que possui suas credenciais e acesso ao domínio. Adicione-o ao seu host MCP, verifique as ferramentas descobertas e restrinja o conjunto de ferramentas antes de entregá-lo a um agente de produção.

Instalar

cargo install mcp-payments

Configuração do cliente MCP

{
  "mcpServers": {
    "payments": {
      "command": "mcp-payments",
      "args": [],
      "env": {}
    }
  }
}

Comandos e configurações são extraídos do README público. Confirme pré-requisitos, variáveis de ambiente e opções específicas da versão na documentação oficial antes da implantação.

Documentação oficial

Continue com a fonte de verdade dos mantenedores do projeto.

Esta página fornece um mapa acessível do servidor. O repositório permanece autoritativo para esquemas exatos, pré-requisitos, configuração, exemplos, testes, versões e atualizações de segurança.