Standard MCP-tools

De standaardserver biedt taakgerichte tools, in plaats van elk REST-eindpunt één-op-één over te nemen.

Account- en gebruikstools

Feedbacktool

Gebruik send_feedback zodra duidelijk is wat het probleem is. Beschrijf de situatie, wat er is gebeurd en wat er had moeten gebeuren. Vermeld indien bekend de betreffende actie, het AI-model en de agent-harness. Voeg geen API-sleutels, tokens, ondertekende URL’s of volledige bestandsinhoud toe. Deze tool kost geen tegoed en verandert niets aan een vertaling.

Account- en gebruikstools zijn alleen-lezen en kosten geen tegoed.

Vertaaltools

De tool voor resultaatlinks geeft standaard een tijdelijke download-URL. Geef voor tekstbestanden kleiner dan 2 MB format: 'content' mee om de vertaalde tekst in het toolantwoord te ontvangen. update_batch wijzigt alleen de beheergegevens en archiveren kan ongedaan worden gemaakt.

Tools die vertalen

Deze tools maken het verschil tussen een agent die je werkruimte kan lezen en een agent die het werk kan uitvoeren. De volgorde ligt vast (aanmaken, plannen, goedkeuren) en alleen de derde stap kost iets.

Interactieve beoordeling met MCP Apps

Roep na het aanmaken of selecteren van een batch show_translation aan met de bijbehorende batch_id. Compatibele hosts kunnen het bestand, het plan, de inbegrepen en uitgesloten inhoud, de berekende Standard/Lite-prijzen, het saldo van de werkruimte, de voortgang en het resultaat weergeven. Andere clients ontvangen gewone gestructureerde batchgegevens en kunnen de bestaande tools blijven gebruiken.

De weergave leest gegevens en keurt goed via dezelfde geauthenticeerde MCP-verbinding. Bekijken en vernieuwen kosten geen tegoed. Goedkeuren vereist batches:create, een actueel geverifieerd plan, een beschikbaar kwaliteitsniveau en voldoende tegoed. Niet-lege aangepaste richtlijnen vereisen entitlements.custom_guidelines; de maximale lengte is 2,000 tekens. De gebruiker moet akkoord gaan met eventuele vermelde uitsluitingen voordat de vertaling vanuit de weergave wordt gestart.

get_batch retourneert plan_revision zolang er een plan beschikbaar is ter beoordeling. Geef die waarde door als expected_plan_revision aan approve_translation om de goedkeuring aan het beoordeelde plan te koppelen. Als het plan is gewijzigd, weigert plan_changed de start. Vernieuw de weergave en controleer de nieuwe inhoud en prijs. Dit optionele veld is ook beschikbaar bij REST-goedkeuring. Oudere aanroepen worden nog steeds ondersteund, maar voeren deze revisiecontrole niet uit. Verzin geen CLI-vlag: de opdracht voor de onbewerkte API in de CLI kan zo nodig het JSON-veld versturen.

De weergave vernieuwt actief werk met een begrensde wachttijd en biedt pas na voltooiing een download aan. Een voorbeeld wordt als voorbeeld aangeduid. Een ontbrekend of verlopen bewaard bestand leidt expliciet tot een fout; vernieuwen kan verwijderde bytes niet terughalen. Ga er niet van uit dat een host een UI ondersteunt als die MCP Apps niet implementeert. De AI Glot-webapp blijft beschikbaar als alternatief.

Een lokaal document versturen

De MCP-client moet de oorspronkelijke bestandsbytes kunnen lezen en buiten MCP een HTTP PUT-verzoek kunnen versturen. Een assistent met AI Glot verbinden geeft deze niet automatisch toegang tot bijlagen of een HTTP-client. AI Glot Code Mode kan deze overdracht niet zelf uitvoeren.

1. Roep create_upload_url aan met de kale filename en de exacte size_bytes.
2. Verstuur de oorspronkelijke bytes naar upload_url met de geretourneerde method en headers. De Authorization-header is een tijdelijk geheim dat alleen voor uploaden is bedoeld. Vervang deze nooit door een API-sleutel voor de werkruimte of een OAuth-token, volg geen omleidingen, log de header niet en toon deze niet aan de gebruiker.
3. Roep na een geslaagde upload create_translation aan met upload_id en eventueel instruction, via dezelfde AI Glot-verbinding. Precies één van upload_id, content en file_url is toegestaan. Laat filename weg wanneer je upload_id gebruikt.
4. Controleer het geverifieerde plan en plan.not_included. Controleer vervolgens of de gebruiker toestemming heeft gegeven voor dit plan en de tegoedkosten voordat je approve_translation aanroept.

Met het uploadgeheim kun je binnen 10 minuten één PUT-poging doen. Maak de vertaling binnen één uur aan. Als het antwoord op een PUT-verzoek verloren gaat, probeer dan eerst create_translation met dezelfde upload_id. Als er geen volledige upload bestaat, haal je een nieuwe sessie op. Als je de vertaling opnieuw aanmaakt, wordt dezelfde vertaling teruggehaald en wordt een gewijzigde instructie nooit stilzwijgend toegepast. Gebruik plan_translation om de instructie aan te passen. Herstel via upload_id is mogelijk totdat de sessie wordt opgeschoond, minimaal 24 uur na uitgifte. Bewaar de batch-ID om de vertaling later uit je geschiedenis op te halen.

Als de runtime de lokale bijlage niet kan lezen of geen HTTP PUT-verzoeken kan versturen, leg de beperking dan meteen uit. Bijvoorbeeld: “Deze assistent kan verbinding maken met AI Glot, maar kan deze lokale bijlage niet versturen. Upload het document in de AI Glot-webapp, gebruik de AI Glot CLI of geef een HTTPS-downloadlink op die AI Glot kan ophalen.” Beweer niet dat het document is geüpload, vraag de gebruiker niet om de API-sleutel en keur geen vertaling goed zonder geverifieerd bestand en plan.

Een document dat al via een toegankelijke HTTPS-download-URL wordt gehost, kan nog steeds als file_url worden verstuurd. Kleine tekstbestanden kunnen ongewijzigd als content worden verstuurd. Zie tijdelijke uploads voor de HTTP-aanvraag en herstelregels.

Woordenlijsttools

edit_glossary_terms voegt standaard termen toe. Met replace_all: true worden alle termen verwijderd die niet in de opgegeven map staan. Beide tools voor het bewerken van woordenlijsten zijn als destructief gemarkeerd omdat ze termen kunnen verwijderen. Ondersteunende clients kunnen daarom om bevestiging vragen.

Taalresource

Ondersteunde talen zijn beschikbaar als cachebare MCP-resource:

aiglot://languages

Deze is als resource beschikbaar omdat het om statische referentiegegevens gaat. Lees deze voordat je een woordenlijst voor een talenpaar aanmaakt.

Toolresultaten en fouten

Elke tool definieert een invoerschema en retourneert gestructureerde inhoud plus een leesbare tekstweergave. De standaardserver definieert geen afzonderlijke uitvoerschema’s. Fouten worden geretourneerd als leesbare toolresultaten met een stabiele code en een documentatie-URL. Zo kan het model het verzoek corrigeren, in plaats van een bedrijfsfout te behandelen als een verbroken MCP-verbinding.