AI Glot websiteOpen AI Glot
Exploiter AI GlotOutils MCP Standard
Exploiter AI Glot

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

OutilAutorisationFonction
get_accountaccount:readConsulte l’espace de travail, l’offre, les crédits, les limites et les fonctionnalités
get_credit_balanceaccount:readConsulte le solde et chaque attribution de crédits
get_usageusage:readConsulte l’évolution des crédits, des mots et des traductions terminées

Outil de commentaires

OutilAutorisationFonction
send_feedbackAucune, hormis l’authentificationEnregistre 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

OutilAutorisationFonction
list_batchesbatches:readRépertorie les traductions existantes avec une pagination par curseur
get_batchbatches:readConsulte une traduction, son avancement et son plan de révision actuel
show_translationbatches:readAffiche la révision interactive dans les hôtes compatibles avec MCP Apps
get_batch_result_linkbatches:readFournit un lien de téléchargement valable 30 minutes pour un résultat terminé
update_batchbatches:writeRenomme, 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

OutilAutorisationFonction
create_upload_urlbatches:createFournit une URL temporaire et des en-têtes pour un fichier local. Nécessite un client HTTP externe. Ne coûte rien.
create_translationbatches:createCrée une traduction à partir d’un fichier. Ne coûte rien.
plan_translationbatches:createDéfinit ou précise en langage naturel les éléments à traduire. Ne coûte rien.
approve_translationbatches:createDépense des crédits et lance la traduction
cancel_translationbatches:writeArrê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

Révision de la traduction AI Glot ouverte dans un chat : le fichier, le plan et les éléments qui restent inchangés, affichés par un hôte MCP Apps

La fiche de révision qu’un hôte MCP Apps affiche dans la conversation

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.

  1. Appelez create_upload_url en indiquant le nom de fichier seul dans filename et la valeur exacte de size_bytes.
  2. Envoyez les octets d’origine à upload_url avec la method et les headers renvoyés. L’en-tête Authorization est 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.
  3. Une fois l’envoi terminé, appelez create_translation avec upload_id et, éventuellement, instruction, sur la même connexion AI Glot. Un seul des champs upload_id, content et file_url est accepté. N’indiquez pas filename avec upload_id.
  4. 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’appeler approve_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

OutilAutorisationFonction
list_glossariesglossaries:readRépertorie les paires de langues, le nombre de termes et les limites de l’offre
get_glossaryglossaries:readConsulte tous les termes d’un glossaire
edit_glossary_termsglossaries:writeCrée un glossaire s’il n’existe pas, puis ajoute, modifie, supprime ou remplace entièrement ses termes
delete_glossaryglossaries:writeSupprime 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://languages

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

Auditer mon utilisation récente des traductions

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.

Use these docs with your AI tools

An AI agent can read this documentation directly. You do not need an account or an API key. Everything here is public and read-only.

Query these docs via MCP

Recommended

Add this server to Claude, Claude Code, Cursor, Mistral, or any tool that supports MCP. Your agent can then search AI Glot Docs documentation and read it in full, instead of answering from memory.

https://ai-glot.com/docs/mcp
  • searchFind the passages that answer a question.
  • fetchRead one page in full, as Markdown.
  • list_pagesSee every page in this documentation.

Query these docs over HTTP

The same tools also work as plain web requests. Use this for scripts, or for any tool that does not support MCP. There is one endpoint per tool. Arguments go in the query string, and the answer comes back as JSON.

https://ai-glot.com/docs/api/docs/search?query=custom+domain

Read the OpenAPI description. It is built from the same definitions as the tools, so it always matches what the endpoints do.

Read these docs as Markdown

Add .md to any page URL to get its Markdown source. You can also send the headerAccept: text/markdown to the page URL itself.

To read the whole documentation in one file, open llms-full.txt. For a short index of every page, open llms.txt.