El conector de Koko

Última actualización: 13 de agosto de 2026

Koko se conecta a Claude y ChatGPT como una app, para que un viaje que planeas en una conversación pueda guardarse en tu cuenta de Koko, abrirse en un mapa, compartirse con las personas que viajan contigo y editarse más tarde desde la misma conversación. Esta página cubre 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 de MCP: https://kokotravel.ai/mcp
Transporte: HTTP con streaming (JSON-RPC sin estado)
Autenticación: OAuth 2.1 con PKCE y registro dinámico de clientes. No hay client ID ni API key que tengas que pegar.

En Claude

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

En ChatGPT

Agrega Koko desde el directorio de apps, o como conector usando el endpoint de arriba.
Haz clic en Connect e inicia sesión en Koko de la misma manera.

En Claude Code u otro cliente MCP

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

Luego 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 iniciaste sesión. Las herramientas de lectura pueden ejecutarse sin pedir confirmación cada vez; las de escritura cambian tu contenido guardado, y update_koko reemplaza una lista completa, así que Claude te 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; lugares con horarios agrupados por día se convierten en un plan. Koko geocodifica cada lugar y luego completa calificaciones, horarios de atención y fotos en segundo plano. Devuelve un enlace de vista de inmediato.

my_koko Mis listas & planes Solo lectura

Muestra lo que ya tienes en tu cuenta: título, tipo, cantidad 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 Revisar progreso Solo lectura

Informa qué tan avanzado va el proceso: recibido, ubicando, enriqueciendo, listo. Es útil justo después de guardar, porque los pines aparecen primero y las fotos después.

update_koko Actualizar una lista o plan Reemplazo total

Reemplaza el contenido de una lista o plan existente con una nueva versión. Todo lo que quede fuera del reemplazo se elimina; por eso se considera destructivo y te pide confirmación primero. El id y el enlace para compartir se mantienen, así que cualquier persona con quien ya lo compartiste ve la actualización.

refresh_details Actualizar calificaciones & fotos Escritura

Vuelve a obtener calificaciones, reseñas, horarios y fotos de una lista existente. Esto le cuesta dinero a Koko por cada lugar, así que primero calcula el costo y solo lo gasta cuando confirmas.

Herramientas de socios (creadores certificados)

Para los creadores certificados, los miembros del programa de socios que publican en Discover, se activan 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 sociales, precio predeterminado y si apareces públicamente.

update_creator_profile Actualizar mi perfil de creador Escritura

Cambia esos mismos campos. Manda solo lo que deba cambiar; las etiquetas se reemplazan como conjunto. El identificador nunca se puede cambiar, porque es tu URL pública.

my_listings Mis publicaciones Solo lectura

Todas las listas y planes que tienes, con si están en Discover, su nivel de precio, el enlace para compartir, las vistas de 30 días y las compras e ingresos históricos.

set_listing Publicar en Discover / quitar de Discover Escritura

Pone una de tus listas o planes en la vitrina pública de Discover con un precio de la escala estándar (gratis, $1, $2, $5, $10), o la quita. Quitarla siempre borra el precio.

creator_stats Estadísticas de creador Solo lectura

Vistas, visitantes únicos, compras e ingresos de 7, 30 o 90 días, de toda la tienda o de una publicación, como totales y como 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 usaron y quién los usó.

disable_coupon Desactivar un cupón Escritura

Impide que un código se canjee. 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, almuerzo 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 vez de una lista, porque las paradas tienen horarios.

“¿Qué tengo guardado en Koko?”

Usa my_koko.

“¿Mi lista Shibuya Ramen ya está lista?”

Usa check_koko_status.

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

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

A qué puede acceder el asistente y a qué no

Puede: crear, leer y actualizar las listas y planes de la cuenta de Koko con la que iniciaste sesión.
No puede: ver contenido de otros usuarios, eliminar tu cuenta, cambiar tus datos de inicio de sesión ni hacer nada público. Publicar en Discover, la vitrina pública de Koko, está restringido a las cuentas de operador propias 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 mediante el conector son privados. El enlace de vista solo se muestra para ti, con la sesión iniciada en la app web de Koko. Compartir es un paso separado 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 se queda con el proveedor del asistente. Detalles completos en la política de privacidad.

Límites

Las llamadas a herramientas tienen un límite de aproximadamente 30 por minuto por usuario. Si lo superas, recibes un 429 con un encabezado Retry-After.
Los guardados se crean en segundo plano y entran en cola cuando hay mucha carga. Un plan grande tarda alrededor de un minuto en terminar de cargar fotos y calificaciones.
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 la vitrina de Discover de la app como compras del App Store, pero los datos de pago nunca pasan por Koko en ningún caso. Los límites estándar de las cuentas están en los Términos.
Koko es una vista previa de acceso anticipado creada por un equipo pequeño. Los detalles de los lugares vienen de terceros y pueden estar desactualizados; verifica cualquier dato importante antes de viajar.

Desconectar

Desconecta Koko desde la configuración de conectores de tu 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 Preguntas frecuentes.

Soporte

Una persona lee cada mensaje. Envía un correo a [email protected] con lo que le pediste al asistente y lo que respondió. Consulta también las Preguntas frecuentes, la política de privacidad y los términos.