1. Home
Kushki Docs
Español
  • Español
  • English
  • Kushki Docs
  • Servidor MCP de Kushki Docs
Home
Mexico 🇲🇽Ecuador 🇪🇨Chile 🇨🇱Colombia 🇨🇴Peru 🇵🇪
Home
Mexico 🇲🇽Ecuador 🇪🇨Chile 🇨🇱Colombia 🇨🇴Peru 🇵🇪
Status
Soporte / Support
Español
  • Español
  • English
  1. Home

Servidor MCP de Kushki Docs

Conecta tu asistente de IA a la documentación oficial de productos de Kushki.
Los asistentes de IA se han vuelto una herramienta clave para acelerar las integraciones de pago. Por eso, en Kushki publicamos nuestra documentación de productos como un servidor MCP. Así, herramientas como Claude o Cursor leen directamente nuestras guías, tutoriales y pasos de configuración vigentes, en lugar de depender de su conocimiento previo o de fragmentos que copias a mano.
En esta guía aprenderás qué es MCP, qué puedes consultar a través de él, cómo conectarlo a tu asistente de IA y cómo aprovecharlo en tu integración con Kushki.
Ten en cuenta
Este servidor solo expone nuestra documentación pública. No necesitas credenciales de Kushki para usarlo. La primera vez que se conecta, tu asistente completa con el servidor un proceso de autorización automático: no hay formulario de inicio de sesión ni se te pide ningún dato. Algunos asistentes abren una pestaña del navegador por un momento, o muestran una única vez un botón Connect o Authenticate. El proceso no tiene pantalla de consentimiento a propósito: como el servidor solo sirve documentación pública, no hay nada a lo que conceder acceso.

¿Qué es MCP?#

MCP (Model Context Protocol) es un protocolo abierto que conecta a los asistentes de IA con fuentes de datos externas. Funciona como un canal de comunicación estandarizado: el asistente consulta la información directamente en la fuente y responde con base en lo que dice la documentación hoy.
En Kushki publicamos un único servidor MCP remoto que cubre la documentación de productos de nuestros cinco mercados: México, Perú, Colombia, Ecuador y Chile, en español y en inglés. El servidor lee las guías publicadas en nuestro portal de documentación: cómo funciona cada medio de pago, tutoriales de integración paso a paso, nuestros formularios de pago y SDKs, webhooks y la configuración de la Consola de Administración. Como resultado, la IA explica flujos, responde preguntas sobre los productos y te guía en la integración con base en la versión vigente de la documentación.
Esta es la dirección del servidor MCP de Kushki Docs:
https://mcp.kushki-docs.workers.dev/
El servidor usa el transporte Streamable HTTP, el estándar actual para servidores MCP remotos. Tu asistente se conecta directamente a esa URL, sin instalar nada.
¿Buscas la referencia de la API?
Este servidor cubre nuestras guías de producto y de integración. Para consultar endpoints, schemas y parámetros de las solicitudes, conecta también el servidor MCP de Kushki de la referencia de la API. Ambos servidores se complementan: uno explica cómo integrar y el otro detalla qué espera cada endpoint.
Frecuencia de actualización
El servidor MCP se sincroniza con nuestro portal de documentación cada 24 horas. Si publicamos un cambio en la documentación, puede tardar hasta un día en reflejarse en las respuestas del servidor. Para las actualizaciones más recientes, consulta la guía correspondiente en nuestro portal de documentación.

Qué puedes consultar#

El servidor indexa las guías publicadas en docs.kushki.com para los cinco países, en español y en inglés: medios de pago, tutoriales de integración, formularios de pago y SDKs, notificaciones y webhooks, y la Consola de Administración. No incluye la referencia técnica de la API (para eso está el otro servidor), ni datos de tu cuenta, transacciones o nada que esté detrás de un inicio de sesión.
Tu asistente ve dos herramientas en el servidor:
HerramientaQué hace
Docs-AN___RetrieveBusca en las guías y devuelve los fragmentos más relevantes para una pregunta. Cada fragmento trae el país al que pertenece, la sección del portal, el tipo de contenido (concepto o tutorial), la URL de la página original y un puntaje de relevancia. Es la herramienta que tu asistente usa para responder tus prompts.
x_amz_bedrock_agentcore_searchPermite al asistente descubrir qué herramientas ofrece el servidor. Se usa internamente durante la conexión y no necesitas invocarla.
No invocas estas herramientas tú mismo: escribes una pregunta en el chat y el asistente decide cuándo usarlas. Como referencia, este es un ejemplo abreviado de lo que devuelve Docs-AN___Retrieve para la pregunta "cómo configurar un webhook en Kushki Colombia":
{
  "retrievalResults": [
    {
      "content": {
        "text": "# Notificaciones — ¿Cómo configurar un webhook?\n- **País:** Colombia (co)\n- **Producto / sección:** Notificaciones\n- **Tipo:** tutorial\n- **URL:** https://docs.kushki.com/co/...",
        "type": "TEXT"
      },
      "metadata": { "country": "co" },
      "score": 0.8612
    },
    {
      "content": {
        "text": "# Webhooks — ¿Cómo configurar un webhook?\n- **País:** Chile (cl)\n- **Producto / sección:** Notificaciones > Webhooks\n- **Tipo:** concepto\n- **URL:** https://docs.kushki.com/cl/...",
        "type": "TEXT"
      },
      "metadata": { "country": "cl" },
      "score": 0.7431
    }
  ]
}
El asistente lee esos fragmentos, se queda con los del país que mencionaste y redacta la respuesta en el idioma que uses en el chat. Como cada fragmento incluye la URL de la página original, puedes pedirle que te enlace la guía completa.
Menciona siempre el país
La búsqueda cubre las guías de los cinco mercados a la vez. Si tu prompt no menciona un país, los resultados traen una versión de la guía por cada país, y el asistente puede mezclar pasos o requisitos que no aplican a tu mercado. Incluye el país en cada prompt, por ejemplo "Kushki Colombia" o "Kushki México".

Requisitos previos#

Antes de comenzar, asegúrate de contar con lo siguiente:
Un asistente de IA compatible con MCP, como Claude, Claude Code, Cursor, VS Code o Cline.
La versión más reciente de ese asistente. El soporte para servidores remotos viene incluido en las versiones actuales y mejora con cada lanzamiento.
Conexión a internet, ya que tu asistente consulta la documentación en tiempo real.
Un servidor MCP es una fuente de datos, no un asistente: no tiene interfaz propia. Conectarlo solo le da a tu asistente acceso a nuestra documentación, así que siempre lo consultas desde el chat de la herramienta que ya usas.

Conecta tu asistente#

Busca tu herramienta en las pestañas de abajo y sigue sus pasos. Todas las rutas se conectan al mismo servidor y te dan la misma información, y solo necesitas configurarlo una vez: la URL se mantiene sincronizada con la documentación publicada, así que tu asistente accederá a la versión sincronizada más reciente sin cambios en tu configuración.
Los nombres de los menús de cada herramienta cambian de una versión a otra. Si un paso no coincide con lo que ves en pantalla, la documentación oficial enlazada en cada pestaña tiene los pasos vigentes.
Claude
Claude Code
Cursor
VS Code
Cline
Otros asistentes
En Claude, agregas el servidor como un conector personalizado. Esto funciona tanto en Claude Desktop como en claude.ai, y no requiere editar archivos ni instalar nada.
Sigue estos pasos:
1.
Abre la sección de conectores de la configuración de Claude.
2.
Elige la opción para agregar un conector personalizado.
3.
En el campo Name, escribe Kushki Docs.
4.
En el campo de la URL, pega la dirección del servidor MCP de Kushki Docs.
5.
Confirma con Add. Claude completa la autorización por su cuenta y el conector aparece en la lista como disponible.
6.
Abre un chat nuevo, despliega el menú de conectores y verifica que Kushki Docs esté habilitado.
En organizaciones Team y Enterprise, un owner agrega el conector desde la configuración de la organización, y luego cada miembro lo habilita desde su propia página de conectores. La cantidad de conectores personalizados disponibles depende de tu plan de Claude; consulta la guía oficial de conectores personalizados para el detalle vigente.

Si tu archivo ya contiene otros servidores MCP#

Si el archivo de configuración ya contiene otros servidores, agrega solo el bloque interno "kushki-docs": { ... }, separado del servidor anterior por una coma, y conserva el bloque de tu propia herramienta.
Importante
Mantén una sola clave principal en el archivo. Si la duplicas, el JSON quedará inválido y tu asistente ignorará toda la configuración.
Por ejemplo, así se ve el archivo con los dos servidores de Kushki conectados, el de la referencia de la API y el de la documentación de productos:
{
  "mcpServers": {
    "kushki-apis": {
      "type": "http",
      "url": "https://apidocs-mcp.kushki-docs.workers.dev/"
    },
    "kushki-docs": {
      "type": "http",
      "url": "https://mcp.kushki-docs.workers.dev/"
    }
  }
}

Verifica tu conexión#

Para confirmar que todo funciona, hazle una pregunta de prueba a tu asistente, por ejemplo: "Usando el servidor MCP de Kushki Docs, explícame cómo configurar un webhook en Kushki Colombia." Si la respuesta trae información correcta sobre Kushki, la conexión fue exitosa.
Si tu asistente no responde con información de nuestra documentación, comprueba primero que el servidor esté sano y después revisa los puntos siguientes.

Comprueba que el servidor está sano#

Ejecuta el siguiente comando en tu terminal, o abre la dirección en tu navegador:
La respuesta esperada es status: ok con la lista de herramientas. Significa que el servidor hizo una consulta real a su backend y la documentación está disponible, así que cualquier problema que quede está en tu configuración local:
{"status":"ok","tools":["x_amz_bedrock_agentcore_search","Docs-AN___Retrieve"],"latency_ms":359}
Si la respuesta trae otro status, o el comando devuelve un error, el problema está de nuestro lado y no en tu configuración. Espera unos minutos y vuelve a intentar; nuestro equipo recibe una alerta automática cuando el servidor está caído.

El servidor no aparece en la lista#

Cierra el asistente por completo y vuelve a abrirlo. No basta con editar el archivo de configuración, porque los servidores se cargan al iniciar.

El asistente reporta un error de configuración#

Revisa que la clave principal aparezca una sola vez, que una coma separe cada bloque y que no falten comillas. Un archivo JSON inválido hace que el asistente ignore toda la configuración.
Verifica también que copiaste el bloque de la pestaña de tu propia herramienta. El nombre de la clave principal y el valor del campo type no son intercambiables entre asistentes.

El servidor aparece con la autorización pendiente#

Selecciona el servidor en el panel MCP de tu asistente y confirma la autorización. Es un proceso automático que no te pide credenciales.
Si conectaste el servidor con mcp-remote y deja de responder, borra la carpeta ~/.mcp-auth y reinicia tu asistente para que repita la autorización.

El servidor conecta pero no responde#

Si el servidor aparece como conectado pero todas las preguntas fallan, devuelven un error o vuelven vacías, ejecuta la comprobación de salud descrita arriba. Un status distinto de ok confirma que el que falla es el servidor. Si la comprobación está bien, elimina el servidor de tu asistente, agrégalo de nuevo y repite la autorización.

El asistente responde sin usar el servidor#

Menciona el servidor de forma explícita en tu prompt, por ejemplo: "Usando el servidor MCP de Kushki Docs, busca...".

La conexión falla desde tu red#

Si la comprobación de salud devuelve un timeout o un error de red en lugar de una respuesta, tu red está bloqueando la conexión. Revisa las reglas de salida de tu red y asegúrate de que el tráfico HTTPS hacia mcp.kushki-docs.workers.dev esté permitido.

Casos de uso con Kushki#

Una vez conectado el servidor MCP, tu asistente de IA trabaja con nuestra documentación de productos real. Menciona siempre el país en tus prompts: la búsqueda cubre los cinco mercados y, sin país, el asistente puede mezclar pasos o requisitos de distintos países. Puedes escribir tus preguntas en español o en inglés. Estos son algunos prompts que puedes usar como punto de partida:
Entender un medio de pago
"Según Kushki Docs, ¿cómo funcionan los pagos por transferencia con PSE en Colombia y cuál es la diferencia entre PSE y PSE Avanza?"
Seguir una integración paso a paso
"Usando el servidor MCP de Kushki Docs, guíame paso a paso para integrar una Kajita en el front end de mi sitio web para Kushki México."
Configurar notificaciones
"Explícame cómo configurar un webhook en Kushki México y a qué eventos me puedo suscribir."
Elegir una opción de integración
"Con base en Kushki Docs, ¿qué opciones tengo para aceptar pagos con tarjeta en Kushki Perú y cuál conviene más para una app móvil?"
Configurar la Consola de Administración
"Busca en Kushki Docs dónde encuentro mis credenciales en la Consola de Administración de Kushki Chile y cómo cambio entre los ambientes de pruebas y producción."
Comparar países
"Compara las opciones de pago en efectivo disponibles en Kushki Ecuador y en Kushki Chile, y dime las diferencias."
Combinarlo con la referencia de la API
"Usando Kushki Docs, explícame el flujo de pago con tarjeta en Kushki Perú. Luego, usando el servidor MCP de Kushki de la referencia de la API, genera el código en Node.js para cada paso."
El asistente responde con base en nuestra documentación, pero no la reemplaza. Antes de salir a producción, valida los campos y flujos de tu integración contra las guías y la referencia de la API del país correspondiente.
Con esta conexión, tu asistente deja de adivinar y empieza a construir sobre nuestra documentación oficial. Empieza a integrar Kushki con ayuda de la IA y reduce el tiempo de desarrollo de tu solución de pagos.
Kushki Docs
Explora nuestras guías de producto y tutoriales de integración para cada mercado.
Kushki Developers
Consulta la referencia de la API de cada país.
Model Context Protocol
Conoce cómo funciona el protocolo abierto detrás de esta integración.
Modificado en 2026-10-16 18:20:48
Anterior
Kushki Docs
Built with