Standard-MCP-Tools
Hier erfahren Sie mehr über die 18 aufgabenorientierten AI Glot-MCP-Tools, ihre erforderlichen Berechtigungsbereiche, Nebenwirkungen und die Ressource für unterstützte Sprachen.
Der Standardserver stellt aufgabenorientierte Tools bereit, statt jeden REST-Endpunkt einzeln nachzubilden.
Konto- und Nutzungs-Tools
| Tool | Berechtigungsbereich | Funktion |
|---|---|---|
get_account | account:read | Liest Arbeitsbereich, Tarif, Guthaben, Limits und Funktionen aus |
get_credit_balance | account:read | Liest den Kontostand und alle Guthabenbuchungen aus |
get_usage | usage:read | Liest Guthaben, Wörter und abgeschlossene Übersetzungen im Zeitverlauf aus |
Feedback-Tool
| Tool | Berechtigungsbereich | Funktion |
|---|---|---|
send_feedback | Keine über die Authentifizierung hinaus | Erfasst Freitext-Feedback zu einem unerwarteten Ergebnis, einem verwirrenden Verhalten oder einer Funktion, die sich anders verhalten sollte |
Verwenden Sie send_feedback, sobald das Problem klar ist. Beschreiben Sie die Situation, was passiert ist und was hätte passieren sollen. Falls bekannt, nennen Sie die zugehörige Aktion, das AI-Modell und das Agent-Harness. Geben Sie keine API-Schlüssel, Tokens, signierten URLs oder vollständigen Datei-Inhalte an. Das Tool kostet keine Guthabenpunkte und ändert keine Übersetzung.
Konto- und Nutzungs-Tools sind schreibgeschützt und verbrauchen keine Guthabenpunkte.
Übersetzungs-Tools
| Tool | Berechtigungsbereich | Funktion |
|---|---|---|
list_batches | batches:read | Listet vorhandene Übersetzungen mit Cursor-Paginierung auf |
get_batch | batches:read | Liest eine Übersetzung, ihren Fortschritt und den aktuellen Prüfplan aus |
show_translation | batches:read | Zeigt die interaktive Prüfung in kompatiblen MCP-Apps-Hosts an |
get_batch_result_link | batches:read | Gibt einen 30 Minuten gültigen Download-Link für ein fertiges Ergebnis zurück |
update_batch | batches:write | Benennt eine Übersetzung um, archiviert sie oder stellt sie wieder her |
Das Tool für Ergebnislinks gibt standardmäßig eine temporäre Download-URL zurück. Bei Textformaten unter 2 MB können Sie format: 'content' übergeben, um den übersetzten Text direkt in der Tool-Antwort zu erhalten. update_batch ändert nur Verwaltungsmetadaten. Das Archivieren lässt sich rückgängig machen.
Tools zum Übersetzen
| Tool | Berechtigungsbereich | Funktion |
|---|---|---|
create_upload_url | batches:create | Gibt eine temporäre URL und Header für eine lokale Datei zurück. Erfordert einen externen HTTP-Client. Kostet nichts. |
create_translation | batches:create | Erstellt eine Übersetzung aus einer Datei. Kostet nichts. |
plan_translation | batches:create | Plant oder präzisiert in natürlicher Sprache, was übersetzt werden soll. Kostet nichts. |
approve_translation | batches:create | Verbraucht Guthabenpunkte und startet die Übersetzung |
cancel_translation | batches:write | Stoppt eine laufende Übersetzung; bereits geleistete Arbeit wird berechnet |
Diese Tools machen den Unterschied zwischen einem Agenten, der Ihren Arbeitsbereich nur ausliest, und einem, der Aufgaben darin erledigen kann. Die Reihenfolge ist festgelegt (erstellen, planen, freigeben), und nur der dritte Schritt kostet etwas.
Interaktive Prüfung mit MCP Apps

Rufen Sie nach dem Erstellen oder Auswählen eines Batches show_translation mit dessen
batch_id auf. Kompatible Hosts können die Datei, den Plan, einbezogene und ausgeschlossene
Inhalte, die berechneten Preise für Standard/Lite, den Kontostand des Arbeitsbereichs,
den Fortschritt und das Ergebnis anzeigen. Andere Clients erhalten gewöhnliche strukturierte
Batch-Daten und können die vorhandenen Tools weiterhin verwenden.
Die Ansicht liest Daten aus und gibt Übersetzungen über dieselbe authentifizierte MCP-Verbindung frei.
Anzeigen und Aktualisieren kostet keine Guthabenpunkte. Für die Freigabe sind batches:create,
ein aktueller, verifizierter Plan, eine freigeschaltete Qualitätsstufe und ausreichend Guthabenpunkte erforderlich.
Nicht leere benutzerdefinierte Richtlinien erfordern entitlements.custom_guidelines;
die Höchstlänge beträgt 2.000 Zeichen. Der Nutzer muss alle aufgeführten Ausschlüsse akzeptieren,
bevor er die Übersetzung über die Ansicht startet.
create_translation (mit einer Anweisung), plan_translation und get_batch
geben plan_revision zurück, solange ein prüfbarer Plan verfügbar ist. Übergeben Sie diesen Wert als
expected_plan_revision an approve_translation: Das Feld ist erforderlich und bindet
die Freigabe an den Plan, den der Nutzer geprüft hat. Wurde der Plan inzwischen geändert,
verhindert plan_changed den Start. Lesen Sie den neuen Umfang und Preis aus und zeigen Sie sie
erneut dem Nutzer. Bei der REST-Freigabe wird dasselbe Feld akzeptiert und die Funktion arbeitet
auch ohne es, allerdings wird dann diese Prüfung übersprungen.
Die Ansicht aktualisiert laufende Aufträge mit einer begrenzten Wartezeit und bietet den Download erst nach Abschluss an. Eine Vorschau ist als solche gekennzeichnet. Fehlt eine gespeicherte Datei oder ist sie abgelaufen, wird dies ausdrücklich als Fehler angezeigt. Durch Aktualisieren lassen sich keine gelöschten Daten wiederherstellen. Bei Hosts ohne MCP-Apps wird keine UI-Funktion vorausgesetzt. Die AI Glot-Web-App steht weiterhin als Alternative zur Verfügung.
Ein lokales Dokument senden
Der MCP-Client muss auf die Originaldaten der Datei zugreifen und außerhalb von MCP eine HTTP-PUT-Anfrage senden können. Wenn Sie einen Assistenten mit AI Glot verbinden, erhält er dadurch nicht automatisch Zugriff auf Anhänge oder einen HTTP-Client. AI Glot Code Mode kann diese Übertragung nicht selbst durchführen.
- Rufen Sie
create_upload_urlmit dem reinenfilenameund dem exakten Wert fürsize_bytesauf. - Senden Sie die Originaldaten mit der zurückgegebenen
methodund denheadersanupload_url. DerAuthorization-Header ist ein temporäres Geheimnis, das ausschließlich zum Hochladen dient. Ersetzen Sie ihn niemals durch einen API-Schlüssel des Arbeitsbereichs oder ein OAuth-Token, folgen Sie keinen Weiterleitungen, protokollieren Sie ihn nicht und zeigen Sie ihn dem Nutzer nicht. - Rufen Sie nach erfolgreichem Hochladen über dieselbe AI Glot-Verbindung
create_translationmitupload_idund optionalinstructionauf. Es wird genau einer der Werteupload_id,contentundfile_urlakzeptiert. Lassen Siefilenameweg, wenn Sieupload_idverwenden. - Prüfen Sie den verifizierten Plan und
plan.not_included. Vergewissern Sie sich anschließend, dass der Nutzer den Plan und die Guthabenkosten genehmigt hat, bevor Sieapprove_translationaufrufen.
Das Upload-Geheimnis erlaubt innerhalb von 10 Minuten einen einzigen PUT-Versuch. Erstellen Sie die Übersetzung innerhalb einer Stunde. Falls die Antwort auf PUT verloren geht, versuchen Sie zuerst, mit derselben upload_id create_translation aufzurufen. Ist kein vollständiger Upload vorhanden, fordern Sie eine neue Sitzung an. Ein erneuter Erstellungsaufruf ruft dieselbe Übersetzung ab und übernimmt niemals stillschweigend eine geänderte Anweisung. Verwenden Sie plan_translation, um den Plan zu präzisieren. Die Wiederherstellung über upload_id ist bis zur Bereinigung der Sitzung möglich, mindestens jedoch 24 Stunden nach Ausstellung. Notieren Sie sich die Batch-ID, um die Übersetzung später aus Ihrem Verlauf abzurufen.
Wenn die Laufzeitumgebung den lokalen Anhang nicht lesen oder keine HTTP-PUT-Anfragen senden kann, erläutern Sie diese Einschränkung sofort. Zum Beispiel: „Dieser Assistent kann eine Verbindung zu AI Glot herstellen, aber diesen lokalen Anhang nicht senden. Laden Sie das Dokument in der AI Glot-Web-App hoch, verwenden Sie die AI Glot CLI oder stellen Sie einen HTTPS-Download-Link bereit, über den AI Glot die Datei abrufen kann.“ Behaupten Sie nicht, das Dokument sei hochgeladen worden. Fragen Sie den Nutzer nicht nach seinem API-Schlüssel und geben Sie keine Übersetzung frei, solange Datei und Plan nicht verifiziert sind.
Ein Dokument, das bereits unter einer zugänglichen HTTPS-Download-URL gehostet wird, kann weiterhin als file_url gesendet werden. Kleine Textdateien können unverändert als content übermittelt werden. Unter temporäre Uploads finden Sie Informationen zu HTTP-Anfragen und zur Wiederherstellung.
Glossar-Tools
| Tool | Berechtigungsbereich | Funktion |
|---|---|---|
list_glossaries | glossaries:read | Listet Sprachpaare, Anzahl der Begriffe und Tariflimits auf |
get_glossary | glossaries:read | Liest alle Begriffe eines Glossars aus |
edit_glossary_terms | glossaries:write | Erstellt ein Glossar, falls es noch nicht vorhanden ist, und fügt Begriffe hinzu, ändert, entfernt oder ersetzt sie vollständig |
delete_glossary | glossaries:write | Löscht ein Glossar und alle darin enthaltenen Begriffe dauerhaft |
edit_glossary_terms ergänzt standardmäßig die vorhandenen Begriffe. Mit replace_all: true werden alle Begriffe gelöscht, die nicht in der übergebenen Zuordnung enthalten sind. Beide Tools zum Bearbeiten von Glossaren sind als destruktiv gekennzeichnet, da sie Begriffe entfernen können. Unterstützende Clients können daher eine Bestätigung verlangen.
Sprachressource
Die unterstützten Sprachen werden als cachebare MCP-Ressource bereitgestellt:
aiglot://languagesSie wird als Ressource bereitgestellt, da es sich um statische Referenzdaten handelt. Lesen Sie sie aus, bevor Sie ein Glossar für ein Sprachpaar erstellen.
Tool-Ergebnisse und Fehler
Jedes Tool deklariert ein Eingabeschema und gibt strukturierte Inhalte sowie eine lesbare Textdarstellung zurück. Der Standardserver deklariert keine separaten Ausgabeschemata. Fehler werden als lesbare Tool-Ergebnisse mit einem stabilen code und einer Dokumentations-URL zurückgegeben. So kann das Modell die Anfrage korrigieren, statt einen Geschäftsfehler als unterbrochene MCP-Verbindung zu behandeln.
Kopieren Sie dies nach dem Verbinden mit AI Glot in einen MCP-fähigen Assistenten.
Prüfe mein AI Glot-Konto, mein Guthaben und die Nutzung der letzten 30 Tage. Liste anschließend kürzlich fehlgeschlagene oder noch laufende Übersetzungen auf, erkläre Auffälligkeiten und ändere oder archiviere keine Daten.