El conector de Koko

Última actualización: 13 de agosto de 2026

Koko se conecta a Claude y ChatGPT como una app, de modo que un viaje que planifiques en una conversación puede guardarse en tu cuenta de Koko, abrirse en un mapa, compartirse con las personas que viajan contigo y editarse más tarde desde esa misma conversación. Esta página explica la configuración, qué hace cada herramienta, a qué puede y no puede acceder el asistente, y los límites.

Configuración

Necesitas una cuenta gratuita de Koko. Regístrate primero en kokotravel.ai, o crea una durante el flujo de conexión.

Detalles del servidor

Endpoint MCP: https://kokotravel.ai/mcp
Transporte: HTTP en streaming (JSON-RPC sin estado)
Autenticación: OAuth 2.1 con PKCE y registro dinámico de cliente. No hay ningún ID de cliente ni clave API que pegar.

En Claude

Abre Settings → Connectors y añade Koko, desde el directorio o como conector personalizado usando el endpoint anterior.
Haz clic en Connect. Se abrirá la página de inicio de sesión de Koko.
Inicia sesión con Google, con tu correo y un código de seis dígitos, o con tu usuario y contraseña de Koko. Después concede el acceso.

En ChatGPT

Añade Koko desde el directorio de apps, o como conector usando el endpoint anterior.
Haz clic en Connect e inicia sesión en Koko del mismo modo.

En Claude Code u otro cliente MCP

claude mcp add --transport http koko https://kokotravel.ai/mcp

Después ejecuta /mcp y completa el inicio de sesión en el navegador.

Qué puede hacer el conector

Seis herramientas, todas limitadas a la cuenta con la que has iniciado sesión. Las herramientas de lectura pueden ejecutarse sin pedir confirmación cada vez; las de escritura cambian tu contenido guardado, y update_koko sustituye una lista completa, así que Claude pregunta antes de ejecutarla.

send_to_koko Guardar una lista o plan en Koko Escritura

Crea una nueva lista o plan en tu cuenta a partir de los lugares descritos en la conversación. Un conjunto simple de lugares se convierte en una lista; los lugares con horas agrupados por días se convierten en un plan. Koko geocodifica cada lugar y después completa valoraciones, horarios y fotos en segundo plano. Devuelve un enlace de visualización al instante.

my_koko Mis listas & planes Solo lectura

Muestra lo que ya hay en tu cuenta: título, tipo, número de lugares e id. No se expone nada más de tu cuenta.

get_koko Abrir una lista o plan para editar Solo lectura

Devuelve una lista o plan como estructura editable para que el asistente pueda cambiarlo y enviar de vuelta la nueva versión.

check_koko_status Comprobar el progreso Solo lectura

Informa de en qué punto está la creación: recibido, localizando, enriqueciendo, listo. Es útil justo después de guardar, porque primero aparecen los pines y después las fotos.

update_koko Actualizar una lista o plan Sustitución total

Sustituye el contenido de una lista o plan existente por una versión nueva. Todo lo que quede fuera de la sustitución se elimina; por eso cuenta como una acción destructiva y te pide confirmación antes. El id y el enlace para compartir siguen siendo los mismos, así que cualquiera con quien ya lo hayas compartido verá la actualización.

refresh_details Actualizar valoraciones & fotos Escritura

Vuelve a obtener valoraciones, reseñas, horarios y fotos de una lista existente. Esto le cuesta dinero a Koko por cada lugar, así que primero hace una estimación y solo gasta cuando confirmas.

Herramientas de partner (creadores certificados)

Los creadores certificados —los miembros del programa de partners que publican en Discover— tienen ocho herramientas más. En cualquier otra cuenta responden “no es un creador certificado” y no cambian nada. Todas están limitadas a tu propia tienda.

creator_profile Mi perfil de creador Solo lectura

Lee el perfil de tu tienda: nombre, etiquetas, lema, bio, ubicación, enlaces, redes, precio predeterminado y si eres visible en Discover.

update_creator_profile Actualizar mi perfil de creador Escritura

Cambia esos mismos campos. Envía solo lo que deba cambiar; las etiquetas se sustituyen en bloque. El identificador no se puede cambiar nunca, porque es tu URL pública.

my_listings Mis publicaciones Solo lectura

Todas las listas y planes que tienes, indicando si están en Discover, su nivel de precio, el enlace para compartir, las visitas de los últimos 30 días y las compras e ingresos acumulados.

set_listing Publicar en Discover / retirar de Discover Escritura

Pone una de tus listas o planes en el escaparate público de Discover con un precio de la escala estándar (Gratis, $1, $2, $5, $10), o lo retira. Al retirarlo, el precio siempre se borra.

creator_stats Estadísticas de creador Solo lectura

Visitas, visitantes únicos, compras e ingresos a 7, 30 o 90 días, de toda la tienda o de una sola publicación, con totales y una serie diaria.

create_coupons Crear códigos de cupón Escritura

Genera códigos para una publicación de pago: uno o cincuenta, de un solo uso o un código con muchos usos. Un cupón indica el nivel más bajo que paga el comprador (gratis por defecto), nunca un porcentaje.

coupons Cupones de una publicación Solo lectura

Todos los códigos de una de tus publicaciones, activos y desactivados, con cuántas veces se han usado y quién los ha usado.

disable_coupon Desactivar un cupón Escritura

Impide que un código se pueda canjear. Su historial se conserva.

Prompts de ejemplo

“Hazme una lista de tres restaurantes de ramen famosos en Shibuya, Tokio: Ichiran Shibuya, Nagi Golden Gai y Hakata Ippudo Shibuya. Guárdala en Koko como ‘Shibuya Ramen’.”

Usa send_to_koko. Recibes un enlace para verla.

“Planifica un día en Asakusa, Tokio: Senso-ji a las 09:00, comida en Daikokuya Tempura a las 12:00, Tokyo Skytree a las 14:00. Guárdalo en Koko como ‘Asakusa Day’.”

Usa send_to_koko y guarda un plan en lugar de una lista, porque las paradas tienen horas.

“¿Qué tengo guardado en Koko?”

Usa my_koko.

“¿Está lista ya mi lista Shibuya Ramen?”

Usa check_koko_status.

“En mi lista Shibuya Ramen, quita Hakata Ippudo y añade Afuri Ebisu en su lugar.”

Usa get_koko y luego update_koko. Mismo enlace, contenido actualizado.

A qué puede y no puede acceder el asistente

Puede: crear, leer y actualizar las listas y planes de la cuenta de Koko con la que has iniciado sesión.
No puede: ver el contenido de ningún otro usuario, eliminar tu cuenta, cambiar tus datos de inicio de sesión ni hacer nada público. Publicar en la sección pública Discover de Koko está restringido a las cuentas de operador de Koko; en una cuenta normal, esa solicitud se guarda en privado y la respuesta te lo indica.
Privacidad de lo que se guarda: las listas y planes creados a través del conector son privados. El enlace de visualización solo se muestra para ti cuando has iniciado sesión en la web app de Koko. Compartir es un paso aparte y deliberado que haces en la app.
Qué recibe Koko: solo las solicitudes que el asistente hace en tu nombre, por ejemplo una lista de nombres de lugares para guardar. Tu conversación permanece con el proveedor del asistente. Todos los detalles están en la política de privacidad.

Límites

Las llamadas a herramientas tienen un límite de frecuencia de unas 30 por minuto y usuario. Si lo superas, recibes un 429 con una cabecera Retry-After.
Los guardados se crean en segundo plano y entran en cola cuando hay carga. En un plan grande, las fotos y las valoraciones tardan alrededor de un minuto en terminar de aparecer.
El conector es gratis y nada de lo que hace puede gastar dinero. Lo esencial de Koko también es gratis; algunos creadores venden sus listas en el escaparate Discover de la app como compras de la App Store, pero los datos de pago nunca pasan por Koko en ninguno de los dos casos. Los límites de las cuentas estándar están en las Condiciones.
Koko es una vista previa de acceso anticipado creada por un equipo pequeño. Los detalles de los lugares proceden de terceros y pueden estar desactualizados; comprueba todo lo importante antes de viajar por ello.

Desconectar

Desconecta Koko desde la configuración de conectores del propio asistente. Eso revoca su token de acceso de inmediato, y Koko deja de aceptar solicitudes hechas en tu nombre. Tus listas y planes permanecen en tu cuenta de Koko. Para eliminarlos también, borra tu cuenta desde la sección de eliminación de cuenta de las FAQ.

Soporte

Una persona lee todos los mensajes. Escribe a [email protected] con lo que le pediste al asistente y lo que respondió. Consulta también las FAQ, la política de privacidad y las condiciones.