Présentation de MCP

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 explique ces réglages.

Informations de connexion

<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 donne des exemples de questions pour chaque partie de plnnrly.
• Outils décrit les quatre outils qu'utilise un client.
• Droits et sécurité explique ce qu'un client a le droit de faire et comment la suppression est verrouillée.

Choisissez votre client

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

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

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