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 Roles, vos Circles, 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 est en lecture seule aujourd'hui : les assistants peuvent interroger votre organisation, mais pas la modifier. Des actions d'écriture sécurisées et à portée limitée sont prévues et arriveront dans une prochaine version.

Ce que vous pouvez demander

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

  • « À quelle organisation suis-je connecté ? »
  • « Quels Roles du Circle Marketing sont actuellement vacants ? »
  • « Qui occupe le Role Responsable Finance, et quelle est sa contribution ? »
  • « Quels Roles Maria occupe-t-elle, et dans quels Circles se trouvent-ils ? »
  • « Qui porte le plus de Roles 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, Roles et Circles ; trouver les Roles 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. Chacun a besoin de l’endpoint et de votre clé API dans sa configuration.

Claude Desktop

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 s’authentifie avec un en-tête de clé API, que tout assistant de classe développeur ou IDE prend en charge. Les applications de chat dans le cloud qui n’acceptent que la connexion via OAuth ne sont pas encore accessibles — c’est une seule fonctionnalité prévue, et non une limitation de vos données.

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)⏳—Les connecteurs personnalisés nécessitent OAuth — bientôt disponible
ChatGPT — connecteurs publiés⏳—Nécessitent OAuth — bientôt disponible
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 ?

Non. Le serveur MCP est en lecture seule aujourd’hui — les assistants peuvent lire et résumer vos données, mais ne peuvent rien créer, modifier ni supprimer. Des actions d’écriture sécurisées et à portée limitée arriveront dans une prochaine version.

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 qui vous permet de définir 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, Roles, Circles, titulaires, postes vacants et charge de travail de votre organisation. Cela se limite à l’unique organisation à laquelle appartient la clé.

En lien