AI Glot websiteOpen AI Glot
AI Glot betreibenStandard-MCP-Tools
AI Glot betreiben

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

ToolBerechtigungsbereichFunktion
get_accountaccount:readLiest Arbeitsbereich, Tarif, Guthaben, Limits und Funktionen aus
get_credit_balanceaccount:readLiest den Kontostand und alle Guthabenbuchungen aus
get_usageusage:readLiest Guthaben, Wörter und abgeschlossene Übersetzungen im Zeitverlauf aus

Feedback-Tool

ToolBerechtigungsbereichFunktion
send_feedbackKeine über die Authentifizierung hinausErfasst 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

ToolBerechtigungsbereichFunktion
list_batchesbatches:readListet vorhandene Übersetzungen mit Cursor-Paginierung auf
get_batchbatches:readLiest eine Übersetzung, ihren Fortschritt und den aktuellen Prüfplan aus
show_translationbatches:readZeigt die interaktive Prüfung in kompatiblen MCP-Apps-Hosts an
get_batch_result_linkbatches:readGibt einen 30 Minuten gültigen Download-Link für ein fertiges Ergebnis zurück
update_batchbatches:writeBenennt 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

ToolBerechtigungsbereichFunktion
create_upload_urlbatches:createGibt eine temporäre URL und Header für eine lokale Datei zurück. Erfordert einen externen HTTP-Client. Kostet nichts.
create_translationbatches:createErstellt eine Übersetzung aus einer Datei. Kostet nichts.
plan_translationbatches:createPlant oder präzisiert in natürlicher Sprache, was übersetzt werden soll. Kostet nichts.
approve_translationbatches:createVerbraucht Guthabenpunkte und startet die Übersetzung
cancel_translationbatches:writeStoppt 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

Die Übersetzungsprüfung von AI Glot in einem Chat geöffnet: Datei, Plan und unveränderte Inhalte, angezeigt von einem MCP-Apps-Host

Die Prüfkarte, die ein MCP-Apps-Host im Gespräch öffnet

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.

  1. Rufen Sie create_upload_url mit dem reinen filename und dem exakten Wert für size_bytes auf.
  2. Senden Sie die Originaldaten mit der zurückgegebenen method und den headers an upload_url. Der Authorization-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.
  3. Rufen Sie nach erfolgreichem Hochladen über dieselbe AI Glot-Verbindung create_translation mit upload_id und optional instruction auf. Es wird genau einer der Werte upload_id, content und file_url akzeptiert. Lassen Sie filename weg, wenn Sie upload_id verwenden.
  4. 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 Sie approve_translation aufrufen.

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

ToolBerechtigungsbereichFunktion
list_glossariesglossaries:readListet Sprachpaare, Anzahl der Begriffe und Tariflimits auf
get_glossaryglossaries:readLiest alle Begriffe eines Glossars aus
edit_glossary_termsglossaries:writeErstellt ein Glossar, falls es noch nicht vorhanden ist, und fügt Begriffe hinzu, ändert, entfernt oder ersetzt sie vollständig
delete_glossaryglossaries:writeLö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://languages

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

Meine Übersetzungsnutzung der letzten Zeit überprüfen

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.

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.