# Soporte y diagnóstico

> Herramientas del MCP para responder con las guías oficiales y probar la conexión con el API.

- kind: mcp-tool
- status: stable
- access: read
- last_verified: 2026-10-07
- url: https://tilopay.com/developers/agentes/mcp/soporte

## Qué cubre [#que-cubre]

Tres herramientas de lectura: una responde preguntas de uso del panel con las guías oficiales de tilopay.com/guias, otra prueba las credenciales y un endpoint de cada grupo del API para saber qué parte responde cuando algo falla, y la tercera analiza un fragmento de código o un stack trace que le pases y devuelve diagnóstico, causa raíz, corrección y riesgos. Esa última no lee repositorios ni ejecuta código.

## Herramientas [#herramientas]

### Diagnóstico de conexión con Tilopay [#tilopay-diagnostics]

- `tilopay_diagnostics`
- Acceso: Sólo lectura

Verifica las credenciales del usuario y prueba un endpoint de cada grupo (ventas/transacciones, catálogo, recurrentes, tarjetas almacenadas). Úsalo cuando una herramienta falle para saber qué parte del API responde.

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `environment` | string (production | test) | — | Ambiente para la prueba de transacciones (por defecto production) |

**Devuelve**

`{ checks, failed }`

checks es una lista con check, ok y detail por cada prueba: credenciales, transacciones, catálogo, recurrentes y tarjetas almacenadas. failed es la cantidad de pruebas con error. Las credenciales se devuelven enmascaradas.

### Ayuda con las guías y tutoriales de Tilopay [#tilopay-help-guides]

- `tilopay_help_guides`
- Acceso: Sólo lectura

Responde dudas de uso del panel de Tilopay (links de pago, catálogo, suscripciones, depósitos de garantía, reembolsos, API/SDK) usando las guías oficiales de tilopay.com/guias. Devuelve extractos y los enlaces a las guías.

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `question` | string | sí | Pregunta del comercio, tal como la escribió |

**Devuelve**

`{ articles }`

Hasta 3 artículos con title, url y excerpt, tomados de tilopay.com/guias. Si no hay coincidencia devuelve articles vacío y un texto con las guías disponibles.

### Depurar código [#tilopay-debug-code]

- `tilopay_debug_code`
- Acceso: Sólo lectura

Analiza un fragmento de código o stack trace que envía el usuario y devuelve diagnóstico, causa raíz, corrección concreta y riesgos. No lee repositorios ni ejecuta código.

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `code` | string | sí | Fragmento de código, log o stack trace tal como lo envió el usuario |
| `error` | string | — | Mensaje de error o comportamiento observado, si lo hay |
| `language` | string | — | Lenguaje o stack (ej. typescript, php, react). Si no se indica, se detecta |
| `context` | string | — | Qué debería hacer el código o en qué momento falla |

**Devuelve**

`{ report, truncated, redacted, model }`

report es el diagnóstico en texto (diagnóstico, causa raíz, corrección y riesgos). truncated indica si el código se recortó a 12.000 caracteres; redacted, si se ocultaron posibles credenciales antes del análisis; model, el modelo usado. No lee repositorios ni ejecuta el código.