Operaciones empresarialesFuente pública

MCP Payments

Operaciones de pago gobernadas MCP — intenciones de pago, puertas de aprobación, evidencias, conciliación y auditoría para agentes de IA

Abrir el código fuente Lee la guía oficial ↗

Qué le ofrece al agente

Una capacidad diseñada específicamente detrás de una conexión MCP.

El servidor posee su lógica de dominio y publica un contrato de herramienta que un cliente MCP puede descubrir. ADK-Rust puede cargar ese contrato en un agente, normalizar cada esquema para el proveedor de modelo elegido y mantener el ciclo de vida de la conexión fuera de la lógica de negocio del agente.

Basado en intenciones — los agentes crean intenciones de pago, nunca ejecutan pagos directamente

Sin ejecución directa — toda acción financiera pasa por evaluación de políticas y puertas de aprobación

Dinero i64 — todos los montos en unidades menores (centavos/peniques), sin punto flotante, sin errores de redondeo

Sin secretos — las credenciales permanecen en referencias de bóveda, nunca en parámetros o respuestas de herramientas

Idempotencia — cada herramienta de escritura requiere idempotency_key para evitar operaciones duplicadas

Registro de auditoría — cada acción registra actor, razón y marca temporal para cumplimiento

Arquitectura

Cómo MCP Payments encaja en un sistema de agentes.

El modelo nunca necesita los detalles de implementación ni las credenciales del sistema detrás del servidor. Ve definiciones de herramientas revisadas. El cliente MCP maneja el descubrimiento y las llamadas, mientras el servidor mantiene la propiedad de la validación, políticas y comunicación con su sistema de dominio.

Agente ADK-Rust

Elige una capacidad del catálogo de herramientas revisado.

→

Cliente MCP

Descubre esquemas, envía llamadas y recibe contenido tipado.

→

MCP Payments

Valida la solicitud y posee 10 contratos de herramientas documentados.

→

Sistema de dominio

Mantiene la API, datos, credenciales y reglas de negocio detrás del servidor.

Conexión: stdio · Marco del servidor: ADK MCP SDK + rmcp

Diagrama de arquitectura de MCP Payments desde su repositorio oficial

Catálogo de herramientas

¿Qué puede pedir un agente a MCP Payments?

Cada herramienta tiene un nombre estable, un propósito legible para humanos y un contrato de entrada JSON descubierto durante la inicialización MCP. Las clases de riesgo provienen del manifiesto del registro del proyecto cuando está disponible.

10 herramientas nombradas

lookup_payment

Buscar una intención de pago por ID

read only

list_customer_payments

Listar todos los pagos de un cliente

read only

get_payment_status

Obtener estado actual de una intención de pago

read only

create_checkout_intent

Crear intención de pago para checkout (Borrador). Montos > 10000 unidades menores requieren aprobación.

internal write

create_refund_intent

Crear intención de reembolso para un pago existente. Dirección=Salida.

financial action

create_payout_intent

Crear intención de pago. Dirección=Salida. Siempre requiere aprobación.

financial action

request_payment_approval

Solicitar aprobación para una intención de pago en Borrador. Cambia Borrador → Pendiente de aprobación.

internal write

execute_approved_intent

Ejecutar una intención de pago aprobada. SOLO funciona si estado=Approved.

financial action

reconcile_payment

Conciliar un pago contra referencia de orden/factura.

internal write

attach_payment_evidence

Adjuntar evidencia a una intención de pago para registro de auditoría.

internal write

Gobernanza

Entiende el efecto de cada herramienta.

Una conexión de servidor hereda la autoridad de sus credenciales y entorno de despliegue. Las declaraciones a continuación provienen del README de este proyecto y del manifiesto del registro MCP; tu aplicación aún decide qué herramientas recibe un agente y dónde se requiere aprobación.

4 internal write3 read only3 financial action

Identificación del actor — cada escritura requiere campo actor que identifica quién/qué inició
Registro de razón — cada escritura requiere razón que explique justificación comercial
Idempotencia — cada escritura requiere idempotency_key que previene ejecución duplicada
Umbrales de monto — intenciones de pago > 10,000 unidades menores requieren aprobación automática
Aprobación de reembolso — todos los reembolsos requieren aprobación de finance_manager
Aprobación de pago — todos los pagos requieren aprobación de finance_manager + compliance_officer

Superficie MCP

Qué declara la documentación actual.

MCP puede transportar herramientas, recursos, indicaciones, resultados estructurados, progreso, cancelación y trabajo de larga duración. Este registro destaca las características modernas del protocolo mencionadas explícitamente por este repositorio.

Suscripciones

ADK MCP SDKrmcpManifiesto del registro

Instalar y conectar

Sigue el punto de partida documentado del proyecto.

Instala el servidor en el entorno que posee sus credenciales y acceso al dominio. Agrégalo a tu host MCP, verifica las herramientas descubiertas y limita el conjunto de herramientas antes de entregarlo a un agente en producción.

Instalar

cargo install mcp-payments

Configuración del cliente MCP

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

Los comandos y la configuración se extraen del README público. Confirma los prerrequisitos, variables de entorno y opciones específicas de la versión en la documentación oficial antes del despliegue.

Documentación oficial

Continúa con la fuente de verdad de los mantenedores del proyecto.

Esta página ofrece un mapa accesible del servidor. El repositorio sigue siendo la autoridad para esquemas exactos, prerrequisitos, configuración, ejemplos, pruebas, versiones y actualizaciones de seguridad.