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

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 :

Relancez la connexion depuis votre application d'IA. Dans Claude Code, tapez /mcp, choisissez la connexion Metaintro et reconnectez-vous.
Assurez-vous de vous connecter au compte Metaintro que l'agent doit utiliser.
Sur la page Metaintro qui s'ouvre, sélectionnez Autoriser. Si vous voyez « Ce lien a expiré », revenez à votre application d'IA et recommencez.
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, 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.

« 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.

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

Rendez-vous dans Paramètres > Agents IA, ou dans l'onglet Mes agents IA des paramètres de votre organisation.
Trouvez l'agent sous Agents que vous avez connectés et sélectionnez son bouton de suppression (corbeille).
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 :

Appelez whoami. S'il fonctionne, la connexion est bonne. Notez de quelle connexion il s'agit et le réglage d'approbation.
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.
Si une modification est refusée pour insufficient scope, la connexion est en Lecture seule. Prévenez la personne et ne réessayez pas.
Si on vous demande de réessayer dans quelques secondes, attendez ce délai avant l'appel suivant.
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 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é.