Standard-MCP-Tools

Der Standardserver stellt aufgabenorientierte Tools bereit, statt jeden REST-Endpunkt einzeln abzubilden.

Konto- und Nutzungstools

Feedback-Tool

Verwende send_feedback, sobald das Problem klar ist. Beschreibe die Situation, was passiert ist und was hätte passieren sollen. Falls bekannt, nenne auch die zugehörige Aktion, das AI-Modell und das Agent-Harness. Gib keine API-Schlüssel, Tokens, signierten URLs oder vollständigen Dateiinhalte an. Das Tool kostet kein Guthaben und ändert keine Übersetzung.

Konto- und Nutzungstools sind schreibgeschützt und verbrauchen kein Guthaben.

Übersetzungstools

Das Ergebnis-Link-Tool gibt standardmäßig eine temporäre Download-URL zurück. Bei Textformaten unter 2 MB kannst du 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

Diese Tools unterscheiden einen Agenten, der deinen Arbeitsbereich nur ausliest, von einem, der Aufgaben darin ausführen kann. Die Reihenfolge ist festgelegt (erstellen, planen, freigeben). Nur der dritte Schritt kostet etwas.

Ein lokales Dokument senden

Der MCP-Client muss die ursprünglichen Dateibytes lesen und außerhalb von MCP eine HTTP-PUT-Anfrage senden können. Wenn du einen Assistenten mit AI Glot verbindest, erhält er dadurch nicht automatisch Zugriff auf Anhänge oder einen HTTP-Client. AI Glot Code Mode kann die Datei nicht selbst übertragen.

1. Rufe create_upload_url mit dem reinen filename und dem exakten Wert für size_bytes auf.
2. Sende die Originalbytes mit der zurückgegebenen method und den headers an upload_url. Der Authorization-Header ist ein temporäres Geheimnis, das nur für den Upload gilt. Ersetze ihn niemals durch einen Arbeitsbereich-API-Schlüssel oder ein OAuth-Token. Folge keinen Weiterleitungen, protokolliere ihn nicht und zeige ihn dem Nutzer nicht.
3. Rufe nach erfolgreichem Upload create_translation mit upload_id und optional mit instruction über dieselbe AI Glot-Verbindung auf. Akzeptiert wird genau einer dieser Werte: upload_id, content oder file_url. Lasse filename weg, wenn du upload_id verwendest.
4. Prüfe den verifizierten Plan und plan.not_included. Stelle anschließend sicher, dass der Nutzer den Plan und die Guthabenkosten genehmigt hat, bevor du approve_translation aufrufst.

Das Upload-Geheimnis erlaubt innerhalb von 10 Minuten einen einzigen PUT-Versuch. Erstelle die Übersetzung innerhalb einer Stunde. Geht die Antwort auf eine PUT-Anfrage verloren, versuche zuerst, mit derselben upload_id create_translation aufzurufen. Falls kein vollständiger Upload vorliegt, erstelle eine neue Sitzung. Bei wiederholtem Aufruf wird dieselbe Übersetzung wiederhergestellt. Eine geänderte Anweisung wird dabei niemals stillschweigend übernommen. Verwende plan_translation, um den Plan zu verfeinern. Die Wiederherstellung über upload_id ist bis zur Bereinigung der Sitzung möglich, mindestens aber 24 Stunden nach der Erstellung. Bewahre die Batch-ID auf, damit du die Übersetzung später aus deinem Verlauf abrufen kannst.

Wenn die Laufzeitumgebung nicht auf den lokalen Anhang zugreifen oder HTTP-PUT-Anfragen senden kann, erkläre diese Einschränkung sofort. Zum Beispiel: „Dieser Assistent kann eine Verbindung zu AI Glot herstellen, aber diesen lokalen Anhang nicht senden. Lade das Dokument in der AI Glot-Web-App hoch, verwende die AI Glot-CLI oder stelle einen HTTPS-Download-Link bereit, über den AI Glot die Datei abrufen kann.“ Behaupte nicht, dass das Dokument hochgeladen wurde. Bitte den Nutzer nicht um seinen API-Schlüssel und gib keine Übersetzung frei, wenn Datei und Plan nicht verifiziert wurden.

Ein Dokument, das bereits über eine zugängliche HTTPS-Download-URL bereitsteht, kann weiterhin als file_url gesendet werden. Kleine Textdateien können unverändert als content übermittelt werden. Weitere Informationen zu HTTP-Anfragen und zur Wiederherstellung findest du unter temporäre Uploads.

Glossartools

edit_glossary_terms fügt standardmäßig Begriffe hinzu. replace_all: true löscht alle Begriffe, die nicht in der übergebenen Zuordnung enthalten sind. Beide Glossar-Bearbeitungstools sind als destruktiv gekennzeichnet, da sie Begriffe entfernen können. Unterstützende Clients können deshalb eine Bestätigung verlangen.

Sprachressource

Die unterstützten Sprachen werden über die MCP-Ressource bereitgestellt, die sich im Cache speichern lässt:

aiglot://languages

Sie wird als Ressource bereitgestellt, da es sich um statische Referenzdaten handelt. Lies sie aus, bevor du ein Glossar für ein Sprachpaar erstellst.

Tool-Ergebnisse und Fehler

Jedes Tool definiert ein Eingabeschema und gibt strukturierte Inhalte sowie eine lesbare Textdarstellung zurück. Der Standardserver definiert keine separaten Ausgabeschemas. 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.