Vue d'ensemble des agents IA (MCP)

PrimeCal intègre un serveur Model Context Protocol (MCP) conforme aux standards, afin que les outils IA puissent lire et mettre à jour les calendriers, tâches, automations, contexte de profil et données de réservation d'entreprise via une seule surface d'intégration.

• Spécification MCP : modelcontextprotocol.io/docs/getting-started/intro
• Point d'accès HTTP streamable PrimeCal : POST/GET/DELETE /api/mcp
• Point d'entrée stdio PrimeCal pour les hôtes de bureau : backend-nestjs/src/mcp-server/bin/primecal-mcp-stdio.ts

Pour PrimeCal Cloud, utilisez https://api.primecal.eu/api/mcp comme URL MCP distante. L'hôte https://app.primecal.eu sert le shell de l'application frontend. Sur Azure Static Web Apps Free, les backends /api/* liés ne sont pas disponibles depuis cet hôte frontend, qui ne peut donc pas être utilisé comme origine MCP.

Ce que le MCP PrimeCal vous apporte

• Outils pour :
  • les événements de calendrier et les groupes de personnes
  • les tâches, étiquettes et rappels
  • les règles d'automation et les instantanés d'audit
  • le profil et les instantanés de contexte
  • les organisations, types de ressources, ressources, disponibilités et réservations
• Ressources pour des ensembles de contexte en lecture seule :
  • primecal://current-context
  • primecal://automation-summary
• Données enrichies pour que les hôtes reçoivent un contexte complet, pas seulement des identifiants.

PrimeCal n'expose pas les secrets Stripe, la création de sessions Checkout, ni la gestion des webhooks via MCP dans la version actuelle du module de réservation.

Disponibilité et sécurité

Le MCP PrimeCal est une fonctionnalité centrale.

• Il n'y a pas de drapeau de fonctionnalité pour activer le MCP.
• Le MCP est disponible dès que PrimeCal est en cours d'exécution avec une configuration MCP valide.
• La sécurité est assurée par :
  • les profils d'agents
  • les permissions à périmètre défini
  • les clés API d'agents
  • les périmètres d'organisation et de type de ressource pour les outils de réservation

Prise en charge des réservations d'entreprise

Les agents MCP compatibles avec les réservations peuvent :

• lister les organisations auxquelles ils ont accès
• changer l'organisation active en toute sécurité
• lister les types de ressources et les ressources concrètes
• calculer la disponibilité en tenant compte des réservations et de la logique de blocage des calendriers
• créer des flux de réservation sans paiement lorsque les permissions configurées le permettent

PrimeCal maintient la frontière de paiement séparée. Si une réservation nécessite un paiement Stripe, le MCP ne crée pas et ne complète pas ce flux de paiement pour l'agent.

Utilisateur de démonstration canonique : May.B.Late

Tous les guides de cette section utilisent May.B.Late comme utilisateur exemple.

Profil prédéfini attendu :

• Nom d'utilisateur : mayblate
• Calendriers : Work, Personal, Side projects
• Étiquettes de tâches et tâches déjà présentes
• Au moins une règle d'automation activée
• Paramètres de profil configurés pour les démonstrations MCP (fuseau horaire, format d'heure, thème)

Consultez Configurer un agent dans PrimeCal, Connecter des hôtes MCP, et Outils de réservation d'entreprise pour MCP pour le flux complet.

Référence de l'interface réelle