---
title: "Résoudre les problèmes de connexion d'agents IA | Metaintro"
canonical: "https://www.metaintro.com/fr/help/ai-agent-troubleshooting"
language: "fr"
author: "Metaintro"
published: "2026-10-20T20:26:12.823Z"
modified: "2026-10-20T21:50:14.285Z"
---

# Résoudre les problèmes de connexion d'agents IA

Résolvez les problèmes courants de connexion d'un agent IA à Metaintro: connexion, accès en lecture seule, accès à une organisation, limites et échecs.

Dernière mise à jour: October 20, 2026[Dépannage](/fr/help/category/troubleshooting)

Collez-le dans Claude, ChatGPT, Codex, Cursor ou Pi.

## L'agent n'arrive pas à se connecter

Si votre application d'IA affiche une erreur de connexion ou vous demande sans cesse de vous connecter:

1. Relancez la connexion depuis votre application d'IA. Dans Claude Code, tapez `/mcp`, choisissez la connexion Metaintro et reconnectez-vous.
2. Assurez-vous de vous connecter au compte Metaintro que l'agent doit utiliser.
3. Sur la page Metaintro qui s'ouvre, sélectionnez **Autoriser**. Si vous voyez « Ce lien a expiré », revenez à votre application d'IA et recommencez.
4. Vérifiez l'adresse que vous avez ajoutée. Elle doit être exactement `https://www.metaintro.com/api/mcp`, ou `https://www.metaintro.com/api/mcp/org/<org-slug>` pour une organisation. **Premiers pas**, dans Paramètres > Agents IA ou dans l'onglet **Mes agents IA** des paramètres de votre organisation, affiche la bonne adresse avec un bouton pour la copier.

Si vous vous êtes connecté avec une clé personnelle, l'agent peut afficher: « Sign in through your AI client, or send a Metaintro personal API key… ». Cela signifie que la clé est absente, mal saisie, expirée ou déconnectée. Les clés sont valables 90 jours. Dans [Paramètres > Agents IA](/settings/agents), ouvrez l'onglet **Autres applications** sous **Premiers pas**, sélectionnez **Créer une clé API**, puis mettez à jour la configuration de votre application.

Dans Codex, exécutez `codex mcp login metaintro`. Dans Pi, exécutez `pi mcp login metaintro`. Pour une organisation, utilisez le nom de sa connexion, par exemple `metaintro-<org-slug>`. Avec l'extension pi-mcp-adapter, connectez-vous plutôt dans Pi avec `/mcp-auth metaintro`. Pour savoir si l'application est connectée, exécutez `codex mcp list` ou `pi mcp list`.

## L'agent peut lire mais pas modifier

Si l'agent signale **insufficient scope**, ou indique qu'il ne peut pas faire de modifications, il est connecté en **Lecture seule**: la liste **Agents que vous avez connectés** affiche **Lecture seule** à côté de lui. Déconnectez-le et reconnectez-le. Avec une clé API, choisissez **Lire et agir** sous **Ce qu'il peut faire**. Lorsque vous vous connectez via votre application, vérifiez que la page Metaintro mentionne les modifications effectuées pour vous avant de sélectionner **Autoriser**.

Si le message indique « This credential cannot use the MCP server », la clé a été créée sans accès agent. Sélectionnez **Créer une clé API** dans l'onglet **Autres applications** de Paramètres > Agents IA, ou reconnectez-vous depuis votre application d'IA et autorisez l'accès.

## « Organization keys name no person to act as »

Les clés API d'organisation (`mi_org_…`) ne peuvent pas être utilisées avec des agents IA. Un agent agit toujours au nom d'une personne, afin que chaque modification soit enregistrée sous le nom de quelqu'un. Utilisez une clé personnelle depuis Paramètres > Agents IA, ou connectez-vous depuis votre application d'IA.

## « You aren't on this organization's staff »

La connexion d'une organisation (`/api/mcp/org/<org-slug>`) ne fonctionne que pour les personnes ayant un rôle dans l'équipe de cette organisation. Si vous voyez ce message:

- Vérifiez le nom de l'organisation dans l'adresse.
- Demandez à un administrateur de l'organisation si vous faites bien partie de l'équipe. Seuls les membres de l'équipe voient l'onglet **Mes agents IA** dans les paramètres de l'organisation.
- Pour votre propre recherche d'emploi, utilisez l'adresse personnelle `https://www.metaintro.com/api/mcp`.

## « This connection only reaches… »

La connexion de chaque organisation ne fonctionne que dans cette organisation. Si l'agent essaie de travailler avec une autre organisation, la demande est refusée. Ajoutez une connexion distincte depuis l'onglet **Mes agents IA** des paramètres de l'autre organisation.

## L'agent ne trouve pas les outils de conseiller

La connexion personnelle n'accède qu'à votre propre recherche d'emploi. Pour travailler avec les membres d'une organisation, connectez-vous à l'adresse de cette organisation. Consultez [Utiliser des agents IA en tant que conseiller](/help/ai-agents-for-case-managers).

## « Too many calls from this key. Try again in N seconds. »

Pour que Metaintro reste rapide pour tout le monde, chaque connexion est soumise à des limites par minute pour les lectures, les modifications, les demandes à Cabinet et les conversations avec l'assistant. Attendez le nombre de secondes indiqué, puis réessayez. Si cela se reproduit souvent, demandez à votre agent de faire des demandes moins nombreuses mais plus complètes.

Les messages « Too many requests » ou « Metaintro is temporarily unavailable » disparaissent généralement en moins d'une minute.

## Une action attend une approbation

Si l'agent indique qu'une action est **en attente d'approbation**, elle n'est pas bloquée. Approuvez-la ou refusez-la sous **En attente de votre approbation** dans Paramètres > Agents IA, ou dans l'onglet **Mes agents IA** des paramètres de votre organisation si elle est passée par la connexion de cette organisation. Les demandes expirent après 7 jours. Consultez [Approuver les actions de votre agent IA](/help/ai-agent-approvals).

## Une action a échoué après votre approbation

Si vous voyez « Approuvée, mais l'action a échoué », demandez à votre agent de vérifier la demande. Il peut lire la raison grâce à son outil de suivi des demandes (`get_action_request`). Raisons fréquentes:

- L'élément a été modifié entre-temps. Demandez à l'agent de le relire et de réessayer.
- L'agent a été déconnecté avant votre approbation: rien ne s'est exécuté.
- Vous n'avez plus accès à ce dont l'action avait besoin.

## L'agent indique qu'un élément a été modifié

Certaines modifications vérifient que l'agent dispose de la dernière version d'un élément. Si quelqu'un d'autre l'a modifié avant, la modification est refusée afin que rien ne soit écrasé. Demandez à l'agent de relire l'élément et de réessayer.

## Déconnecter ou reconnecter un agent

1. Rendez-vous dans [Paramètres > Agents IA](/settings/agents), ou dans l'onglet **Mes agents IA** des paramètres de votre organisation.
2. Trouvez l'agent sous **Agents que vous avez connectés** et sélectionnez son bouton de suppression (corbeille).
3. Confirmez avec **Déconnecter**.

Il cesse de fonctionner immédiatement, partout. Pour l'utiliser de nouveau, reconnectez-le depuis votre application d'IA.

## Pour les agents IA: vérifier la connexion

Procédez dans cet ordre:

1. Appelez `whoami`. S'il fonctionne, la connexion est bonne. Notez de quelle connexion il s'agit et le réglage d'approbation.
2. En cas d'erreur de connexion, demandez à la personne de se reconnecter (`/mcp` dans Claude Code, `codex mcp login metaintro` dans Codex, `pi mcp login metaintro` dans Pi (ou `/mcp-auth metaintro` dans Pi avec l'extension pi-mcp-adapter)). Vérifiez que l'adresse est exactement `https://www.metaintro.com/api/mcp`.
3. Si une modification est refusée pour **insufficient scope**, la connexion est en **Lecture seule**. Prévenez la personne et ne réessayez pas.
4. Si on vous demande de réessayer dans quelques secondes, attendez ce délai avant l'appel suivant.
5. Si une modification est refusée parce que l'enregistrement a changé, relisez-le et réessayez avec la nouvelle version.

## Toujours bloqué?

[Contactez-nous](/help/contact-us) en joignant le message d'erreur. S'il contient un identifiant de requête, indiquez-le aussi: cela nous aide à comprendre ce qui s'est passé.

### Cet article a-t-il été utile?

## Articles connexes

- [Sécurité et confidentialité des agents IACe qu'un agent IA connecté peut voir et faire sur Metaintro, la différence entre clés et connexion, et comment révoquer l'accès à tout moment.](/fr/help/ai-agent-security-and-privacy)
- [Approuver les actions de votre agent IAChoisissez quelles actions de vos agents attendent votre approbation, puis approuvez ou refusez les demandes de la liste En attente de votre approbation.](/fr/help/ai-agent-approvals)
- [Utiliser des agents IA en tant que conseillerConnectez un agent IA à une organisation pour qu'il vous aide dans votre suivi: relances, notes, points d'étape, tâches, listes d'offres et réponses.](/fr/help/ai-agents-for-case-managers)
- [Connecter un agent IA à MetaintroLaissez Claude, ChatGPT, Cursor ou un autre agent IA vous aider dans votre recherche d'emploi sur Metaintro, avec votre propre compte et vos autorisations.](/fr/help/connect-ai-agents-to-metaintro)

[Retour à la navigation](#main-navigation)