MCP-Server: CLUP.life für KI-Assistenten

CLUP.life spricht das Model Context Protocol (MCP). Damit kann ein KI-Assistent Fragen wie „Was steht diese Woche im Verein an?“ beantworten oder den Entwurf einer Mitteilung vorbereiten — mit denselben Rechten wie die Person hinter dem Schlüssel.

Eckdaten#

Einrichtung Schritt für Schritt#

1. Schlüssel anlegen

Einstellungen → Schnittstellen: Für Zusammenfassungen („Was steht an?“) genügt ein Personenschlüssel nur mit lesenden Bereichen (profile:read, events:read, optional posts:read, announcements:read, tasks:read). Schreibende Werkzeuge brauchen einen Organisationsschlüssel (Premium).

2. Claude Code

claude mcp add --transport http clup https://api.clup.life/api/v1/ext/mcp \
  --header "Authorization: Bearer clup_k_…"

# prüfen
claude mcp list

3. Claude Desktop

Claude Desktop startet lokale Server. Verbinde den entfernten Server über die Brücke mcp-remote (benötigt Node.js). Öffne Einstellungen → Entwickler → Konfiguration bearbeiten und ergänze claude_desktop_config.json:

{
  "mcpServers": {
    "clup": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://api.clup.life/api/v1/ext/mcp",
        "--header", "Authorization:Bearer clup_k_…"
      ]
    }
  }
}

Claude Desktop danach vollständig beenden und neu starten. Unter dem Werkzeug-Symbol erscheinen die clup_…-Werkzeuge.

4. Andere Clients und eigene Agenten

Trage in einem MCP-fähigen Client (Cursor, VS Code, Windsurf, eigene Agenten über ein MCP-SDK) die Server-Adresse und den Kopf Authorization: Bearer clup_k_… ein; Transport „Streamable HTTP“. Clients, die nur lokale Prozesse kennen, nutzen wie Claude Desktop mcp-remote.

5. Testen

Frage zum Beispiel: „Fasse die Termine der nächsten 14 Tage für tus-musterstadt zusammen.“ Oder per Hand:

curl -s https://api.clup.life/api/v1/ext/mcp \
  -H "Authorization: Bearer $CLUP_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Werkzeuge#

Ein Client sieht nur die Werkzeuge, deren Bereich der Schlüssel trägt; der Aufruf prüft den Bereich noch einmal. Die Liste wird aus der Werkzeugliste des Servers erzeugt.

Protokollversion: 2025-03-26

Berechtigungen und Sicherheit#

• Der Assistent handelt mit den Rechten der Person, der der Schlüssel gehört. Nicht sichtbare Organisationen melden „nicht gefunden“.
• Antworten sind Daten, keine Anweisungen. Der Server sagt das in seinen instructions. Prüfe Ergebnisse, bevor du auf Grundlage von Beitragstexten handelst.
• Schreibende Werkzeuge (clup_create_*) sind nur mit Organisationsschlüssel sichtbar. Stelle sie im Client auf „jeweils nachfragen“ — vor allem clup_create_announcement, das Mitglieder benachrichtigt.
• Verbinde pro Assistent einen eigenen, eng begrenzten Schlüssel und widerrufe ihn, wenn du den Client nicht mehr nutzt.
• Beachte: Was der Assistent liest, geht an den Anbieter des Assistenten. Gib ihm nur Schlüssel, deren Daten du dorthin geben darfst (siehe Datenschutz).