# Dépannage

Que faire quand un client IA ne parvient pas à se connecter à plnnrly ou à s'identifier, ou quand une requête est refusée.

Trouvez le message ou le comportement que vous constatez, puis appliquez la solution. Les messages de plnnrly sont cités tels quels, en anglais. Quelques-uns peuvent s'afficher dans une autre langue, comme le néerlandais ou la langue dans laquelle vous utilisez plnnrly : leur version française est indiquée à côté.

## Connexion et identification

| Ce que vous voyez                                                                                                                                      | Pourquoi                                                                                                                                        | Que faire                                                                                                                                     |
| ------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| « The MCP server is not enabled for this organisation. » (`404`)                                                                                       | MCP est désactivé pour votre organisation. Les nouvelles organisations démarrent avec MCP désactivé. Désactiver l'API REST désactive aussi MCP. | Demandez à un administrateur de l'activer ; voir [Pour les administrateurs](https://developers.plnnrly.com/fr/docs/administration/).          |
| « OAuth is not available for this organisation. » (`404`) pendant l'identification                                                                     | L'API REST est désactivée : aucune application ne peut s'identifier.                                                                            | Adressez-vous à un administrateur ; voir [Pour les administrateurs](https://developers.plnnrly.com/fr/docs/administration/).                  |
| Le client ne trouve pas le serveur, ou la page d'identification affiche `404`                                                                          | L'URL du serveur est fausse, ou MCP est désactivé.                                                                                              | Copiez l'URL du serveur depuis le panneau **IA** (l'icône étincelles dans la barre du haut). Si ce panneau n'apparaît pas, MCP est désactivé. |
| Le client signale `invalid_redirect_uri`                                                                                                               | Le client ne peut pas encore s'identifier sur plnnrly.                                                                                          | Voir [Autres clients](https://developers.plnnrly.com/fr/docs/mcp/install/other-clients/).                                                     |
| « Your role does not allow connecting apps to the REST API. » (en français : « Votre rôle ne permet pas de connecter des applications à l’API REST. ») | L'application a aussi demandé un accès à l'API REST, et votre rôle n'a pas le droit **Gérer les tokens API**.                                   | Demandez ce droit à un administrateur, ou utilisez un client qui ne demande que MCP.                                                          |
| L'identification est refusée (`403`) alors que vous travaillez dans une session de support                                                             | Les sessions de support ne peuvent pas connecter d'application.                                                                                 | Identifiez-vous avec votre propre compte.                                                                                                     |
| « This organization's access has been suspended. » (en français : « L'accès de cette organisation a été suspendu. ») (`503`)                           | Votre organisation est suspendue.                                                                                                               | Contactez votre administrateur.                                                                                                               |
| « This organization is currently unavailable. » (en français : « Cette organisation est actuellement indisponible. ») (`503`)                          | Votre organisation est en cours de mise en place, ou elle est archivée.                                                                         | Contactez votre administrateur ou le [support plnnrly](https://www.plnnrly.com/fr/support).                                                   |
| Le client vous demande de vous identifier à nouveau                                                                                                    | Il n'a pas été utilisé depuis 30 jours, ou quelqu'un l'a déconnecté.                                                                            | Identifiez-vous à nouveau.                                                                                                                    |

## Utilisation des outils

| Ce que vous voyez                                                                                                         | Pourquoi                                                                                                            | Que faire                                                                                                                                                      |
| ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| « Too Many Attempts. » (`429`)                                                                                            | Vous avez envoyé plus de 60 requêtes MCP en une minute, tous les clients IA que vous avez connectés confondus.      | Attendez une minute, puis demandez moins de choses à la fois.                                                                                                  |
| La réponse contient `meta.mcp_truncated`                                                                                  | La réponse dépassait la limite d'environ 30 000 caractères et a été raccourcie.                                     | Demandez moins de lignes, une question plus précise ou un seul champ. Voir [Réponses](https://developers.plnnrly.com/fr/docs/mcp/tools/#responses).            |
| Une suppression est refusée avec `forbidden-by-policy` et « This organisation does not allow AI clients to delete data. » | **Autoriser les actions destructives** est désactivé pour votre organisation.                                       | Voir [Droits et sécurité](https://developers.plnnrly.com/fr/docs/mcp/permissions-and-safety/). Seul un administrateur peut l'activer.                          |
| Une modification est refusée avec `forbidden-by-policy` et un autre message                                               | Votre rôle, ou l'enregistrement lui-même, ne permet pas cette modification. Le message explique pourquoi.           | Vérifiez dans plnnrly si vous pouvez faire cette modification vous-même.                                                                                       |
| Une suppression ou un écrasement est refusé avec `validation-failed` sur `confirm`                                        | Vous ne l'avez pas encore confirmé.                                                                                 | Dites à l'assistant que vous êtes d'accord, pour qu'il renvoie l'appel avec votre confirmation.                                                                |
| Un envoi de fichier est refusé avec `endpoint-not-found`                                                                  | Les fichiers ne peuvent pas être envoyés via MCP.                                                                   | Utilisez l'API REST avec un token API ; voir [Fichiers : envoi et téléchargement (en anglais)](https://developers.plnnrly.com/en/docs/api/v2/guides/uploads/). |
| Un enregistrement dont vous savez qu'il existe renvoie `404`                                                              | Vous n'avez pas le droit de le voir, ou il appartient à une partie de plnnrly que votre organisation n'utilise pas. | Vérifiez dans plnnrly si vous pouvez l'ouvrir. L'assistant voit exactement ce que vous voyez.                                                                  |
| L'application figure encore sous **Applications connectées** alors que vous l'avez retirée dans le client                 | Son identification reste valable jusqu'à 30 jours après sa dernière utilisation.                                    | Cliquez sur **Déconnecter** dans le panneau **IA**.                                                                                                            |

## Les outils n'apparaissent pas

Vérifiez d'abord le client lui-même :

- **claude.ai et Claude Desktop :** dans une conversation, cliquez sur **+**, choisissez **Connectors** et vérifiez que plnnrly est activé ; voir [claude.ai](https://developers.plnnrly.com/fr/docs/mcp/install/claude-ai/).
- **Claude Code :** exécutez `claude mcp list`, ou `/mcp` dans une session ; voir [Claude Code](https://developers.plnnrly.com/fr/docs/mcp/install/claude-code/).
- **ChatGPT :** vérifiez que le plugin est installé, puis tapez `@` et choisissez plnnrly ; voir [ChatGPT](https://developers.plnnrly.com/fr/docs/mcp/install/chatgpt/).
- **Cursor :** ouvrez le panneau **Output** et choisissez **MCP Logs** ; voir [Cursor](https://developers.plnnrly.com/fr/docs/mcp/install/cursor/).
- **Gemini CLI :** exécutez `/mcp` dans une session ; voir [Gemini CLI](https://developers.plnnrly.com/fr/docs/mcp/install/gemini/).

## Toujours bloqué ?

Contactez le [support plnnrly](https://www.plnnrly.com/fr/support). Si plnnrly a répondu par une erreur, indiquez son `request_id`.
