Verbinden
MCP · CLI
Dein KI-Agent ruft Yumis Daten zu Lokalen genau dann ab, wenn er sie für eine Antwort braucht. Weil er mit geprüften Angaben antwortet, erfindet er keine Lokale, die es nicht gibt. Dafür braucht er auch nur wenige Aufrufe.
Füg nur eine Zeile in deine KI ein
Füg sie in eine KI wie Claude, Cursor, Codex oder Gemini ein. Die KI richtet die Verbindung ein und sucht dir ein Lokal.
Lies https://heyyumi.ai/llms.txt, verbinde HeyYumi und finde mir ein Matcha-Café in Euljiro, Seoul.
- 1Deine KI liest die Anleitung und gibt dir einen Anmeldelink.
- 2Dort meldest du dich nur mit Google an.
- 3Sobald die Verbindung steht, sucht deine KI gleich das Lokal.
Lieber selbst einrichten? Wähle dein Tool
- 01
Plugins öffnen
Geh in ChatGPT im Web (chatgpt.com) oder in der Desktop-App zu Einstellungen → Plugins. Du kannst auch chatgpt.com/plugins in die Adresszeile eingeben oder in der Seitenleiste auf 'Plugins' klicken. Den Entwicklermodus brauchst du nicht.
- 02
HeyYumi suchen
Gib im Suchfeld für Plugins heyyumi ein. Mit 'Reservierung' oder 'Restaurant' findest du es auch, mit heyyumi geht es am schnellsten. Klicke in der Liste auf HeyYumi, um die Detailseite zu öffnen.
- 03
Verbinden und mit Google anmelden
Klicke auf 'Verbinden' (Connect), melde dich im Anmeldefenster mit Google an und bestätige. Das war's, der Schlüssel wird automatisch erstellt. Lässt sich 'Verbinden' nicht anklicken, kann das an deinem Tarif, deinem Land oder den Einstellungen deines Firmen-Workspace liegen.
- 04
Aufrufen und fragen
Ruf HeyYumi in einem neuen Chat mit '@HeyYumi' auf oder wähle es im Eingabefeld über + → Mehr aus. Frag dann 'Mit HeyYumi …', und Yumi antwortet.
CLI
Für Agenten, die im Terminal arbeiten, etwa Claude Code, Codex oder Gemini CLI, ist die CLI am bequemsten. Per Befehl findest du Lokale, schickst eine Reservierungsanfrage und wartest auf die Antwort des Lokals. Alle Ergebnisse kommen als JSON.
Anmelden, suchen, reservieren
Du musst nichts installieren. npx lädt die neueste Version und führt sie aus. Wenn du login ausführst, öffnet sich im Browser die Google-Anmeldung. Bestätigst du dort, bist du angemeldet.
terminal
# einmalig: mit Google anmelden npx -y heyyumi login # Lokale finden npx -y heyyumi search matcha --business_category cafe --region Euljiro # Reservierung anfragen und auf die Antwort des Lokals warten npx -y heyyumi reserve <placeId> --time "YYYY-MM-DD 19:00" --party 2 --name Schmidt --phone 010-1234-5678 npx -y heyyumi wait <reservationId>
Benötigt Node 18 oder neuer. Die Anmeldedaten liegen unter ~/.config/heyyumi und sind nur für deinen Benutzer lesbar.
- 01
Anmelden
Führ npx -y heyyumi login aus und bestätige im Browser mit Google. Dann bist du angemeldet.
- 02
Suchen
Schreib hinter search ein Gericht und gib mit --region die Gegend an. Die Gegend geht auf Koreanisch (홍대) oder in lateinischer Umschrift (Hongdae).
- 03
Reservierung anfragen
Schick die Anfrage mit reserve ab und warte mit wait. Meist kommt innerhalb von 5 Minuten eine Bestätigung oder Absage.
So nutzt du es nach dem Verbinden
Der Agent findet Lokale mit search_places oder nearby_places und liest dann mit get_place Speisekarte und Öffnungszeiten. Fotos, die der Inhaber hochgeladen hat, zeigt er mit show_place_photos direkt im Chat (nur in KIs, die Bilder anzeigen können). Reservierungen schickt er mit request_reservation ab und wartet mit wait_for_reservation auf Bestätigung oder Absage. Fragen wie 'Wie lange ist die Wartezeit gerade?' stellt er mit request_live_status dem Inhaber, die Antwort kommt innerhalb von 5 Minuten. Jedes Konto bekommt jeden Monat 50.000 Tokens kostenlos.
Große Mengen? Sprich mit uns →Was MCP gegenüber REST bringt
Agenten nutzen es als Tool
Eine KI ruft im Gespräch oft und in kurzen Abständen Daten ab. Als MCP-Tool angebunden brauchst du dafür keinen eigenen Server dazwischen.
Gleiche Daten, gleiche Tokens
Die Tokens kommen aus demselben Kontingent wie bei REST. Die MCP-Nutzung siehst du getrennt unter channel=mcp.
Weniger Aufrufe pro Antwort
Doppelte Einträge zu einem Lokal sind schon zusammengeführt und nach Bedingungen vorgefiltert. So findet der Agent die Antwort mit wenigen Aufrufen.