Le connecteur Koko

Dernière mise à jour : 13 août 2026

Koko se connecte à Claude et ChatGPT comme une app : un voyage que vous préparez dans une conversation peut être enregistré dans votre compte Koko, ouvert sur une carte, partagé avec les personnes qui vous accompagnent, puis modifié plus tard depuis cette même conversation. Cette page explique la configuration, le rôle de chaque outil, ce que l’assistant peut ou ne peut pas consulter, et les limites.

Configuration

Vous avez besoin d’un compte Koko gratuit. Inscrivez-vous d’abord sur kokotravel.ai, ou créez un compte pendant le parcours de connexion.

Détails du serveur

Endpoint MCP : https://kokotravel.ai/mcp
Transport : HTTP streamable (JSON-RPC sans état)
Authentification : OAuth 2.1 avec PKCE et enregistrement dynamique du client. Il n’y a ni ID client ni clé API à coller.

Dans Claude

Ouvrez Settings → Connectors et ajoutez Koko, depuis le répertoire ou comme connecteur personnalisé avec l’endpoint ci-dessus.
Cliquez sur Connect. La page de connexion de Koko s’ouvre.
Connectez-vous avec Google, avec votre e-mail et un code à six chiffres, ou avec votre nom d’utilisateur et votre mot de passe Koko. Autorisez ensuite l’accès.

Dans ChatGPT

Ajoutez Koko depuis le répertoire d’apps, ou comme connecteur avec l’endpoint ci-dessus.
Cliquez sur Connect et connectez-vous à Koko de la même façon.

Dans Claude Code ou un autre client MCP

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

Exécutez ensuite /mcp et terminez la connexion dans le navigateur.

Ce que le connecteur peut faire

Six outils, tous limités au compte avec lequel vous vous êtes connecté. Les outils de lecture peuvent s’exécuter sans demande à chaque fois ; les outils d’écriture modifient votre contenu enregistré, et update_koko remplace une liste en entier, donc Claude demande votre accord avant de l’exécuter.

send_to_koko Enregistrer une liste ou un plan dans Koko Écriture

Crée une nouvelle liste ou un nouveau plan dans votre compte à partir des lieux décrits dans la conversation. Un simple ensemble de lieux devient une liste ; des lieux avec des horaires regroupés par jour deviennent un plan. Koko géocode chaque lieu, puis ajoute en arrière-plan les notes, les horaires d’ouverture et les photos. Renvoie immédiatement un lien de consultation.

my_koko Mes listes & plans Lecture seule

Liste ce qui se trouve déjà dans votre compte : titre, type, nombre de lieux et id. Rien d’autre dans votre compte n’est exposé.

get_koko Ouvrir une liste ou un plan à modifier Lecture seule

Renvoie une liste ou un plan sous forme de structure modifiable, afin que l’assistant puisse le modifier et renvoyer la nouvelle version.

check_koko_status Vérifier l’avancement Lecture seule

Indique où en est la génération : reçu, localisation, enrichissement, prêt. Utile juste après un enregistrement, car les épingles apparaissent d’abord et les photos suivent.

update_koko Mettre à jour une liste ou un plan Remplacement complet

Remplace le contenu d’une liste ou d’un plan existant par une nouvelle version. Tout ce qui est absent du remplacement est supprimé ; c’est pourquoi cette action est considérée comme destructive et vous demande d’abord confirmation. L’id et le lien de partage restent les mêmes, donc les personnes avec qui vous l’avez déjà partagé voient la mise à jour.

refresh_details Actualiser notes & photos Écriture

Récupère à nouveau les notes, avis, horaires et photos pour une liste existante. Cette opération coûte de l’argent à Koko pour chaque lieu ; elle fournit donc d’abord une estimation et ne dépense que lorsque vous confirmez.

Outils partenaires (créateurs certifiés)

Huit outils supplémentaires s’activent pour les créateurs certifiés, les membres du programme partenaire qui publient dans Découvrir. Sur tout autre compte, ils répondent « vous n’êtes pas un créateur certifié » et ne changent rien. Chacun est limité à votre propre boutique.

creator_profile Mon profil créateur Lecture seule

Lit votre profil de boutique : nom, étiquettes, slogan, bio, lieu, liens, réseaux, prix par défaut et si vous êtes visible ou non.

update_creator_profile Mettre à jour mon profil créateur Écriture

Modifie ces mêmes champs. N’envoyez que ce qui doit changer ; les étiquettes sont remplacées en bloc. L’identifiant ne peut jamais changer, puisque c’est votre URL publique.

my_listings Mes publications Lecture seule

Toutes les listes et tous les plans qui vous appartiennent, avec leur présence ou non dans Découvrir, leur palier de prix, le lien de partage, les vues sur 30 jours ainsi que les achats et revenus depuis le début.

set_listing Publier dans Découvrir / retirer de Découvrir Écriture

Place une de vos listes ou un de vos plans sur l’étagère publique Découvrir, à un prix de la grille standard (Gratuit, 1 $, 2 $, 5 $, 10 $), ou l’en retire. Le retrait efface toujours le prix.

creator_stats Statistiques créateur Lecture seule

Vues, visiteurs uniques, achats et revenus sur 7, 30 ou 90 jours, pour toute la boutique ou pour une seule publication, en totaux et en série quotidienne.

create_coupons Générer des coupons Écriture

Crée des codes pour une publication payante : un code ou cinquante, à usage unique ou un seul code utilisable plusieurs fois. Un coupon indique le palier inférieur que l’acheteur paie (gratuit par défaut), jamais un pourcentage.

coupons Coupons d’une publication Lecture seule

Tous les codes d’une de vos publications, actifs comme désactivés, avec le nombre d’utilisations et par qui.

disable_coupon Désactiver un coupon Écriture

Empêche un code d’être utilisé. Son historique reste.

Exemples de prompts

« Fais-moi une liste de trois restaurants de ramen célèbres à Shibuya, Tokyo : Ichiran Shibuya, Nagi Golden Gai et Hakata Ippudo Shibuya. Enregistre-la dans Koko sous le nom “Shibuya Ramen”. »

Utilise send_to_koko. Vous recevez un lien d’affichage.

« Prévois une journée à Asakusa, Tokyo : Senso-ji à 09:00, déjeuner chez Daikokuya Tempura à 12:00, Tokyo Skytree à 14:00. Enregistre-la dans Koko sous le nom “Asakusa Day”. »

Utilise send_to_koko et enregistre un itinéraire plutôt qu’une liste, car les étapes ont des horaires.

« Qu’est-ce que j’ai enregistré dans Koko ? »

Utilise my_koko.

« Ma liste Shibuya Ramen est-elle prête ? »

Utilise check_koko_status.

« Dans ma liste Shibuya Ramen, retire Hakata Ippudo et ajoute Afuri Ebisu à la place. »

Utilise get_koko puis update_koko. Même lien, contenu mis à jour.

Ce que l’assistant peut ou non consulter

Peut : créer, lire et mettre à jour les listes et itinéraires du compte Koko avec lequel vous vous êtes connecté.
Ne peut pas : voir le contenu d’un autre utilisateur, supprimer votre compte, modifier vos informations de connexion ni rendre quoi que ce soit public. La publication sur l’étagère publique Discover de Koko est réservée aux comptes opérateurs de Koko ; sur un compte normal, cette demande est enregistrée en privé à la place, et la réponse vous l’indique.
Confidentialité de ce qui est enregistré : les listes et itinéraires créés via le connecteur sont privés. Le lien d’affichage ne s’ouvre que pour vous, connecté à l’app web Koko. Le partage est une étape séparée et volontaire que vous effectuez dans l’app.
Ce que Koko reçoit : uniquement les requêtes que l’assistant effectue en votre nom, par exemple une liste de noms de lieux à enregistrer. Votre conversation reste chez le fournisseur de l’assistant. Tous les détails sont dans la politique de confidentialité.

Limites

Les appels d’outils sont limités à environ 30 par minute et par utilisateur. Au-delà, vous recevez un 429 avec un en-tête Retry-After.
Les enregistrements sont générés en arrière-plan et mis en file d’attente en cas de forte charge. Pour un grand itinéraire, comptez environ une minute avant que les photos et les notes finissent d’apparaître.
Le connecteur est gratuit, et rien de ce qu’il fait ne peut dépenser d’argent. L’essentiel de Koko est gratuit aussi ; certains créateurs vendent leurs listes dans l’étagère Découvrir de l’app sous forme d’achats App Store, mais vos données de paiement ne passent jamais par Koko, dans un cas comme dans l’autre. Les limites standard du compte figurent dans les Conditions.
Koko est une préversion en accès anticipé, créée par une petite équipe. Les détails des lieux proviennent de tiers et peuvent être obsolètes ; vérifiez tout ce qui compte avant de vous déplacer.

Déconnexion

Déconnectez Koko depuis les paramètres de connecteur de votre assistant. Cela révoque immédiatement son jeton d’accès, et Koko cesse d’accepter les requêtes faites en votre nom. Vos listes et itinéraires restent dans votre compte Koko. Pour les supprimer aussi, supprimez votre compte depuis la section de suppression de compte de la FAQ.

Assistance

Un humain lit chaque message. Envoyez un email à [email protected] avec ce que vous avez demandé à l’assistant et ce qu’il a répondu. Consultez aussi la FAQ, la politique de confidentialité et les conditions.