Centre d'aide

Assistants IA (MCP)

Le serveur MCP de Peerdom permet à n’importe quel assistant IA de répondre à des questions sur votre organisation - vos collègues, vos rôles, vos cercles, qui occupe quoi, où se trouvent les manques - en langage naturel. Il parle le Model Context Protocol (MCP), un standard ouvert pour connecter les assistants IA à des outils et à des données, de sorte qu’il fonctionne avec l’assistant que vous utilisez déjà plutôt que de vous lier à un seul fournisseur.

Vous le connectez avec votre clé API Peerdom existante. Rien à installer de votre côté, et vous pouvez être opérationnel en environ une minute.

Le serveur MCP prend en charge la lecture et l'écriture. Les assistants peuvent interroger votre organisation et, avec la même clé API, y apporter des modifications (créer, mettre à jour et supprimer des collègues, des rôles et des groupes). Votre clé API détermine ce que les assistants peuvent faire ; révoquez-la à tout moment pour déconnecter tous les assistants d'un coup.

Ce que vous pouvez demander

Une fois connecté, vous pouvez poser à votre assistant des questions comme :

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

En coulisses, l’assistant utilise un ensemble d’outils de lecture - lister et inspecter les collègues, les rôles et les cercles ; trouver les rôles vacants ; et résumer la charge de travail dans l’organisation - et répond en langage naturel.

Ce dont chaque client a besoin

Chaque client MCP se connecte au même endpoint avec le même en-tête :

Endpoint:  https://mcp.peerdom.org/mcp
Header:    X-Api-Key: <your-api-key>

Obtenir votre clé API

Rendez-vous dans Paramètres > Mes données > Clés API dans les Paramètres de l’organisation et cliquez sur Créer une clé. Seuls les utilisateurs disposant des droits d’accès propriétaire peuvent créer et gérer les clés API. Il s’agit de la même clé que celle utilisée par l’API REST - une clé par organisation.

Votre clé API accorde un accès complet en lecture aux données de votre organisation - traitez-la comme un mot de passe. Ne la collez jamais dans un dépôt public et ne la partagez jamais dans une capture d'écran. 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, vous vous connectez directement dans le navigateur ; tout autre client a besoin de l’endpoint et de votre clé API dans sa configuration.

claude.ai et les applications Claude

Le moyen le plus simple de se connecter - aucun fichier de configuration nécessaire. Sur 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 vous demande la clé API de votre organisation - collez-la une seule fois, c’est terminé. Les connecteurs ajoutés ici sont également disponibles dans les applications Claude pour ordinateur et mobile.

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

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 utilisez le plan gratuit ? Claude Desktop atteint les serveurs distants via un petit pont appelé 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 que l'en-tête ne comporte aucun espace après les deux-points (X-Api-Key:${PEERDOM_API_KEY}). Le pont découpe l'argument au premier espace, donc garder la valeur attachée évite une erreur de connexion courante.

Claude Code

Depuis votre terminal :

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

Exécutez 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 manière sécurisée.

Sur GitHub Copilot Business et Enterprise, le MCP est contrôlé par un administrateur et désactivé par défaut. Demandez à votre administrateur Copilot d'activer les serveurs MCP si vous ne voyez pas l'option.

ChatGPT

ChatGPT prend en charge les serveurs MCP personnalisés en mode développeur (bêta). Activez-le dans Settings > Connectors > Advanced > Developer mode, puis ajoutez un connecteur pointant vers https://mcp.peerdom.org/mcp.

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

{
  "type": "mcp",
  "server_label": "peerdom",
  "server_url": "https://mcp.peerdom.org/mcp",
  "headers": { "X-Api-Key": "your-api-key" }
}
Les connecteurs publiés de l'application grand public ChatGPT nécessitent OAuth, que le serveur Peerdom n'offre pas encore - utilisez donc le mode développeur ou la Responses API pour le moment. La prise en charge d'OAuth arrive bientôt (voir Ce qui fonctionne aujourd'hui).

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 de confiance. Pointez un client MCP local tel que LM Studio 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 (par exemple Qwen3, GLM-4.5 ou Gemma) pour une pile entièrement hors ligne, ou à une API de modèle souverain suisse telle qu’Infomaniak pour une configuration hébergée dans l’UE ou en Suisse. L’assistant s’exécute là où vous le choisissez ; seule votre clé API parvient à Peerdom.

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

Ce qui fonctionne aujourd’hui

Le serveur prend en charge deux accès : un en-tête de clé API, que tout assistant de classe développeur ou IDE prend en charge, et la connexion OAuth pour les applications de chat dans le cloud comme claude.ai - vous y collez votre clé API une seule fois sur une page Peerdom au lieu de la stocker dans un fichier de configuration.

ClientFonctionne aujourd’huiCommentNotes
Claude Desktop✅Pont mcp-remoteL’interface native du connecteur n’a pas de champ d’en-tête - utilisez la configuration ci-dessus
Claude Code✅DirectL’intégration la plus naturelle
Cursor✅Directheaders dans mcp.json
VS Code / Copilot✅DirectBusiness/Enterprise : l’administrateur doit activer le MCP
ChatGPT - mode développeur✅DirectBêta ; confirmez le champ d’en-tête personnalisé dans l’interface
OpenAI Responses API✅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 + apps)✅Connecteur OAuthAjoutez un connecteur personnalisé - aucune configuration nécessaire
ChatGPT - connecteurs publiés⏳OAuthPrise en charge côté serveur prête - vérification en cours
Application grand public Gemini❌-Pas de prise en charge MCP personnalisée

Vérifier que ça fonctionne

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

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é manquante ou invalide renvoie 401 Missing X-Api-Key header.

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, définir 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, ce qui vous permet de confirmer ou d’annuler chaque modification. Certaines opérations sont réversibles (supprimer un·e collègue est une suppression réversible qui conserve la personne dans vos archives), tandis que la suppression d’un rôle ou d’un groupe est définitive. Utilisez un assistant de confiance et révoquez la clé API à tout moment pour déconnecter tous les assistants d’un coup.

Peerdom stocke-t-il ma clé API ?

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

Quels assistants puis-je utiliser ?

Tout client MCP. Les applications de chat dans le cloud comme claude.ai se connectent via OAuth ; les outils développeur définissent un en-tête de requête - voir Ce qui fonctionne aujourd’hui. Vous n’êtes pas lié à un seul 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 concernant 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. Cela se limite à l’unique organisation à laquelle appartient la clé.

En lien