Dépannage
Dépannage MCP
Corrigez les problèmes courants du serveur MCP Emailit, de la connexion et des portées manquantes aux mauvais espaces de travail, aux outils réservés au rôle Admin et aux clients qui chargent trop d’outils.
Commencez par demander à votre assistant « À quel espace de travail Emailit suis-je connecté ? ». Il appelle get-current-workspace et vous indique l’espace de travail, votre rôle et l’accès accordé, ce qui explique la plupart des problèmes ci-dessous.
La page de connexion indique que le client est inconnu
L’enregistrement du client est obsolète. Retirez le serveur Emailit de votre outil d’IA et ajoutez-le de nouveau pour qu’il enregistre un nouveau client.
Un outil indique qu’il a besoin d’un accès complet
La connexion a été approuvée avec la seule portée sending. Les clients qui prennent en charge l’autorisation renforcée (step-up), comme ChatGPT, affichent de nouveau l’écran d’autorisation : approuvez l’accès full. Avec les autres clients, révoquez la connexion sous AccountConnected apps, reconnectez-vous et approuvez l’accès complet. Avec une clé API, utilisez une clé Full Access.
Les modifications ont lieu dans le mauvais espace de travail
Nommez l’espace de travail dans votre demande, par exemple « Dans Marketing, listez les domaines », ou demandez à l’assistant de changer d’espace de travail : « Passez à mon espace de travail Marketing ». Les clés API agissent toujours sur l’espace de travail auquel elles appartiennent.
Un espace de travail manque
La connexion ne couvre que les espaces de travail que vous avez autorisés. Ouvrez AccountConnected apps, choisissez Edit access et ajoutez-le, ou choisissez All workspaces. Si vous avez été retiré de l’espace de travail, demandez à un administrateur de vous inviter de nouveau.
Un outil indique qu’il a besoin du rôle Admin
L’erreur admin_role_required signifie que vous avez le rôle Member dans cet espace de travail et que l’outil gère des clés API ou supprime un domaine. Demandez à un administrateur de l’espace de travail de le faire ou de modifier votre rôle.
Le client affiche trop d’outils ou ne parvient pas à les charger
Certains clients plafonnent le nombre d’outils. Ne chargez que ce dont vous avez besoin avec ?toolsets= dans l’URL du serveur ou l’en-tête X-MCP-Toolsets, par exemple https://api.emailit.com/mcp?toolsets=emails,domains. Consultez Groupes d’outils et mode lecture seule.
Un e-mail est rejeté
L’expéditeur doit utiliser un domaine d’envoi vérifié. Demandez à l’assistant de contrôler le domaine avec get-domain, de publier les enregistrements manquants et d’exécuter verify-domain. Tant que votre espace de travail n’a pas l’accès production, vous ne pouvez envoyer qu’aux adresses e-mail des comptes des membres de l’espace de travail.
La relance échoue
Seuls les e-mails qui ont rebondi, en échec, bloqués ou retenus peuvent être relancés, dans un délai de 30 jours et tant que leur contenu est encore stocké. Consultez Relancer et transférer.
Le client affiche « Method not allowed »
Le serveur est sans état et n’accepte que les requêtes POST. Mettez à jour votre client vers une version qui prend en charge le transport Streamable HTTP, ou utilisez le serveur local via stdio.
Le client vous demande sans cesse de vous connecter
Le jeton d’actualisation a expiré après 60 jours sans utilisation ou a été réutilisé, ou la connexion a été révoquée. Reconnectez-vous depuis le client. Si cela se reproduit, assurez-vous qu’une seule copie du client utilise la connexion à la fois.
Le problème persiste ?
Posez votre question sur Discord ou écrivez à support@emailit.com en indiquant le nom du client, l’outil qui a échoué et le texte de l’erreur.