# Pour les administrateurs Activez ou désactivez MCP et l'API REST pour votre organisation, et décidez qui peut créer des tokens API et connecter des applications. Cette page s'adresse à la personne qui gère votre organisation plnnrly. Quelqu'un qui veut seulement connecter un assistant IA ou appeler l'API aura peut-être besoin que vous l'activiez d'abord. ## La page MCP & API Les réglages se trouvent dans **Paramètres › Administration › MCP & API**. Deux droits déterminent qui peut utiliser cette page : - **Voir MCP & API** permet d'ouvrir la page et de voir quels réglages sont activés. - **Gérer MCP & API** permet de modifier les réglages. Tant que votre organisation est suspendue, rien ne peut être modifié sur cette page. ## Les trois réglages | Réglage | Par défaut | Ce qu'il fait | | -------------------------------------- | ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Activer l'API REST** | Activé | Permet à chacun d'appeler l'API REST avec ses propres tokens API, et aux applications d'identifier les utilisateurs via OAuth. | | **Activer MCP** | Désactivé dans une nouvelle organisation | Permet de connecter un assistant IA, comme Claude ou ChatGPT, en s'identifiant. L'assistant passe par l'API REST, au nom de la personne qui l'a connecté. | | **Autoriser les actions destructives** | Désactivé | Permet à un assistant IA connecté de supprimer tout ce que l'API REST peut supprimer, dans la limite des droits de la personne et seulement après sa confirmation. Tant que ce réglage est désactivé, un assistant peut lire, créer et modifier, mais pas supprimer. | Comment les réglages dépendent les uns des autres : - **Activer MCP** ne peut être activé que si **Activer l'API REST** l'est aussi, car les assistants IA passent par l'API REST. - Désactiver MCP désactive aussi **Autoriser les actions destructives**. Réactiver MCP plus tard ne le réactive pas. - **Autoriser les actions destructives** ne concerne que les assistants IA. Un token API personnel doté de l'autorisation **Suppression** peut supprimer tout ce que son propriétaire peut supprimer, quel que soit l'état de ce réglage. Les applications qui appellent l'API REST après une identification OAuth ne peuvent jamais supprimer par ce biais. Connecter un assistant IA ne demande aucun droit supplémentaire. Tant que MCP est activé, tout le monde dans l'organisation voit le panneau **IA** (l'icône étincelles dans la barre du haut) et peut y connecter un assistant. L'assistant ne peut faire que ce que le compte de cette personne permet. ## Ce qui se passe quand un réglage est désactivé ### API REST désactivée - L'API répond `404` [endpoint-not-found](https://developers.plnnrly.com/en/docs/api/v2/guides/errors/#endpoint-not-found) à chaque requête vers `/api/v2`, avec le détail « The REST API is not enabled for this organisation. », y compris aux requêtes envoyées avec un token qui existe déjà. - Les applications ne peuvent plus identifier les utilisateurs via OAuth. - **Accès API** disparaît du menu utilisateur : plus personne ne peut créer, renouveler ou révoquer de tokens. - MCP est désactivé lui aussi. Réactiver l'API REST ne réactive pas MCP. - Les tokens existants sont conservés. Ils fonctionnent de nouveau dès que l'API REST est réactivée, sauf s'ils ont expiré entre-temps. ### MCP désactivé - Les assistants IA connectés reçoivent `404` avec le message « The MCP server is not enabled for this organisation. » - Aucun assistant IA ne peut s'identifier pour se connecter. - Le panneau **IA** disparaît de la barre du haut. ## Qui peut créer des tokens et connecter des applications Le droit nécessaire est **Gérer les tokens API**. Une personne qui le détient peut : - ouvrir **Accès API** dans le menu utilisateur, puis créer, renouveler et révoquer ses propres tokens API - connecter une application à l'API REST en s'identifiant via OAuth Dans une nouvelle organisation, le rôle **Admin** a ce droit d'emblée. Pour le donner à un autre rôle, ouvrez ce rôle dans **RH › Gestion des utilisateurs › Rôles**, allez dans l'onglet **Paramètres** et cochez **Gérer les tokens API** dans le groupe **Tokens API**. Quand vous retirez ce droit : - Les applications que la personne a connectées à l'API REST via OAuth sont refusées immédiatement, avec `403` [insufficient-permission](https://developers.plnnrly.com/en/docs/api/v2/guides/errors/#insufficient-permission). - Ses tokens API personnels continuent de fonctionner jusqu'à leur expiration. La personne ne peut plus ouvrir **Accès API** : elle ne peut donc plus voir, renouveler ni révoquer ces tokens. ## Les parties de plnnrly que votre organisation n'utilise pas La facturation et les itérations sont des parties optionnelles de plnnrly. Sans la facturation, chaque opération de facturation renvoie `404` [endpoint-not-found](https://developers.plnnrly.com/en/docs/api/v2/guides/errors/#endpoint-not-found). Sans les itérations, les opérations des flux de travail, des statuts et des transitions de flux de travail, des types de travail et des étiquettes renvoient elles aussi `404`. Les itérations et les éléments de travail eux-mêmes restent toujours disponibles. La requête de [découverte (en anglais)](https://developers.plnnrly.com/en/docs/api/v2/discovery/) laisse de côté ce que votre organisation n'a pas. [Comment les données s'articulent (en anglais)](https://developers.plnnrly.com/en/docs/api/v2/guides/data-model/#optional-areas) liste les ressources de chaque partie. ## Votre propre domaine Si votre organisation utilise son propre domaine, utilisez exactement ce domaine pour l'API REST et pour MCP. L'API REST répond `404` sur toute autre adresse. Dans plnnrly, le panneau **IA** affiche l'URL du serveur MCP sur votre domaine, et **Accès API** dans le menu utilisateur affiche l'URL de base de l'API REST. ## Quand plnnrly est indisponible Pendant qu'une organisation est en cours de mise en place, suspendue ou archivée, l'API REST répond `503` [tenant-unavailable](https://developers.plnnrly.com/en/docs/api/v2/guides/errors/#tenant-unavailable), et le serveur MCP répond `503` lui aussi. Les deux fonctionnent de nouveau dès que l'organisation est active. Si cela dure, contactez le [support plnnrly](https://www.plnnrly.com/fr/support). ## Voir aussi - [Présentation de MCP](https://developers.plnnrly.com/fr/docs/mcp/) - [Droits et sécurité](https://developers.plnnrly.com/fr/docs/mcp/permissions-and-safety/) - [Tokens API (en anglais)](https://developers.plnnrly.com/en/docs/api/v2/guides/tokens/) - [Authentification (en anglais)](https://developers.plnnrly.com/en/docs/api/v2/guides/authentication/)