Agentes MCP

MCP (Model Context Protocol) conecta tu editor con KUTI. El asistente pide docs, contratos y trazas; KUTI responde con datos reales. Los agentes no escriben código ni ven tu repositorio.

Hay dos servidores en mcp.kuti.pe. Cada petición lleva tu API key en Authorization: el servidor no guarda ninguna clave de KUTI. Integration solo escribe con kuti_test_…. Troubleshooter es solo lectura (preset Solo lectura) y también acepta kuti_live_….

Para qué

Integrar la API en lenguaje natural: primer cobro, QR, checkout, suscripciones, webhooks.
Consultar contratos reales (/v1/payment-intents, pi_…, payment.succeeded) sin inventar nombres.
Diagnosticar un cobro, una petición o un webhook con la trazabilidad de KUTI.
Comprobar que tu integración está lista para producción (check_integration / go_live_checklist).

Agente	URL	Rol
KUTI Integration Agent	https://mcp.kuti.pe/integration	Consultar → Generar → Probar → Verificar → Go Live
KUTI Troubleshooter Agent	https://mcp.kuti.pe/troubleshooter	Localizar → Diagnosticar → Resolver → Verificar

Conectar

Copia la config del cliente. En Cursor también puedes instalar de un clic (enlaces más abajo). Después sustituye kuti_test_… por tu API key.

Cursor

VS Code

Claude Code

Windsurf

Instala Integration y, si quieres diagnosticar, Troubleshooter. Luego edita mcp.json y pon tu clave (app.kuti.pe → Desarrolladores → API keys).

~/.cursor/mcp.jsonjson

{
  "mcpServers": {
    "kuti-integration": {
      "url": "https://mcp.kuti.pe/integration",
      "headers": {
        "Authorization": "Bearer kuti_test_…"
      }
    },
    "kuti-troubleshooter": {
      "url": "https://mcp.kuti.pe/troubleshooter",
      "headers": {
        "Authorization": "Bearer kuti_test_…"
      }
    }
  }
}

Sin Authorization puedes consultar docs y generar ejemplos. Para crear un cobro de prueba, registrar un webhook o ver trazas, hace falta la clave. Integration rechaza kuti_live_… en escrituras.

Tools — Integration

Tool	Qué hace	Clave	Prompt sugerido
search_docs / get_doc_page / get_endpoint	Docs, página y contrato real del endpoint	No	¿Cómo creo un payment intent con QR?
get_code_sample / get_integration_recipe / get_webhook_handler	Ejemplos, receta por stack y receptor de webhooks	No	Integra KUTI en este Next.js hasta el primer pago
check_api_key / create_test_payment / simulate_payment	Valida la clave, crea un cobro de prueba y simula el pago	kuti_test_…	Crea un cobro de S/ 50 y simula que se pagó
setup_webhook_endpoint / test_webhook_signature	Registra tu URL y comprueba que rechazas una firma inválida	kuti_test_…	Registra https://mi-app/webhooks/kuti y prueba la firma
check_integration / go_live_checklist	Puntaje de la integración y huecos de producción	Sí	¿Qué me falta para go live?

Tools — Troubleshooter

Solo observa. Pega un pi_…, req_… o whd_… .

Tool	Qué hace	Prompt sugerido
search_transactions / get_payment_trace / get_request_trace	Localiza cobros y la historia de un pago o de una petición	¿Qué pasó con pi_…?
diagnose_payment / diagnose_webhook / explain_error	Por qué está pendiente, por qué no llegó el webhook, qué significa el error.code	El pedido está pagado en KUTI y pendiente en mi sistema
list_payment_events / list_webhook_deliveries / get_webhook_delivery	Eventos del cobro y cada intento de entrega	No me llega payment.succeeded
verify_fix	Vuelve a diagnosticar después de que corregiste	¿Ya quedó resuelto el webhook?

Diagnóstico de errores — request_id, correlation_id y traza de un cobro
SDKs — Node, PHP y Python en tu backend
Autenticación — API keys y preset Solo lectura
Webhooks — firmar y confirmar el pago

Agentes MCP

Para qué

Conectar

Tools — Integration

Tools — Troubleshooter

Siguiente