KI-Agenten (MCP) – Übersicht

PrimeCal enthält einen standardkonformen Model Context Protocol (MCP)-Server, damit KI-Tools über eine einzige Integrationsfläche Kalender, Aufgaben, Automatisierungen, Profilkontext und Enterprise-Reservierungsdaten lesen und aktualisieren können.

• MCP-Spezifikation: modelcontextprotocol.io/docs/getting-started/intro
• PrimeCal Streamable-HTTP-Endpunkt: POST/GET/DELETE /api/mcp

Für PrimeCal Cloud verwende https://api.primecal.eu/api/mcp als Remote-MCP-URL. Der Host https://app.primecal.eu liefert nur die Frontend-Anwendungsschale. Der Frontend-Host leitet /api/*-Anfragen nicht weiter und kann daher nicht als MCP-Origin verwendet werden – nutze direkt den API-Host.

Was PrimeCal MCP dir bietet

• Tools für:
  • Kalenderereignisse und Personengruppen
  • Aufgaben, Labels und Erinnerungen
  • Automatisierungsregeln und Audit-Snapshots
  • Profil- und Kontext-Snapshots
  • Organisationen, Ressourcentypen, Ressourcen, Verfügbarkeit und Reservierungen
• Resources für schreibgeschützte Kontextpakete:
  • primecal://current-context
  • primecal://automation-summary
• Vollständige Payloads, damit Hosts den vollen Kontext erhalten – nicht nur IDs.

PrimeCal legt Stripe-Geheimnisse, die Erstellung von Checkouts und die Webhook-Verarbeitung im aktuellen Reservierungs-Pass nicht über MCP offen.

Verfügbarkeit und Sicherheit

PrimeCal MCP ist eine Kernfunktion.

• Es gibt kein Feature-Flag, um MCP zu aktivieren.
• MCP steht immer zur Verfügung, wenn PrimeCal mit einer gültigen MCP-Konfiguration läuft.
• Die Sicherheit wird durchgesetzt über:
  • Agenten-Profile
  • abgestufte Berechtigungen
  • Agenten-API-Keys
  • Organisations- und Ressourcentyp-Scopes für Reservierungs-Tools

Enterprise-Reservierungsunterstützung

Reservierungsfähige MCP-Agenten können:

• die Organisationen auflisten, auf die sie Zugriff haben
• sicher zwischen aktiven Organisationen wechseln
• Ressourcentypen und konkrete Ressourcen auflisten
• Verfügbarkeit unter Berücksichtigung von Reservierungen und blockierenden Kalendereinträgen berechnen
• nicht zahlungspflichtige Reservierungsabläufe erstellen, sofern die konfigurierten Berechtigungen dies erlauben

PrimeCal hält die Zahlungsgrenze getrennt. Wenn eine Reservierung eine Stripe-Zahlung erfordert, erstellt oder schließt MCP diesen Zahlungsfluss nicht für den Agenten ab.

Beispielbenutzer: Alex Example

Die Anleitungen in diesem Abschnitt verwenden einen fiktiven Beispielbenutzer, Alex Example, mit drei Kalendern (Work, Personal, Side projects), ein paar Aufgaben und einer Automatisierungsregel. Dein eigenes Konto zeigt deine eigenen Daten; die Schritte sind identisch.

Weitere Informationen findest du unter Einen Agenten in PrimeCal konfigurieren, MCP-Hosts verbinden und Enterprise-Reservierungs-Tools für MCP.

Referenz: Echte Benutzeroberfläche

Baust du einen KI-ersten Kalender-Workflow? Siehe PrimeCal für KI-Entwickler für das größere Angebot und die Preise.