Dépanner la connexion d'un assistant IA

À la fin de cette page, vous saurez identifier pourquoi un assistant ne se connecte pas ou pourquoi une demande échoue, et quoi faire. Les messages sont classés par moment : pendant l’autorisation, à l’appel d’un outil, puis dans la réponse d’un outil.

Avant tout : trois vérifications

L’adresse saisie dans l’assistant est exactement https://mcp.synkriaops.com/mcp, avec /mcp à la fin.
La page Paramètres → Assistants IA et MCP ne signale pas « L’accès machine n’est pas ouvert sur ce compte ».
L’accès figure dans Applications connectées ou Agents et automatisations avec le statut Actif.

Pendant l’autorisation (écran SynkriaOps)

Message affiché	Cause	Solution
Connexion impossible : « Aucune demande de connexion en cours. Relancez le connecteur depuis l’application qui la demande. »	La page a été ouverte directement, ou rechargée après la fin de la demande	Relancez la connexion depuis l’assistant, pas depuis SynkriaOps
Connexion impossible : « Cette demande de connexion a expiré ou n’est plus valide. Relancez le connecteur. »	Plus de 10 minutes entre l’ouverture de la page et votre choix	Relancez la connexion depuis l’assistant et validez sans attendre
« Seul le super-administrateur de la société peut connecter un assistant IA. Demandez-lui de le faire, ou de vous en donner la possibilité. »	L’administrateur n’a pas autorisé les collaborateurs	Demandez à l’administrateur de vous ajouter dans Qui peut connecter un assistant ? (marche à suivre)
« Vous n’avez accès à aucune société ni cabinet actif. Contactez votre administrateur. »	Aucune société où vous pouvez connecter un assistant	Vérifiez votre rôle et l’accès machine avec l’administrateur
« Aucun dossier n’est accessible pour vous : l’assistant ne pourrait rien consulter. »	Accès de cabinet sans dossier qui vous soit ouvert	Faites-vous affecter à des dossiers dans l’espace cabinet
Une permission attendue n’apparaît pas dans la liste	Votre abonnement, votre rôle ou votre palier ne l’inclut pas (une note indique combien de permissions sont masquées)	Voyez avec l’administrateur le palier ou l’abonnement

À l’appel d’un outil

Message renvoyé à l’assistant	Cause	Solution
`Invalid, expired or revoked MCP token.`	L’accès a expiré (90 jours pour une connexion par navigateur), a été révoqué, ou l’accès machine a été fermé	Reconnectez l’assistant ; pour une clé d’agent, créez-en une nouvelle
`MCP token audience is invalid for this resource.`	Clé créée à la main avec l’usage Agent IA avant le 10 novembre 2026	Créez une nouvelle clé, puis révoquez l’ancienne
L’assistant dit ne pas disposer de l’outil demandé	Le droit correspondant n’a pas été accordé : l’outil n’est pas proposé à l’assistant	Reconnectez l’assistant en cochant ce droit (ou renouvelez la clé avec ce droit)
Appels refusés pendant une minute	Plus de 120 appels par minute sur cet accès	Attendez une minute ; si cela se répète, demandez à l’assistant de regrouper ses demandes

Dans la réponse d’un outil

Quand une demande atteint SynkriaOps mais ne peut pas aboutir, l’outil renvoie un code et un message. Les plus fréquents :

Code	Signification	Solution
`VALIDATION_ERROR`	Une donnée envoyée est incomplète ou mal formée ; le message indique le champ	Précisez la demande à l’assistant (date, montant, compte)
`RESOURCE_NOT_FOUND`	L’élément n’existe pas, ou n’appartient pas à la société de l’accès	Vérifiez le numéro ou le dossier visé
`STATE_CONFLICT`	L’élément n’est plus dans un état qui permet l’action (pièce déjà validée, facture déjà payée…)	Consultez l’élément dans l’application
`FISCAL_YEAR_NOT_FOUND`	Aucun exercice ne couvre la date	Ouvrez l’exercice dans l’application, ou corrigez la date
`CONTACT_DUPLICATE_NAME`, `CONTACT_DUPLICATE_TAXPAYER_NUMBER`, `CONTACT_DUPLICATE_RCCM_NUMBER`	Un tiers porte déjà ce nom, ce NIU ou ce RCCM	Utilisez le tiers existant
`HEAD_OFFICE_SCOPE_REQUIRED`	Opération réservée au siège, alors que l’accès ne couvre pas toutes les agences	Reconnectez l’assistant avec toutes les agences, ou faites l’opération dans l’application
`BUDGET_BLOCKED`, `BUDGET_LINE_ALLOCATION_REQUIRED`, `BUDGET_APPROVAL_CIRCUIT_MISSING`	La politique budgétaire bloque ou suspend l’opération	Voyez avec le responsable du budget
`TENANT_SUSPENDED`, `TENANT_CANCELLED`, `TENANT_ARCHIVED`	La société est suspendue, résiliée ou archivée	Régularisez l’abonnement ou contactez le support
`IDEMPOTENCY_KEY_REUSED`	L’assistant a réutilisé l’identifiant d’une demande précédente avec un contenu différent	Demandez à l’assistant de recommencer l’opération comme une nouvelle demande

Toujours bloqué ?

Contactez le support en indiquant : l’assistant utilisé, l’heure de l’erreur, le message exact et le nom de l’accès tel qu’il apparaît dans Paramètres → Assistants IA et MCP. Ne transmettez jamais une clé d’agent : le support n’en a pas besoin. Voir Contacter le support.