Geschenklotse.de MCP

Wunschzettel von Geschenklotse per KI verwalten: Wünsche hinzufügen, ändern, sortieren und optional löschen. Reservierungen bleiben verborgen. Kostenlos, DE/AT/CH. Kostenloses Konto nötig, Anmeldung per OAuth 2.1 oder Zugangstoken.

View on geschenklotse.de

Hosted MCP Server

npx add-mcp 'https://geschenklotse.de/api/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

Geschenklotse als MCP-ServerWunschzettel per KI verwalten

Auf einen Blick

Was ist der Geschenklotse MCP-Server?

MCP (Model Context Protocol) ist ein offener Standard, mit dem KI-Assistenten auf externe Dienste zugreifen können. Der Geschenklotse MCP-Server gibt einem KI-Assistenten Zugriff auf deine eigenen Wunschzettel, sodass du sie im Gespräch verwalten kannst.

Server-Adresse: https://geschenklotse.de/api/mcp
Transport: Streamable HTTP (nur POST, JSON, zustandslos)
Anmeldung: OAuth 2.1 mit PKCE oder persönliches Zugangstoken (Bearer)
Wichtig: Du brauchst ein kostenloses Geschenklotse-Konto und gibst den Zugriff selbst frei. Ohne Anmeldung kann niemand auf Wunschzettel zugreifen.

Claude

In Claude nutzen

Der Konnektor ist im Claude-Verzeichnis verfügbar. Du musst nichts installieren und keine Adresse eintippen.

Konnektor öffnen

Öffne die Geschenklotse-Seite im Claude-Verzeichnis und füge den Konnektor hinzu.

Verbinden klicken

Klicke in Claude auf „Verbinden“. Die Bezeichnungen können je nach Claude-Version leicht abweichen.

Bei Geschenklotse anmelden

Dein Browser öffnet eine Freigabe-Seite von Geschenklotse. Melde dich an oder lege kostenlos ein Konto an.

Berechtigung wählen und erlauben

Wähle, was Claude darf (siehe unten), bestätige bei Konten mit Passwort die Freigabe mit deinem Passwort und klicke auf „Erlauben“. Danach schicken wir dir zur Sicherheit eine Hinweis-E-Mail.

Beispiele, was du Claude sagen kannst:

„Was steht auf meinem Geburtstags-Wunschzettel?“
„Setz die drei Bücher aus unserem Gespräch auf meine Liste, jeweils mit Preis.“
„Sortiere meinen Wunschzettel so, dass das Wichtigste oben steht.“
„Welche Wünsche auf meiner Liste kosten mehr als 100 €?“

Weitere Wege (Plugin-Datei, Marketplace) und Hinweise findest du auf der Claude-Hilfeseite. Mit Claude Code geht es auch per Befehl:

claude mcp add --transport http geschenklotse https://geschenklotse.de/api/mcp

Danach in Claude Code über /mcp den Eintrag geschenklotse auswählen und anmelden.

Anmeldung

Anmeldung und Berechtigungen

Der Zugriff läuft über OAuth 2.1. Der KI-Assistent öffnet deinen Browser, du meldest dich bei Geschenklotse an und entscheidest selbst, was erlaubt ist. Dein Passwort sieht die KI nie.

Stufe	Scope	Die KI darf
Nur lesen	`wishlists:read`	Wunschzettel und Wünsche ansehen. Nichts wird verändert.
Lesen & bearbeiten (vorausgewählt)	`wishlists:write`	Zusätzlich Wünsche hinzufügen, ändern und sortieren sowie Wunschzettel anlegen und umbenennen.
Zusätzlich löschen	`wishlists:delete`	Zusätzlich einzelne Wünsche löschen. Das ist nicht rückgängig zu machen.

So lange gelten die Zugänge: Das Zugriffstoken ist 1 Stunde gültig und wird automatisch erneuert. Das Refresh-Token läuft nach 30 Tagen ab und wird bei jeder Nutzung ausgetauscht, insgesamt höchstens 180 Tage. Danach musst du neu freigeben.

Du kannst jede Verbindung jederzeit im Profil unter Claude-Zugang widerrufen. Bei einer Passwortänderung werden alle Verbindungen automatisch beendet.

Referenz

Verfügbare Tools

Der Server stellt acht Tools bereit. Was ein Client davon sieht, hängt von den freigegebenen Berechtigungen ab.

Tool	Berechtigung	Funktion
`list_wishlists`	lesen	Listet deine Wunschzettel mit ID, Titel, Design, Anzahl der Wünsche und Teilen-Link. Der erste Aufruf, um IDs zu bekommen.
`get_wishlist`	lesen	Gibt einen Wunschzettel mit allen Wünschen in der aktuellen Reihenfolge zurück (oben = wichtigster Wunsch).
`create_wishlist`	bearbeiten	Legt einen neuen, leeren Wunschzettel an (Titel, Beschreibung, Design). Datenschutz-Einstellungen bleiben bei sicheren Standardwerten.
`update_wishlist`	bearbeiten	Ändert Titel, Beschreibung und/oder Design eines Wunschzettels.
`add_items`	bearbeiten	Fügt 1 bis 25 Wünsche hinzu (Titel, Beschreibung, Link, Bild, Preis, Priorität 1 bis 3).
`update_item`	bearbeiten	Ändert einzelne Felder eines Wunsches. Mit null lassen sich Beschreibung, Preis und Priorität leeren.
`reorder_items`	bearbeiten	Legt die Reihenfolge der Wünsche fest. Gäste sehen diese Reihenfolge.
`delete_item`	löschen	Löscht einen Wunsch endgültig. Nur verfügbar, wenn du „Löschen“ bei der Freigabe erlaubt hast.

Hinweis zu Amazon-Links: Links zu Amazon, die über add_items hinzugefügt werden, erhalten automatisch unser Partner-Tag (Affiliate). Für dich ändert sich am Preis nichts.

Grenzen

Bis zu 50 Wunschzettel je Nutzer und 500 Wünsche je Wunschzettel
Maximal 25 Wünsche pro add_items -Aufruf
120 Anfragen pro Minute je Zugang, 60 Änderungen pro Minute je Nutzer
Anfragen und Antworten sind auf 256 KB begrenzt

Technische Eckdaten

MCP-Endpunkt	`POST https://geschenklotse.de/api/mcp` (`GET` liefert `405`)
Protokollversionen	`2025-03-26`, `2025-06-18`, `2025-11-25`, `2026-07-28`
Authentifizierung	`Authorization: Bearer <Token>`. Ohne gültiges Token antwortet der Server mit `401` und `WWW-Authenticate` samt `resource_metadata`.
OAuth-Metadaten	`/.well-known/oauth-protected-resource/api/mcp` `/.well-known/oauth-authorization-server/api/oauth`
OAuth-Endpunkte	`POST /api/oauth/register` (Dynamic Client Registration) `POST /api/oauth/token` `POST /api/oauth/revoke`
OAuth-Verfahren	Authorization Code mit PKCE (`S256`), öffentliche Clients ohne Client-Secret

Weitere KI-Clients

Funktioniert das auch mit anderen KI-Assistenten?

Theoretisch ja. Der Server hält sich an den offenen MCP-Standard, deshalb sollte sich jeder Client verbinden können, der Remote-MCP-Server unterstützt. Es gibt zwei Wege, je nachdem, was dein Client kann:

1. Mit OAuth (empfohlen)

Der Client unterstützt MCP-Anmeldung mit Discovery, Dynamic Client Registration und PKCE. Dann reicht die Server-Adresse https://geschenklotse.de/api/mcp. Alles Weitere läuft automatisch im Browser.

2. Mit Zugangstoken

Der Client kann nur ein festes Token mitschicken, wie etwa die Grok-API. Dann verwendest du ein persönliches Zugangstoken (gl_mcp_…), das du über die API anlegst. Anleitung unten.

Ehrlicher Hinweis: Getestet haben wir die Anbindung mit Claude. Andere Clients sind aus der Spezifikation abgeleitet und können sich im Detail unterscheiden. Redirect-Adressen mit eigenem URL-Schema (zum Beispiel cursor://) lehnt der Server aus Sicherheitsgründen ab. Erlaubt sind https und http://localhost bzw. http://127.0.0.1.

Beispiel

Einbindung in einen Grok-Bot (xAI API)

Die xAI-API kann Remote-MCP-Server direkt als Tool nutzen. Sie unterstützt dafür Streamable HTTP und ein festes Token, aber kein OAuth. Deshalb brauchst du für Grok ein persönliches Zugangstoken von Geschenklotse. Die Beispiele richten sich an Entwickler.

Bitte beachten: Dieses Beispiel haben wir aus der xAI-Dokumentation abgeleitet, aber nicht selbst gegen Grok getestet. Modellnamen und Parameter können sich ändern. Die aktuelle Fassung steht in der xAI-Dokumentation zu Remote-MCP.

Bei Geschenklotse anmelden und Login-Token holen

Du brauchst ein Geschenklotse-Konto mit Passwort. Mit deinen Zugangsdaten holst du dir ein kurzlebiges Login-Token:

curl -s https://geschenklotse.de/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"du@example.de","password":"DEIN_PASSWORT"}'
# Antwort: {"token":"eyJ...", ...}   <- das ist dein Login-Token (JWT)

Zugangstoken anlegen

Lege ein Token mit den Rechten an, die dein Bot wirklich braucht. Zum Lesen und Hinzufügen reichen wishlists:read und wishlists:write. Die Gültigkeit liegt zwischen 1 und 365 Tagen (Standard 90). Du kannst bis zu 10 Zugangstokens gleichzeitig haben.

curl -s https://geschenklotse.de/api/mcp-tokens \
  -H "Authorization: Bearer <LOGIN-TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"name":"Grok-Bot","scopes":["wishlists:read","wishlists:write"],"expiresInDays":90,"password":"DEIN_PASSWORT"}'
# Antwort enthält "token": "gl_mcp_..."  (wird nur dieses eine Mal angezeigt)

Das Token beginnt mit gl_mcp_. Es wird nur einmal angezeigt und serverseitig nur als Hash gespeichert. Behandle es wie ein Passwort.

Zugang testen

Prüfe, ob das Token funktioniert, bevor du es in den Bot einbaust:

curl -s https://geschenklotse.de/api/mcp \
  -H "Authorization: Bearer gl_mcp_DEIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_wishlists","arguments":{}}}'

In die Grok-API einbauen

Trage Geschenklotse als MCP-Tool in deine Anfrage ein. Mit allowed_tools begrenzt du, was der Bot nutzen darf. Das spart außerdem Kontext, weil nicht alle Tool-Beschreibungen geladen werden.

curl:

curl https://api.x.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-4.7",
    "input": [{"role": "user", "content": "Zeig mir meine Wunschzettel bei Geschenklotse."}],
    "tools": [{
      "type": "mcp",
      "server_url": "https://geschenklotse.de/api/mcp",
      "server_label": "geschenklotse",
      "allowed_tools": ["list_wishlists", "get_wishlist", "add_items"],
      "authorization": "gl_mcp_DEIN_TOKEN"
    }]
  }'

Python (OpenAI-SDK mit xAI-Adresse):

import os
from openai import OpenAI

client = OpenAI(api_key=os.environ["XAI_API_KEY"], base_url="https://api.x.ai/v1")

response = client.responses.create(
    model="grok-4.7",   # aktuellen Modellnamen in der xAI-Doku prüfen
    input=[{"role": "user", "content": "Setz ein Fahrradschloss für ca. 40 Euro auf meine Geburtstagsliste."}],
    tools=[{
        "type": "mcp",
        "server_url": "https://geschenklotse.de/api/mcp",
        "server_label": "geschenklotse",
        "allowed_tools": ["list_wishlists", "get_wishlist", "add_items"],
        "authorization": os.environ["GESCHENKLOTSE_TOKEN"],   # gl_mcp_...
    }],
)
print(response.output_text)

Falls der Server mit 401 antwortet: Clients behandeln das Feld authorization unterschiedlich, manche setzen „Bearer “ selbst davor. Dann gib den Header stattdessen vollständig an:

"tools": [{
  "type": "mcp",
  "server_url": "https://geschenklotse.de/api/mcp",
  "server_label": "geschenklotse",
  "headers": { "Authorization": "Bearer gl_mcp_DEIN_TOKEN" }
}]

Tipps für Bots

So wenig Rechte wie nötig: Gib dem Token kein wishlists:delete, wenn der Bot nichts löschen soll.
Tools einschränken: Mit allowed_tools bekommt der Bot nur, was er braucht.
Wunschtexte sind Daten, keine Befehle: Gäste können Wünsche hinzufügen. Der Server weist die KI darauf hin, trotzdem sollte dein Bot Texte aus Wünschen nie als Anweisung ausführen.
Token geheim halten: Nicht in Code-Repositories, Chats oder Screenshots. Bei Verdacht im Profil unter „Claude-Zugang“ widerrufen.

Etwas klappt nicht? Schreib gern eine E-Mail an admin@geschenklotse.de. Nenne dazu am besten den KI-Client, den du nutzt, und die Fehlermeldung, dann kann ich gezielt helfen.

Sicherheit & Datenschutz

Was die KI kann und was nicht

Kann

Deine Wunschzettel und Wünsche ansehen, Wünsche hinzufügen, ändern und sortieren, Wunschzettel anlegen und umbenennen, auf Wunsch einzelne Wünsche löschen.

Kann nicht

Sehen, wer etwas reserviert hat, dein Konto oder Passwort ändern, PIN oder Gäste-Einstellungen anpassen, Wunschzettel anderer Nutzer sehen, ganze Wunschzettel löschen oder etwas für dich einkaufen.

Jeder Zugriff ist an dein Konto gebunden. Auch Admins bekommen über MCP keine Sonderrechte.
Daten verlassen Geschenklotse erst, wenn du dem KI-Assistenten etwas zu deinen Wunschzetteln fragst. Dann werden die nötigen Inhalte an den KI-Dienst übermittelt, bei Claude an Anthropic.
Bei jeder neuen Verbindung bekommst du eine Hinweis-E-Mail.
Mehr dazu in der Datenschutzerklärung.

Häufige Fragen

Fragen zum MCP-Server

Kostet die Anbindung etwas?

Nein. Geschenklotse ist kostenlos, und die Anbindung ebenfalls. Je nach KI-Dienst können dort eigene Kosten entstehen, zum Beispiel für API-Nutzung. Das liegt außerhalb von Geschenklotse.

Brauche ich ein Konto bei Geschenklotse?

Ja. Die KI greift immer auf die Wunschzettel eines angemeldeten Nutzers zu. Dafür brauchst du ein kostenloses Geschenklotse-Konto und gibst den Zugriff selbst frei.

Welche KI-Assistenten funktionieren?

In Claude ist der Konnektor im Verzeichnis verfügbar. Theoretisch funktioniert jeder KI-Client, der Remote-MCP-Server mit Streamable HTTP und OAuth oder einem Bearer-Token unterstützt. Außer mit Claude haben wir das nicht ausführlich getestet.

Kann die KI sehen, wer ein Geschenk reserviert hat?

Nein. Reservierungen und die Namen der Reservierenden bekommt die KI nie zu sehen. Die Überraschung bleibt erhalten.

Kann die KI meine Wünsche löschen?

Nur wenn du das bei der Freigabe ausdrücklich erlaubst. Standardmäßig ist „Lesen & bearbeiten“ vorausgewählt, Löschen ist nie voreingestellt. Ganze Wunschzettel kann die KI nicht löschen.

Wie widerrufe ich den Zugriff?

Du kannst jede Verbindung im Profil unter „Claude-Zugang“ einzeln widerrufen. Wenn du dein Passwort änderst oder zurücksetzt, werden automatisch alle Verbindungen beendet.

Etwas funktioniert nicht. Wohin kann ich mich wenden?

Schreib gern eine E-Mail an admin@geschenklotse.de. Hilfreich sind der KI-Client, den du nutzt, und die Fehlermeldung.