MCP-Hosts verbinden

Diese Seite zeigt praktische Verbindungsmuster für PrimeCal MCP mit dem Demo-Benutzer Alex Example, unter Verwendung eines manuell erzeugten statischen Agent-API-Schlüssels (ag_sk_...).

Wenn dein KI-Assistent stattdessen eine Schaltfläche Verbinden oder Connector hinzufügen anbietet und OAuth unterstützt, verwende stattdessen Verbinden über OAuth — das erreicht denselben MCP-Server, ohne einen Schlüssel manuell zu kopieren.

Alle Beispielausgaben auf dieser Seite stammen vom fiktiven Beispielbenutzer Alex Example; deine eigene Ausgabe zeigt deine eigenen Daten.

Verbindungsmodi

PrimeCals MCP-Server verwendet Streamable HTTP unter https://api.primecal.eu/api/mcp. Verwende einen Agent-API-Schlüssel pro Host-Instanz.

Richte MCP-Hosts nicht auf https://app.primecal.eu/api/mcp — dieser Host bedient die Web-App, nicht die API.

Chrome MCP (HTTP)

Verwende dies, wenn deine Chrome-MCP-Erweiterung/-Brücke entfernte HTTP-MCP-Server unterstützt.

Wähle vor dem Generieren der Host-Konfiguration in PrimeCal die engste zum Host passende Berechtigungsgruppe:

• Minimal für Rauchtests und reine Kontext-Assistenten
• All read-only zum sicheren Durchsuchen von Kalendern, Aufgaben, Reservierungen und Automatisierungsstatus
• Operational read/write nur, wenn der Host Planungsdaten erstellen oder aktualisieren muss

1. Öffne die Einstellungen deines Chrome-MCP-Hosts.
2. Füge einen Server namens primecal hinzu.
3. Setze die Endpunkt-URL auf https://api.primecal.eu/api/mcp.
4. Füge den Header Authorization: Agent ag_sk_<token> hinzu.
5. Speichere und verbinde erneut.
6. Führe tools/list aus und rufe dann primecal_calendars_list auf.

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

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

Wenn deine Erweiterung andere Feldnamen verwendet (endpoint, serverUrl, authHeaders), behalte dieselben Werte, aber ordne sie dieser Oberfläche zu.

PrimeCal kann in seiner generierten Konfiguration auch eine nicht sensible permissionGroup-Annotation ausgeben. Behandle das nur als Metadaten für Betreiber. Der Host sollte sich weiterhin auf die expliziten, bereichsbeschränkten MCP-Fähigkeiten verlassen, die PrimeCal zurückgibt.

Claude Desktop, VS Code oder Cursor

Diese Hosts verbinden sich genauso wie Chrome MCP: als entfernter HTTP-MCP-Server, mit deinem Agent-API-Schlüssel. Es gibt keinen lokalen Installationsschritt — PrimeCals MCP-Server ist der gehostete Server unter api.primecal.eu, derselbe Server, mit dem sich jeder andere Host verbindet.

Verwende dieselben Werte wie bei Chrome:

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

Claude Code verwendet dieselbe entfernte 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

Validierungscheckliste (Alex Example)

Prüfe nach dem Verbinden:

• primecal_profile_get gibt timezone: Europe/Budapest zurück.
• primecal_calendars_list enthält Work, Personal, Side projects.
• primecal_tasks_list gibt die vorbefüllten Aufgaben zurück.
• tools/list entspricht der ausgewählten Berechtigungsgruppe. Zum Beispiel sollte ein All read-only-Host keine Erstellungs-, Aktualisierungs-, Löschungs- oder reinen Auslöse-Tools sehen.