Outils MCP Standard

Le serveur Standard expose des outils conçus pour des tâches précises, plutôt que de reprendre un à un chaque endpoint REST.

Outils de compte et d’utilisation

Outil de commentaires

Utilisez send_feedback une fois le problème clairement établi. Indiquez le contexte, ce qui s’est passé et ce qui aurait dû se passer. Si vous les connaissez, précisez l’action concernée, le modèle d’IA et l’environnement de l’agent. N’incluez pas de clés API, de jetons, d’URL signées ni le contenu intégral des fichiers. Cette opération ne coûte aucun crédit et ne modifie aucune traduction.

Les outils de compte et d’utilisation sont en lecture seule et ne consomment aucun crédit.

Outils de 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' afin de recevoir le texte traduit dans la réponse de l’outil. update_batch ne modifie que les métadonnées de gestion courante. L’archivage est réversible.

Outils de traduction de contenu

Ces outils font la différence entre un agent qui consulte votre espace de travail et un agent qui peut effectuer le travail. La séquence est fixe (création, planification, approbation), et seule la troisième étape entraîne des frais.

Envoyer 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 avec le nom de fichier seul dans filename et la valeur exacte de size_bytes.
2. Envoyez les octets d’origine à upload_url, en utilisant la method et les headers renvoyés. L’en-tête Authorization est un secret temporaire réservé au téléversement. Ne le remplacez jamais par une clé API d’espace de travail ou un jeton OAuth, ne suivez pas les redirections, ne le consignez pas et ne le montrez pas à l’utilisateur.
3. Une fois le téléversement réussi, appelez create_translation avec upload_id et, éventuellement, instruction, sur la même connexion AI Glot. Un seul des paramètres upload_id, content et file_url est accepté. Avec upload_id, omettez filename.
4. Vérifiez le plan confirmé et plan.not_included, puis vérifiez que l’utilisateur a autorisé ce plan et son coût en crédits avant d’appeler approve_translation.

Le secret de téléversement autorise une seule tentative de requête PUT dans les 10 minutes. Créez la traduction dans l’heure. Si la réponse à la requête PUT est perdue, essayez d’abord d’appeler create_translation avec le même upload_id. Si aucun téléversement complet n’existe, obtenez une nouvelle session. Répéter la création permet de récupérer la même traduction et n’applique jamais implicitement une instruction modifiée. Utilisez plan_translation pour l’affiner. La récupération par upload_id est disponible jusqu’au nettoyage de la session, au moins 24 heures après son émission. Conservez l’identifiant 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 l’interface en ligne de commande AI Glot ou fournissez un lien de téléchargement HTTPS accessible à AI Glot. » Ne prétendez pas que le document a été téléversé, ne demandez pas la clé API de l’utilisateur 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 être transmis avec file_url. Les petits fichiers texte peuvent être transmis tels quels avec content. Consultez la documentation sur les téléversements temporaires pour connaître les règles relatives aux requêtes HTTP et à la récupération.

Outils de glossaire

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 des glossaires sont marqués comme destructifs, car ils peuvent supprimer des termes. Les clients compatibles peuvent donc demander une confirmation.

Ressource des langues

Les langues prises en charge sont accessibles via la ressource MCP mise en cache :

aiglot://languages

Cette information statique de référence est exposée sous forme de ressource. Consultez-la avant de créer un glossaire pour une paire de langues.

Résultats des outils et erreurs

Chaque outil déclare un schéma d’entrée et renvoie un 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, avec un code stable et une URL de documentation. Le modèle peut ainsi corriger la requête au lieu de traiter une erreur métier comme une défaillance de la connexion MCP.