Geschenklotse als MCP-Server
Wunschzettel per KI verwalten

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.

In Claude nutzen

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

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 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.

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.

Verfügbare Tools

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

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

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:

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.

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)

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)

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":{}}}'

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"
    }]
  }'

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)

"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.

Was die KI kann und was nicht

• 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.

Fragen zum MCP-Server