Outils MCP Standard
Découvrez les 18 outils MCP d’AI Glot conçus pour des tâches précises, les autorisations requises, leurs effets secondaires et la ressource des langues prises en charge.
Le serveur standard propose des outils conçus pour des tâches précises, plutôt que de reprendre chaque endpoint REST à l’identique.
Outils de compte et d’utilisation
| Outil | Autorisation | Fonction |
|---|---|---|
get_account | account:read | Consulte l’espace de travail, l’offre, les crédits, les limites et les fonctionnalités |
get_credit_balance | account:read | Consulte le solde et chaque attribution de crédits |
get_usage | usage:read | Consulte l’évolution des crédits, des mots et des traductions terminées |
Outil de commentaires
| Outil | Autorisation | Fonction |
|---|---|---|
send_feedback | Aucune, hormis l’authentification | Enregistre un commentaire libre sur un résultat inattendu, un comportement déroutant ou une fonctionnalité qui ne répond pas à vos attentes |
Utilisez send_feedback une fois le problème clairement identifié. Décrivez la situation, ce qui s’est passé et ce qui aurait dû se passer. Si vous les connaissez, indiquez l’action concernée, le modèle d’IA et l’environnement de l’agent. N’incluez ni clés API, ni jetons, ni URL signées, ni contenu intégral de fichiers. Cet outil ne coûte aucun crédit et ne modifie pas les traductions.
Les outils de compte et d’utilisation sont en lecture seule et ne consomment aucun crédit.
Outils de traduction
| Outil | Autorisation | Fonction |
|---|---|---|
list_batches | batches:read | Répertorie les traductions existantes avec une pagination par curseur |
get_batch | batches:read | Consulte une traduction, son avancement et son plan de révision actuel |
show_translation | batches:read | Affiche la révision interactive dans les hôtes compatibles avec MCP Apps |
get_batch_result_link | batches:read | Fournit un lien de téléchargement valable 30 minutes pour un résultat terminé |
update_batch | batches:write | Renomme, archive ou restaure une traduction |
Par défaut, l’outil de lien de résultat fournit une URL de téléchargement temporaire. Pour les formats texte de moins de 2 MB, transmettez format: 'content' pour recevoir le texte traduit dans la réponse de l’outil. update_batch ne modifie que les métadonnées de gestion, et l’archivage est réversible.
Outils de traduction
| Outil | Autorisation | Fonction |
|---|---|---|
create_upload_url | batches:create | Fournit une URL temporaire et des en-têtes pour un fichier local. Nécessite un client HTTP externe. Ne coûte rien. |
create_translation | batches:create | Crée une traduction à partir d’un fichier. Ne coûte rien. |
plan_translation | batches:create | Définit ou précise en langage naturel les éléments à traduire. Ne coûte rien. |
approve_translation | batches:create | Dépense des crédits et lance la traduction |
cancel_translation | batches:write | Arrête une traduction en cours ; le travail déjà effectué est facturé |
Ces outils font la différence entre un agent qui consulte votre espace de travail et un agent qui peut y effectuer des tâches. L’ordre est imposé (création, planification, approbation), et seule la troisième étape coûte quelque chose.
Révision interactive avec MCP Apps

Après avoir créé ou sélectionné un lot, appelez show_translation avec son
batch_id. Les hôtes compatibles peuvent afficher le fichier, le plan, le
contenu inclus ou exclu, les tarifs Standard/Lite calculés, le solde de l’espace
de travail, l’avancement et le résultat. Les autres clients reçoivent les
données structurées habituelles du lot et peuvent continuer à utiliser les
outils existants.
L’affichage consulte et approuve les traductions via la même connexion MCP
authentifiée. L’affichage et l’actualisation ne coûtent aucun crédit.
L’approbation nécessite batches:create, un plan vérifié à jour, un niveau de
qualité auquel l’utilisateur a droit et un nombre de crédits suffisant. Des
consignes personnalisées non vides nécessitent entitlements.custom_guidelines ;
la limite est de 2 000 caractères. L’utilisateur doit accepter toutes les
exclusions répertoriées avant de lancer la traduction depuis l’affichage.
create_translation (avec une consigne), plan_translation et get_batch
renvoient plan_revision lorsqu’un plan peut être révisé. Transmettez cette
valeur dans expected_plan_revision à approve_translation : ce champ est
obligatoire et lie l’approbation au plan que l’utilisateur a consulté. Si le plan
a changé depuis, plan_changed bloque le lancement. Consultez le nouveau périmètre
et le nouveau tarif, puis présentez-les à nouveau à l’utilisateur. L’approbation
via REST accepte le même champ et fonctionne toujours sans celui-ci, mais la
vérification est alors ignorée.
L’affichage actualise les tâches en cours en attendant un délai limité et ne propose le téléchargement qu’une fois la tâche terminée. Un échantillon est clairement indiqué comme tel. L’absence d’un fichier conservé, ou son expiration, reste signalée explicitement comme une erreur ; l’actualisation ne peut pas récupérer des données supprimées. Ne présumez pas qu’un hôte dispose d’une interface utilisateur s’il ne prend pas en charge MCP Apps. L’application web AI Glot reste une solution de repli.
Envoi d’un document local
Le client MCP doit pouvoir lire les octets du fichier d’origine et envoyer une requête HTTP PUT en dehors de MCP. Connecter un assistant à AI Glot ne lui donne pas automatiquement accès aux pièces jointes ni à un client HTTP. AI Glot Code Mode ne peut pas effectuer ce transfert lui-même.
- Appelez
create_upload_urlen indiquant le nom de fichier seul dansfilenameet la valeur exacte desize_bytes. - Envoyez les octets d’origine à
upload_urlavec lamethodet lesheadersrenvoyés. L’en-têteAuthorizationest un secret temporaire réservé à l’envoi du fichier. Ne le remplacez jamais par une clé API d’espace de travail ou un jeton OAuth, ne suivez pas les redirections, ne l’inscrivez pas dans des journaux et ne le montrez pas à l’utilisateur. - Une fois l’envoi terminé, appelez
create_translationavecupload_idet, éventuellement,instruction, sur la même connexion AI Glot. Un seul des champsupload_id,contentetfile_urlest accepté. N’indiquez pasfilenameavecupload_id. - Vérifiez le plan et
plan.not_included, puis assurez-vous que l’utilisateur a autorisé ce plan et son coût en crédits avant d’appelerapprove_translation.
Le secret d’envoi permet une seule tentative PUT dans les 10 minutes. Créez la traduction dans un délai d’une heure. Si la réponse à une requête PUT est perdue, essayez d’abord create_translation avec le même upload_id. Si aucun envoi complet n’existe, obtenez une nouvelle session. Répéter la création permet de récupérer la même traduction et ne modifie jamais implicitement une consigne ; utilisez plan_translation pour la préciser. La récupération par upload_id est possible jusqu’au nettoyage de la session, au moins 24 heures après son émission. Conservez l’ID du lot pour retrouver ensuite la traduction dans votre historique.
Si l’environnement d’exécution ne peut pas lire la pièce jointe locale ou envoyer des requêtes HTTP PUT, expliquez immédiatement cette limite. Par exemple : « Cet assistant peut se connecter à AI Glot, mais ne peut pas envoyer cette pièce jointe locale. Téléversez le document dans l’application web AI Glot, utilisez la CLI AI Glot ou fournissez un lien de téléchargement HTTPS accessible à AI Glot. » Ne prétendez pas que le document a été envoyé, ne demandez pas à l’utilisateur sa clé API et n’approuvez pas de traduction sans fichier ni plan vérifiés.
Un document déjà hébergé à une URL de téléchargement HTTPS accessible peut toujours être transmis avec file_url. Le contenu de petits fichiers texte peut être fourni tel quel dans content. Consultez les envois temporaires pour connaître le fonctionnement des requêtes HTTP et les règles de récupération.
Outils de glossaire
| Outil | Autorisation | Fonction |
|---|---|---|
list_glossaries | glossaries:read | Répertorie les paires de langues, le nombre de termes et les limites de l’offre |
get_glossary | glossaries:read | Consulte tous les termes d’un glossaire |
edit_glossary_terms | glossaries:write | Crée un glossaire s’il n’existe pas, puis ajoute, modifie, supprime ou remplace entièrement ses termes |
delete_glossary | glossaries:write | Supprime définitivement un glossaire et tous ses termes |
Par défaut, edit_glossary_terms ajoute des termes. replace_all: true supprime tous les termes absents de la liste fournie. Les deux outils de modification du glossaire sont signalés comme destructifs, car ils peuvent supprimer des termes ; les clients compatibles peuvent donc exiger une confirmation.
Ressource des langues
Les langues prises en charge sont disponibles sous forme de ressource MCP pouvant être mise en cache :
aiglot://languagesCette donnée de référence statique est exposée comme une ressource. Consultez-la avant de créer un glossaire pour une paire de langues.
Résultats et erreurs des outils
Chaque outil déclare un schéma d’entrée et renvoie du contenu structuré ainsi qu’une représentation textuelle lisible. Le serveur standard ne déclare pas de schémas de sortie distincts. Les erreurs sont renvoyées sous forme de résultats lisibles, accompagnés d’un code stable et d’une URL de documentation. Le modèle peut ainsi corriger la requête au lieu de traiter une erreur métier comme une panne de la connexion MCP.
Copiez ce texte dans un assistant compatible MCP après avoir connecté AI Glot.
Examine mon compte AI Glot, mon solde de crédits et mon utilisation des 30 derniers jours. Répertorie ensuite les traductions récentes ayant échoué ou toujours en cours, explique tout élément inhabituel et ne modifie ni n’archive aucune donnée.