# Présentation de MCP

Comment connecter un assistant IA comme Claude ou ChatGPT à votre organisation plnnrly, et ce qu'il peut faire une fois connecté.

plnnrly propose un serveur MCP (Model Context Protocol). Connectez-y un assistant IA, et il pourra lire et modifier les données de votre organisation à votre place. Il agit en votre nom : il peut voir et modifier ce que votre compte peut, rien de plus.

## Avant de commencer

Un administrateur active MCP dans **Paramètres › Administration › MCP & API**. Il faut le droit **Voir MCP & API** pour ouvrir cette page, et le droit **Gérer MCP & API** pour en modifier les réglages. MCP est désactivé pour les nouvelles organisations, et il ne fonctionne que si l'API REST est activée ; la page [Pour les administrateurs](https://developers.plnnrly.com/fr/docs/administration/) explique ces réglages.

## Informations de connexion

- URL du serveur : `https://<votre-url>/mcp/v1`
- Transport : HTTP (streamable)
- Authentification : Identification (OAuth)

`<votre-url>` est l'adresse où vous vous identifiez sur plnnrly, par exemple `acme.plnnrly.com`, ou le domaine propre de votre organisation. Le panneau **IA** (l'icône étincelles dans la barre du haut) affiche l'URL exacte du serveur pour votre organisation. Ce panneau apparaît dès que MCP est activé.

## Comment fonctionne la connexion

Vous ajoutez l'URL du serveur dans votre client IA. Le client ouvre plnnrly dans votre navigateur : vous vous identifiez si nécessaire, puis vous approuvez la connexion. Il n'y a aucun token à copier.

L'écran d'approbation affiche :

- le compte avec lequel vous êtes identifié
- ce que l'application demande, par exemple **Utiliser le serveur MCP (assistants IA)**
- un avertissement quand votre organisation autorise les actions destructives, car l'application peut alors aussi supprimer des enregistrements
- l'adresse vers laquelle vous êtes renvoyé après l'approbation
- **Autoriser** et **Annuler**

Une session de support ne peut pas connecter d'application. Identifiez-vous avec votre propre compte.

Une fois connecté, le client renouvelle son accès toutes les heures, de lui-même. Un client que vous n'avez pas utilisé depuis 30 jours doit s'identifier de nouveau.

Vous aviez connecté un client avec un token MCP personnel avant l'arrivée de l'identification ? Ce token continue de fonctionner. Vous pouvez le supprimer dans le panneau **IA**, sous **Jeton d'accès personnel**. Il n'est plus possible de créer de nouveaux tokens MCP personnels.

## Déconnecter une application

Le panneau **IA** liste les applications que vous avez connectées, sous **Applications connectées**. **Déconnecter** met fin immédiatement à la connexion IA d'une application, et vous pouvez la reconnecter plus tard. Si la même identification donnait aussi à l'application un accès à l'API REST, cet accès prend fin lui aussi. Les applications connectées uniquement à l'API REST figurent plutôt sous **Accès API › Applications connectées**, dans votre menu utilisateur.

Retirer plnnrly dans le client empêche ce client de l'utiliser. Cela ne met pas toujours fin à l'identification dans plnnrly : l'application peut rester listée jusqu'à 30 jours après sa dernière utilisation, sauf si le client a lui-même annulé son identification. Pour être sûr que la connexion est coupée, utilisez **Déconnecter**.

## Ce qu'un client peut faire

Un client connecté accède à toutes les opérations de l'API REST, sauf l'envoi de fichiers, toujours en votre nom et dans la limite de vos droits. Il ne peut supprimer que si votre organisation l'autorise et que vous confirmez.

- [Ce que vous pouvez demander](https://developers.plnnrly.com/fr/docs/mcp/examples/) donne des exemples de questions pour chaque partie de plnnrly.
- [Outils](https://developers.plnnrly.com/fr/docs/mcp/tools/) décrit les quatre outils qu'utilise un client.
- [Droits et sécurité](https://developers.plnnrly.com/fr/docs/mcp/permissions-and-safety/) explique ce qu'un client a le droit de faire et comment la suppression est verrouillée.

## Choisissez votre client

- [claude.ai](https://developers.plnnrly.com/fr/docs/mcp/install/claude-ai/) : Un connecteur personnalisé sur votre compte Claude. Il fonctionne ensuite aussi dans Claude Desktop et les applications mobiles.

  1. Dans Claude, ouvrez **Customize › Connectors** et choisissez **Add custom connector**.
  2. Saisissez `plnnrly` comme nom et collez l'URL du serveur.
  3. Cliquez sur **Add**, identifiez-vous sur plnnrly et cliquez sur **Autoriser**.

- [Claude Desktop](https://developers.plnnrly.com/fr/docs/mcp/install/claude-desktop/) : Le même connecteur que sur claude.ai. Si vous l'y avez ajouté, il est déjà là.

  1. Dans Claude Desktop, ouvrez **Customize › Connectors** et choisissez **Add custom connector**.
  2. Saisissez `plnnrly` comme nom et collez l'URL du serveur.
  3. Cliquez sur **Add**. Une fenêtre plnnrly s'ouvre dans votre navigateur : identifiez-vous et cliquez sur **Autoriser**.

- [Claude Code](https://developers.plnnrly.com/fr/docs/mcp/install/claude-code/) : Lancez cette commande dans votre terminal, puis identifiez-vous avec `claude mcp login plnnrly`.

  ```bash
  claude mcp add --transport http plnnrly https://<votre-url>/mcp/v1
  ```

- [ChatGPT](https://developers.plnnrly.com/fr/docs/mcp/install/chatgpt/) : ChatGPT sur le web ajoute plnnrly comme serveur MCP personnalisé.

  1. Ouvrez chatgpt.com/plugins et choisissez **+**, puis **Add custom MCP server**.
  2. Collez l'URL du serveur sous **Connection** et choisissez **OAuth**.
  3. Créez et installez le plugin. Identifiez-vous ensuite sur plnnrly et cliquez sur **Autoriser**.

- [Cursor](https://developers.plnnrly.com/fr/docs/mcp/install/cursor/) : Ajoutez cette entrée à `~/.cursor/mcp.json`. Cursor vous demande de vous identifier sur plnnrly quand il se connecte.

  ```json
  {
    "mcpServers": {
      "plnnrly": {
        "url": "https://<votre-url>/mcp/v1"
      }
    }
  }
  ```

- [Gemini](https://developers.plnnrly.com/fr/docs/mcp/install/gemini/) : Lancez cette commande dans votre terminal, démarrez `gemini` et identifiez-vous avec `/mcp auth plnnrly`.

  ```bash
  gemini mcp add --transport http --scope user plnnrly https://<votre-url>/mcp/v1
  ```

- [Autres clients](https://developers.plnnrly.com/fr/docs/mcp/install/other-clients/)