Zum Hauptinhalt springen
Was this helpful?

MCP-Hosts verbinden

Diese Seite zeigt praktische Verbindungsmuster für PrimeCal MCP mit dem Demo-Benutzer May.B.Late.

Alle Beispielausgaben auf dieser Seite setzen voraus, dass du als mayblate verbunden bist.

Verbindungsmodi​

PrimeCal unterstützt beide gängigen MCP-Transportarten:

  • Streamable HTTP zu https://<dein-primecal>/api/mcp
  • STDIO über das PrimeCal MCP-STDIO-Einstiegsskript

Verwende einen Agenten-API-Key pro Host-Instanz.

Hinweis zu PrimeCal Cloud:

  • Frontend-App: https://app.primecal.eu
  • MCP/Backend-Endpunkt: https://api.primecal.eu/api/mcp
  • Richte Remote-MCP-Hosts nicht auf https://app.primecal.eu/api/mcp; dieser Host liefert die SPA-Schale, nicht die Backend-API.
  • Wenn dein Frontend auf Azure Static Web Apps Free gehostet wird, kann /api/* nicht über diesen Frontend-Host weitergeleitet werden. Verwende den Backend-Host direkt, bis die SWA auf Standard aktualisiert wird.

Chrome MCP (HTTP)​

Nutze dies, wenn deine Chrome-MCP-Erweiterung oder -Bridge Remote-HTTP-MCP-Server unterstützt.

Bevor du die Host-Konfiguration in PrimeCal generierst, wähle die kleinste Berechtigungsgruppe, die zum Host passt:

  • Minimal für Smoke-Tests und reine Kontext-Assistenten
  • Nur Lesen (alles) zum sicheren Durchsuchen von Kalendern, Aufgaben, Reservierungen und Automatisierungsstatus
  • Operatives Lesen/Schreiben nur wenn der Host Planungsdaten erstellen oder aktualisieren muss
  1. Öffne deine Chrome-MCP-Host-Einstellungen.
  2. Füge einen Server namens primecal hinzu.
  3. Setze die Endpunkt-URL auf https://<dein-primecal>/api/mcp.
  4. Füge den Header Authorization: Agent ag_sk_<token> hinzu.
  5. Speichere und verbinde erneut.
  6. Führe tools/list aus, dann rufe primecal_calendars_list auf.

Beispiel-JSON-Block, der von vielen Chrome-MCP-Tools verwendet wird:

{
  "name": "primecal",
  "transport": "http",
  "url": "https://primecal.example.com/api/mcp",
  "headers": {
    "Authorization": "Agent ag_sk_your_token_here"
  }
}

Wenn deine Erweiterung einen anderen Feldnamen verwendet (endpoint, serverUrl, authHeaders), übernimm dieselben Werte und ordne sie der entsprechenden Benutzeroberfläche zu.

PrimeCal kann in der generierten Konfiguration außerdem eine nicht sensible permissionGroup-Annotation ausgeben. Behandle diese nur als Metadaten für Betreiber. Der Host sollte sich weiterhin auf die expliziten MCP-Capabilities stützen, die PrimeCal zurückgibt.

Claude Desktop (STDIO)​

Nutze dies, wenn du lokal auf dem Desktop gehostetes MCP mit PrimeCal-Backend-Zugriff möchtest.

Voraussetzungen:

  • PrimeCal-Backend-Abhängigkeiten installiert
  • Backend gebaut (npm --prefix backend-nestjs run build)
  • gültiger PRIMECAL_MCP_AGENT_KEY

Beispiel-Eintrag in claude_desktop_config.json:

{
  "mcpServers": {
    "primecal": {
      "command": "node",
      "args": [
        "/absoluter/pfad/zu/primecal_app1/backend-nestjs/dist/src/mcp-server/bin/primecal-mcp-stdio.js"
      ],
      "env": {
        "PRIMECAL_MCP_AGENT_KEY": "ag_sk_your_token_here",
        "DATABASE_URL": "postgres://...",
        "JWT_SECRET": "..."
      }
    }
  }
}

Entwicklungsalternative (ohne Build):

{
  "mcpServers": {
    "primecal": {
      "command": "npx",
      "args": [
        "ts-node",
        "-r",
        "tsconfig-paths/register",
        "src/mcp-server/bin/primecal-mcp-stdio.ts"
      ],
      "cwd": "/absoluter/pfad/zu/primecal_app1/backend-nestjs",
      "env": {
        "PRIMECAL_MCP_AGENT_KEY": "ag_sk_your_token_here"
      }
    }
  }
}

VS Code oder Cursor​

Die meisten VS Code/Cursor-MCP-Integrationen akzeptieren ebenfalls HTTP-MCP-Serverdefinitionen.

Verwende dieselben Werte wie bei Chrome:

  • URL: https://<dein-primecal>/api/mcp
  • Auth-Header: Authorization: Agent ag_sk_<token>

Claude Code verwendet dieselbe Remote-HTTP-Transport-Form:

{
  "primecal": {
    "type": "http",
    "url": "https://api.primecal.eu/api/mcp",
    "headers": {
      "Authorization": "Agent ag_sk_your_token_here"
    }
  }
}

Starte die Validierung mit:

  1. tools/list
  2. primecal_profile_get
  3. primecal_context_snapshot

Validierungs-Checkliste (May.B.Late)​

Überprüfe nach der Verbindung:

  • primecal_profile_get gibt timezone: Europe/Budapest zurück.
  • primecal_calendars_list enthält Work, Personal, Side projects.
  • primecal_tasks_list gibt die Seed-Aufgaben zurück.
  • tools/list stimmt mit der gewählten Berechtigungsgruppe überein. Zum Beispiel sollte ein Nur Lesen (alles)-Host keine Erstellen-, Aktualisieren-, Löschen- oder reine Trigger-Tools sehen.

Screenshot-Aufnahme​

Für wiederholbare Screenshots (Agenten-UI, Chrome-Host-Konfiguration, Tool-Aufruf-Ausgabe, Profilseite) verwende:

In diesem Repository-Zustand sind PrimeCal-UI-Screenshots bereits unter docs/assets/agents/ gebündelt. Chrome-Host-spezifische Screenshots sind mit genauen Aufnahmeschritten und Zieldateinamen im Runbook dokumentiert.