Der Koko-Connector

Zuletzt aktualisiert: 13. August 2026

Koko verbindet sich mit Claude und ChatGPT als App, damit eine Reise, die du im Gespräch planst, in deinem Koko-Konto gespeichert, auf einer Karte geöffnet, mit allen geteilt und später aus demselben Gespräch heraus bearbeitet werden kann. Diese Seite behandelt die Einrichtung, was jedes Tool tut, was der Assistent erreichen kann und was nicht, und die Limits.

Die Einrichtung

Du brauchst ein kostenloses Koko-Konto. Registriere dich zuerst auf kokotravel.ai, oder erstelle eines während des Verbindungsvorgangs.

Serverdetails

MCP-Endpunkt: https://kokotravel.ai/mcp
Transport: streamable HTTP (zustandsloses JSON-RPC)
Authentifizierung: OAuth 2.1 mit PKCE und dynamischer Client-Registrierung. Es gibt keine Client-ID und keinen API-Key zum Einfügen.

In Claude

Öffne Einstellungen → Connectors und füge Koko hinzu, entweder aus dem Verzeichnis oder als eigenen Connector mit dem Endpunkt von oben.
Klick auf Verbinden. Die Anmeldeseite von Koko öffnet sich.
Melde dich mit Google an, oder mit deiner E-Mail-Adresse und einem sechsstelligen Code, oder mit deinem Koko-Benutzernamen und Passwort. Dann erteile Zugriff.

In ChatGPT

Füge Koko aus dem App-Verzeichnis hinzu, oder als Connector mit dem Endpunkt von oben.
Klick auf Verbinden und melde dich genauso bei Koko an.

In Claude Code oder einem anderen MCP-Client

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

Führe dann /mcp aus und schließe die Anmeldung im Browser ab.

Was der Connector kann

Sechs Tools, alle auf das Konto begrenzt, mit dem du dich angemeldet hast. Lese-Tools dürfen laufen, ohne jedes Mal zu fragen; die Schreib-Tools ändern deine gespeicherten Inhalte, und update_koko ersetzt eine Liste komplett, deshalb fragt Claude vorher nach.

send_to_koko Liste oder Plan in Koko speichern Schreiben

Erstellt aus den im Gespräch beschriebenen Orten eine neue Liste oder einen neuen Plan in deinem Konto. Eine flache Menge von Orten wird eine Liste; Orte mit Zeiten, gruppiert in Tage, werden ein Plan. Koko geocodiert jeden Ort und ergänzt dann im Hintergrund Bewertungen, Öffnungszeiten und Fotos. Gibt sofort einen Ansichtslink zurück.

my_koko Meine Listen & Pläne Nur lesen

Listet auf, was schon in deinem Konto liegt: Titel, Art, Anzahl der Orte und ID. Sonst wird nichts aus deinem Konto offengelegt.

get_koko Liste oder Plan zum Bearbeiten öffnen Nur lesen

Gibt eine Liste oder einen Plan als bearbeitbare Struktur zurück, damit der Assistent sie ändern und die neue Version zurückschicken kann.

check_koko_status Fortschritt prüfen Nur lesen

Meldet, wie weit die Erstellung ist: empfangen, wird lokalisiert, wird angereichert, fertig. Praktisch direkt nach dem Speichern, weil zuerst die Pins erscheinen und die Fotos folgen.

update_koko Liste oder Plan aktualisieren Komplett ersetzen

Ersetzt den Inhalt einer bestehenden Liste oder eines bestehenden Plans durch eine neue Version. Alles, was in der Ersetzung fehlt, wird entfernt; deshalb gilt es als destruktiv und fragt dich vorher. Die ID und der Freigabelink bleiben gleich, alle, mit denen du schon geteilt hast, sehen also die Aktualisierung.

refresh_details Bewertungen & Fotos aktualisieren Schreiben

Holt Bewertungen, Rezensionen, Öffnungszeiten und Fotos für eine bestehende Liste neu. Das kostet Koko Geld pro Ort, deshalb schätzt es zuerst und gibt nur aus, wenn du bestätigst.

Partner-Tools (zertifizierte Creators)

Acht weitere Tools schalten sich für zertifizierte Creators frei, die Mitglieder des Partnerprogramms, die in Entdecken veröffentlichen. Auf jedem anderen Konto antworten sie “kein zertifizierter Creator” und ändern nichts. Jedes ist auf deinen eigenen Shop begrenzt.

creator_profile Mein Creator-Profil Nur lesen

Liest dein Shop-Profil: Name, Labels, Slogan, Über dich, Ort, Links, Socials, Standardpreis und ob du auffindbar bist.

update_creator_profile Mein Creator-Profil aktualisieren Schreiben

Ändert dieselben Felder. Schick nur, was sich ändern soll; die Labels werden als Ganzes ersetzt. Der Handle kann sich nie ändern, weil er deine öffentliche URL ist.

my_listings Meine Angebote Nur lesen

Jede Liste und jeder Plan, die dir gehören, mit dem Status in Entdecken, der Preisstufe, dem Freigabelink, den Aufrufen der letzten 30 Tage sowie Käufen und Umsatz insgesamt.

set_listing In Entdecken listen / aus Entdecken nehmen Schreiben

Stellt eine deiner Listen oder einen deiner Pläne zu einem Preis aus der Standardstaffel (Gratis, $1, $2, $5, $10) ins öffentliche Entdecken-Regal, oder nimmt sie wieder heraus. Beim Herausnehmen wird der Preis immer gelöscht.

creator_stats Creator-Statistiken Nur lesen

Aufrufe, eindeutige Betrachter, Käufe und Umsatz über 7, 30 oder 90 Tage, für den ganzen Shop oder ein einzelnes Angebot, als Summen plus Tagesverlauf.

create_coupons Gutscheincodes erstellen Schreiben

Erzeugt Codes für ein bezahltes Angebot: einen Code oder fünfzig, einmalig nutzbar oder einen Code mit vielen Einlösungen. Ein Gutschein nennt die niedrigere Preisstufe, die der Käufer zahlt (standardmäßig gratis), nie einen Prozentsatz.

coupons Gutscheine eines Angebots Nur lesen

Jeder Code eines deiner Angebote, aktiv und deaktiviert, mit der Anzahl der Einlösungen und von wem.

disable_coupon Gutschein deaktivieren Schreiben

Stoppt die Einlösung eines Codes. Seine Historie bleibt.

Beispiel-Prompts

“Mach mir eine Liste mit drei berühmten Ramen-Läden in Shibuya, Tokio: Ichiran Shibuya, Nagi Golden Gai und Hakata Ippudo Shibuya. Speichere sie in Koko als ‘Shibuya Ramen’.”

Nutzt send_to_koko. Du bekommst einen Ansichtslink zurück.

“Plane einen Tag in Asakusa, Tokio: Senso-ji um 09:00, Mittagessen bei Daikokuya Tempura um 12:00, Tokyo Skytree um 14:00. Speichere ihn in Koko als ‘Asakusa Day’.”

Nutzt send_to_koko und speichert einen Plan statt einer Liste, weil die Stopps Zeiten haben.

“Was habe ich in Koko gespeichert?”

Nutzt my_koko.

“Ist meine Shibuya-Ramen-Liste schon fertig?”

Nutzt check_koko_status.

“Nimm Hakata Ippudo aus meiner Shibuya-Ramen-Liste und füge stattdessen Afuri Ebisu hinzu.”

Nutzt get_koko und dann update_koko. Gleicher Link, aktualisierter Inhalt.

Was der Assistent erreichen kann und was nicht

Kann: die Listen und Pläne in dem Koko-Konto erstellen, lesen und aktualisieren, mit dem du dich angemeldet hast.
Kann nicht: Inhalte anderer Nutzer sehen, dein Konto löschen, deine Anmeldedaten ändern oder irgendetwas öffentlich machen. Das Veröffentlichen im öffentlichen Entdecken-Regal von Koko ist Kokos eigenen Betreiberkonten vorbehalten; auf einem normalen Konto wird die Anfrage stattdessen privat gespeichert, und die Antwort sagt dir das.
Datenschutz für Gespeichertes: Listen und Pläne, die über den Connector entstehen, sind privat. Der Ansichtslink wird nur für dich gerendert, angemeldet in der Koko-Web-App. Teilen ist ein separater, bewusster Schritt, den du in der App machst.
Was Koko bekommt: nur die Anfragen, die der Assistent in deinem Namen stellt, zum Beispiel eine Liste von Ortsnamen zum Speichern. Dein Gespräch bleibt beim Anbieter des Assistenten. Alle Details in der Datenschutzerklärung.

Limits

Tool-Aufrufe sind auf etwa 30 pro Minute und Nutzer begrenzt. Darüber bekommst du einen 429 mit einem Retry-After-Header.
Speicherungen werden im Hintergrund erstellt und reihen sich bei Last ein. Bei einem großen Plan dauert es etwa eine Minute, bis Fotos und Bewertungen vollständig da sind.
Der Connector ist kostenlos, und nichts, was er tut, kann Geld ausgeben. Kokos Kern ist ebenfalls kostenlos; manche Creators verkaufen ihre Listen im Entdecken-Regal der App als App-Store-Käufe, aber Zahlungsdaten kommen so oder so nie bei Koko an. Die Limits für Standardkonten stehen in den Nutzungsbedingungen.
Koko ist eine Early-Access-Preview, entwickelt von einem kleinen Team. Ortsdetails kommen von Dritten und können veraltet sein; prüfe alles, was dir wichtig ist, bevor du dafür losfährst.

Verbindung trennen

Trenne Koko in den Connector-Einstellungen deines Assistenten. Das widerruft sein Zugriffstoken sofort, und Koko nimmt keine Anfragen mehr in deinem Namen an. Deine Listen und Pläne bleiben in deinem Koko-Konto. Um auch die zu entfernen, lösche dein Konto im Abschnitt zur Kontolöschung der FAQ.

Support

Ein Mensch liest jede Nachricht. Schreib an [email protected], was du den Assistenten gefragt hast und was zurückkam. Siehe auch die FAQ, die Datenschutzerklärung und die Nutzungsbedingungen.