Zum Hauptinhalt springen
Was this helpful?

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.

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. Auf Azure Static Web Apps Free sind verknüpfte /api/*-Backends über diesen Frontend-Host nicht erreichbar – nutze dort direkt den Backend-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.

Kanonischer Demo-Benutzer: May.B.Late​

Alle Anleitungen in diesem Abschnitt verwenden May.B.Late als Beispielbenutzer.

Erwartetes Seed-Profil:

  • Benutzername: mayblate
  • Kalender: Work, Personal, Side projects
  • Aufgaben-Labels und Aufgaben bereits vorhanden
  • Mindestens eine aktivierte Automatisierungsregel
  • Profileinstellungen für MCP-Demos optimiert (Zeitzone, Zeitformat, Design)

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

Referenz: Echte Benutzeroberfläche​

PrimeCal KI-Agenten-Einstellungsbereich zum Konfigurieren von Agenten-Profilen, Berechtigungen und API-Keys