Réserver une démo Commencer
Réserver une démo Commencer

Assistants IA (MCP)

Le serveur MCP de Peerdom permet à n’importe quel assistant IA de répondre en langage naturel à vos questions sur votre organisation : vos collègues, vos rôles, vos cercles, qui tient quoi, où sont les trous. Il parle le Model Context Protocol (MCP), un standard ouvert de connexion entre assistants IA, outils et données : il fonctionne donc avec l’assistant que vous utilisez déjà, sans vous lier à un fournisseur.

Vous le branchez avec la clé API Peerdom que vous avez déjà. Rien à installer de votre côté, et vous êtes opérationnel en une minute environ.

Le serveur MCP fonctionne en lecture comme en écriture. Un assistant peut interroger votre organisation et, avec la même clé API, la modifier (créer, mettre à jour et supprimer des collègues, des rôles et des groupes). Votre clé API commande ce que les assistants ont le droit de faire ; révoquez-la à tout moment pour les déconnecter tous d'un coup.

Ce que vous pouvez demander

Une fois la connexion faite, vous pouvez poser à votre assistant des questions comme :

  • « À quelle organisation suis-je connecté ? »
  • « Quels rôles du cercle Marketing sont actuellement vacants ? »
  • « Qui tient le rôle Finance Lead, et quelle est sa contribution ? »
  • « Quels rôles Maria tient-elle, et dans quels cercles ? »
  • « Qui porte le plus de rôles en ce moment ? Y a-t-il quelqu’un en surcharge ? »
  • « Montre-moi la structure de notre organisation sous forme de plan. »

En coulisses, l’assistant se sert d’un jeu d’outils : des outils de lecture pour lister et inspecter collègues, rôles et cercles, repérer les rôles vacants et résumer la charge de travail, plus des outils d’écriture pour créer, mettre à jour et supprimer collègues, rôles et groupes. L’assistant choisit lequel appeler selon votre question et répond en langage naturel.

Ce dont chaque client a besoin

Tous les clients MCP se connectent au même endpoint avec le même en-tête :

Endpoint :  https://mcp.peerdom.org/mcp
En-tête :   X-Api-Key: <votre-cle-api>

Obtenir votre clé API

Rendez-vous dans Paramètres > Mes données > Clés API au sein des paramètres de l’organisation et cliquez sur Nouvelle clé API. Seules les personnes disposant du droit d’accès Propriétaire peuvent créer et gérer des clés API. C’est la même clé que celle utilisée par l’API REST : une clé par organisation.

Votre clé API donne un accès complet en lecture et en écriture aux données de votre organisation. Traitez-la comme un mot de passe : ne la collez jamais dans un dépôt public, ne la montrez pas dans une capture d'écran, et ne la stockez que là où votre client d'assistant peut la lire. Vous pouvez révoquer une clé à tout moment depuis les paramètres de l'organisation, ce qui déconnecte immédiatement tous les assistants qui l'utilisent.

Configurer votre client

Choisissez l’assistant que vous utilisez. Sur claude.ai et ChatGPT, la connexion se fait directement dans le navigateur ; tous les autres clients ont besoin de l’endpoint et de votre clé API dans leur configuration.

claude.ai et les applications Claude

C’est le plus simple : aucun fichier de configuration. Dans claude.ai, ouvrez Settings > Connectors, cliquez sur Add custom connector et collez l’endpoint :

https://mcp.peerdom.org/mcp

Cliquez ensuite sur Connect. Une page Peerdom s’ouvre et demande la clé API de votre organisation : collez-la une fois, et c’est terminé. Les connecteurs ajoutés ici sont aussi disponibles dans les applications Claude pour ordinateur et mobile.

Les connecteurs personnalisés demandent un plan Claude payant. Pendant la connexion, votre clé API est échangée contre un jeton d'accès privé ; révoquer la clé dans Peerdom déconnecte l'assistant immédiatement.

Claude Desktop

Avec un plan Claude payant, le connecteur claude.ai ci-dessus couvre aussi l’application de bureau. Vous préférez un fichier de configuration, ou vous êtes sur le plan gratuit ? Claude Desktop atteint les serveurs distants par un petit pont nommé mcp-remote. Ouvrez Settings > Developer > Edit Config et ajoutez :

{
  "mcpServers": {
    "peerdom": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.peerdom.org/mcp", "--header", "X-Api-Key:${PEERDOM_API_KEY}"],
      "env": { "PEERDOM_API_KEY": "your-api-key" }
    }
  }
}

Enregistrez le fichier et redémarrez Claude Desktop. Les outils Peerdom apparaissent sous l’icône des connecteurs.

Notez qu'il n'y a pas d'espace après les deux-points dans l'en-tête (X-Api-Key:${PEERDOM_API_KEY}). Le pont découpe l'argument au premier espace : garder la valeur accolée évite une erreur de connexion classique.

Claude Code

Depuis votre terminal :

claude mcp add --transport http peerdom https://mcp.peerdom.org/mcp \
  --header "X-Api-Key: your-api-key"

Lancez claude mcp list pour confirmer la connexion.

Cursor

Ouvrez Settings > MCP > Add new MCP server, ou modifiez directement ~/.cursor/mcp.json :

{
  "mcpServers": {
    "peerdom": {
      "url": "https://mcp.peerdom.org/mcp",
      "headers": { "X-Api-Key": "your-api-key" }
    }
  }
}

VS Code / GitHub Copilot

En mode agent, ajoutez un fichier .vscode/mcp.json à votre espace de travail :

{
  "servers": {
    "peerdom": {
      "type": "http",
      "url": "https://mcp.peerdom.org/mcp",
      "headers": { "X-Api-Key": "${input:peerdom_key}" }
    }
  }
}

VS Code demande la clé la première fois et la stocke de façon sécurisée.

Sur GitHub Copilot Business et Enterprise, MCP est sous le contrôle d'une personne administratrice et désactivé par défaut. Demandez-lui d'activer les serveurs MCP si l'option n'apparaît pas.

ChatGPT

ChatGPT se connecte via des plugins (auparavant des connecteurs, puis des apps). Activez le Developer Mode sous Settings > Plugins > Advanced, ajoutez un plugin personnalisé pointant vers https://mcp.peerdom.org/mcp, et choisissez OAuth comme méthode d’authentification. ChatGPT vous envoie vers une page Peerdom où vous collez une fois la clé API de votre organisation : la clé est échangée contre un jeton d’accès privé et n’est jamais stockée chez OpenAI.

Pour un usage programmatique, la Responses API d’OpenAI accepte directement notre serveur comme outil mcp :

{
  "type": "mcp",
  "server_label": "peerdom",
  "server_url": "https://mcp.peerdom.org/mcp",
  "headers": { "X-Api-Key": "your-api-key" }
}
OpenAI renomme régulièrement cette partie de ChatGPT : les plugins étaient auparavant des apps, et avant cela des connecteurs. Si les noms de menu ont encore bougé, cherchez l'endroit où l'on ajoute un serveur MCP personnalisé : l'endpoint et la connexion OAuth, eux, ne changent pas.

Gemini CLI

Modifiez ~/.gemini/settings.json :

{
  "mcpServers": {
    "peerdom": {
      "httpUrl": "https://mcp.peerdom.org/mcp",
      "headers": { "X-Api-Key": "your-api-key" }
    }
  }
}

Modèles locaux et hébergés en Suisse

Comme MCP est un standard ouvert, vous pouvez tout garder sur une infrastructure en laquelle vous avez confiance. Pointez un client MCP local, LM Studio par exemple, vers le serveur :

{
  "mcpServers": {
    "peerdom": {
      "url": "https://mcp.peerdom.org/mcp",
      "headers": { "X-Api-Key": "your-api-key" }
    }
  }
}

Associez un client compatible MCP à un modèle local à poids ouverts (Qwen3, GLM-4.5 ou Gemma, par exemple) pour une pile entièrement hors ligne, ou à une API de modèle souverain suisse comme Infomaniak pour une installation hébergée en Suisse ou dans l’UE. L’assistant tourne là où vous le décidez ; seule votre clé API atteint Peerdom.

Vous voulez choisir le modèle vous-même ? Le guide Apportez votre propre LLM détaille une installation pour développeurs, avec l'API OpenAI-compatible hébergée en Suisse d'Infomaniak comme exemple concret.

Ce qui fonctionne aujourd’hui

Le serveur accepte deux entrées : un en-tête portant la clé API, que tous les assistants de type développeur ou IDE savent envoyer, et une connexion OAuth pour les applications de chat dans le cloud comme claude.ai et ChatGPT, où vous collez votre clé API une fois sur une page Peerdom au lieu de la stocker dans un fichier de configuration.

ClientFonctionne aujourd’huiCommentRemarques
Claude Desktop✅Pont mcp-remoteL’interface de connecteur native n’a pas de champ d’en-tête : utilisez la configuration ci-dessus
Claude Code✅DirectL’intégration la plus propre
Cursor✅Directheaders dans mcp.json
VS Code / Copilot✅DirectBusiness/Enterprise : l’administration doit activer MCP
ChatGPT : plugins personnalisés✅Connecteur OAuthActivez le Developer Mode, ajoutez le plugin : aucune configuration
Responses API d’OpenAI✅DirectOutil mcp natif
Gemini CLI✅DirecthttpUrl + headers
LM Studio / agents locaux✅DirectGardez le modèle en local ou hébergé en Suisse
claude.ai (web et applications)✅Connecteur OAuthAjoutez un connecteur personnalisé : aucune configuration
ChatGPT : annuaire de plugins⏳AucunPas encore référencé : ajoutez-le comme plugin personnalisé
Application grand public Gemini❌AucunPas de prise en charge des MCP personnalisés

Vérifier que ça fonctionne

Demandez à votre assistant : « À quelle organisation suis-je connecté ? » Il devrait répondre par le nom de votre organisation, ce qui confirme d’un coup la clé, la connexion et le chemin des données.

Pour tester sans client, envoyez une requête directement :

curl -s -X POST https://mcp.peerdom.org/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'X-Api-Key: your-api-key' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_organization","arguments":{}}}'

Une clé absente renvoie 401 invalid_token ; une clé invalide renvoie une erreur d’outil indiquant que la clé est manquante, invalide ou expirée.

Questions fréquentes

L’assistant peut-il modifier mon organisation ?

Oui. Avec votre clé API, un assistant peut créer, mettre à jour et supprimer des collègues, des rôles et des groupes, renseigner des valeurs de champs personnalisés, attribuer des titulaires de rôle, et plus encore. La plupart des clients IA (Claude Desktop, Claude Code, Cursor, etc.) affichent chaque appel d’outil avant de l’exécuter : vous confirmez ou annulez chaque changement. Certaines opérations sont réversibles (supprimer un·e collègue est une suppression douce qui conserve la personne dans votre archive), tandis que retirer un rôle ou un groupe est définitif. Utilisez un assistant en qui vous avez confiance, et révoquez la clé API quand vous voulez pour les déconnecter tous d’un coup.

Peerdom stocke-t-il ma clé API ?

Non. Votre clé transite à chaque requête vers l’API de Peerdom et n’est jamais stockée sur le serveur MCP. Révoquez-la quand vous voulez dans les paramètres de l’organisation pour déconnecter tous les assistants d’un coup.

Quels assistants puis-je utiliser ?

N’importe quel client MCP. Les applications de chat dans le cloud comme claude.ai et ChatGPT se connectent via OAuth ; les outils pour développeurs passent par un en-tête de requête, voir Ce qui fonctionne aujourd’hui. Vous n’êtes lié à aucun fournisseur : apportez l’assistant en qui vous avez déjà confiance.

Ai-je besoin d’un plan Peerdom spécifique ?

L’accès à l’API est disponible sur les plans payants. Contactez le support Peerdom pour les détails de votre plan.

Quelles données l’assistant peut-il voir ?

Tout ce que votre clé API peut lire : les collègues, les rôles, les cercles, les titulaires, les postes vacants et la charge de travail de votre organisation. Le périmètre se limite à l’unique organisation à laquelle la clé appartient.

En lien