Aller au contenu principal
Was this helpful?

Connecter des hôtes MCP

Cette page présente les modes de connexion pratiques pour PrimeCal MCP avec l'utilisateur de démonstration May.B.Late.

Tous les exemples de sorties dans cette page supposent que vous êtes connecté en tant que mayblate.

Modes de connexion​

PrimeCal prend en charge les deux styles de transport MCP courants :

  • HTTP streamable vers https://<votre-primecal>/api/mcp
  • STDIO via le script d'entrée stdio MCP de PrimeCal

Utilisez une clé API d'agent par instance d'hôte.

Note PrimeCal Cloud :

  • Application frontend : https://app.primecal.eu
  • Point d'accès MCP/backend : https://api.primecal.eu/api/mcp
  • Ne pointez pas les hôtes MCP distants vers https://app.primecal.eu/api/mcp ; cet hôte sert le shell SPA, pas l'API backend.
  • Si votre frontend est hébergé sur Azure Static Web Apps Free, /api/* ne peut pas être routé via cet hôte frontend. Utilisez directement l'hôte backend tant que le SWA n'est pas mis à niveau vers Standard.

Chrome MCP (HTTP)​

Utilisez cette méthode lorsque votre extension ou pont Chrome MCP prend en charge les serveurs MCP HTTP distants.

Avant de générer la configuration de l'hôte dans PrimeCal, choisissez le groupe de permissions le plus restreint adapté à l'hôte :

  • Minimal pour les tests de fumée et les assistants de contexte uniquement
  • Tout en lecture seule pour parcourir les calendriers, tâches, réservations et l'état d'automation en toute sécurité
  • Lecture/écriture opérationnelle uniquement lorsque l'hôte doit créer ou mettre à jour des données de planification
  1. Ouvrez les paramètres de votre hôte Chrome MCP.
  2. Ajoutez un serveur nommé primecal.
  3. Définissez l'URL du point d'accès sur https://<votre-primecal>/api/mcp.
  4. Ajoutez l'en-tête Authorization: Agent ag_sk_<token>.
  5. Enregistrez et reconnectez.
  6. Exécutez tools/list, puis appelez primecal_calendars_list.

Exemple de bloc JSON utilisé par de nombreux outils Chrome MCP :

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

Si votre extension utilise un nom de champ différent (endpoint, serverUrl, authHeaders), conservez les mêmes valeurs en les mappant vers ce champ dans l'interface.

PrimeCal peut également émettre une annotation permissionGroup non sensible dans sa configuration générée. Traitez-la comme des métadonnées destinées aux opérateurs uniquement. L'hôte doit toujours s'appuyer sur les capacités MCP explicites à périmètre défini retournées par PrimeCal.

Claude Desktop (STDIO)​

Utilisez cette méthode lorsque vous souhaitez un MCP hébergé localement sur le bureau avec accès au backend PrimeCal.

Prérequis :

  • Dépendances du backend PrimeCal installées
  • Backend compilé (npm --prefix backend-nestjs run build)
  • PRIMECAL_MCP_AGENT_KEY valide

Exemple d'entrée claude_desktop_config.json :

{
  "mcpServers": {
    "primecal": {
      "command": "node",
      "args": [
        "/chemin/absolu/vers/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": "..."
      }
    }
  }
}

Alternative de développement (sans compilation) :

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

VS Code ou Cursor​

La plupart des intégrations MCP pour VS Code et Cursor acceptent également les définitions de serveur MCP HTTP.

Utilisez les mêmes valeurs que pour Chrome :

  • URL : https://<votre-primecal>/api/mcp
  • En-tête d'authentification : Authorization: Agent ag_sk_<token>

Claude Code utilise la même forme de transport HTTP distant :

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

Commencez la validation par :

  1. tools/list
  2. primecal_profile_get
  3. primecal_context_snapshot

Liste de contrôle de validation (May.B.Late)​

Après la connexion, vérifiez que :

  • primecal_profile_get retourne timezone: Europe/Budapest.
  • primecal_calendars_list inclut Work, Personal, Side projects.
  • primecal_tasks_list retourne les tâches prédéfinies.
  • tools/list correspond au groupe de permissions que vous avez sélectionné. Par exemple, un hôte Tout en lecture seule ne devrait pas voir les outils de création, mise à jour, suppression ou déclenchement uniquement.

Capture d'écrans​

Pour des captures d'écrans reproductibles (interface des agents, configuration de l'hôte Chrome, sortie d'appel d'outil, page de profil), utilisez :

Dans l'état actuel de ce dépôt, les captures d'écran de l'interface PrimeCal sont déjà regroupées sous docs/assets/agents/. Les captures d'écran spécifiques à l'hôte Chrome sont documentées avec les étapes de capture exactes et les noms de fichiers cibles dans le guide opérationnel.