Connecter des hôtes MCP

Cette page présente des modèles de connexion pratiques pour PrimeCal MCP avec l'utilisatrice de démonstration Alex Example, en utilisant une clé API d'agent statique générée manuellement (ag_sk_...).

Si votre assistant IA propose à la place un bouton Connecter ou Ajouter un connecteur et prend en charge OAuth, utilisez plutôt Se connecter via OAuth — cela atteint le même serveur MCP sans copier une clé à la main.

Tous les exemples de sortie sur cette page proviennent de l'utilisatrice exemple fictive Alex Example ; votre propre sortie affichera vos propres données.

Modes de connexion

Le serveur MCP de PrimeCal utilise Streamable HTTP à https://api.primecal.eu/api/mcp. Utilisez une clé API d'agent par instance d'hôte.

Ne dirigez pas les hôtes MCP vers https://app.primecal.eu/api/mcp — cet hôte sert l'application web, pas l'API.

Chrome MCP (HTTP)

Utilisez ceci lorsque votre extension/pont Chrome MCP prend en charge les serveurs MCP HTTP distants.

Avant de générer la configuration d'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 contexte uniquement
• All read-only pour parcourir en toute sécurité les calendriers, tâches, réservations et l'état d'automatisation
• Operational read/write 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 de point de terminaison sur https://api.primecal.eu/api/mcp.
4. Ajoutez l'en-tête Authorization: Agent ag_sk_<token>.
5. Enregistrez et reconnectez-vous.
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://api.primecal.eu/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 mais mappez-les à cette interface.

PrimeCal peut également émettre une annotation permissionGroup non sensible dans sa configuration générée. Traitez-la uniquement comme des métadonnées destinées à l'opérateur. L'hôte doit toujours se fier aux capacités MCP explicitement délimitées renvoyées par PrimeCal.

Claude Desktop, VS Code ou Cursor

Ces hôtes se connectent de la même manière que Chrome MCP : comme un serveur MCP HTTP distant, en utilisant votre clé API d'agent. Il n'y a aucune étape d'installation locale — le serveur MCP de PrimeCal est celui hébergé sur api.primecal.eu, le même serveur auquel se connecte tout autre hôte.

Utilisez les mêmes valeurs que pour Chrome :

• URL : https://api.primecal.eu/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 avec :

1. tools/list
2. primecal_profile_get
3. primecal_context_snapshot

Liste de vérification de validation (Alex Example)

Après la connexion, vérifiez :

• primecal_profile_get renvoie timezone: Europe/Budapest.
• primecal_calendars_list inclut Work, Personal, Side projects.
• primecal_tasks_list renvoie les tâches préremplies.
• tools/list correspond au groupe de permissions que vous avez sélectionné. Par exemple, un hôte All read-only ne devrait voir aucun outil de création, mise à jour, suppression ou déclenchement uniquement.