--- title: "Standard MCP-tools" description: "Lees meer over de 18 taakgerichte AI Glot MCP-tools, de vereiste scopes, hun neveneffecten en de resource met ondersteunde talen." canonical: "https://ai-glot.com/docs/nl/mcp/standard-tools" updated: "2026-10-12" --- # Standard MCP-tools De standaardserver biedt taakgerichte tools, in plaats van elk REST-eindpunt één-op-één over te nemen. **Lezen** Account, gebruik, vertalingen, resultaten en woordenlijsttermen. **Vertalen** Een vertaling aanmaken, in gewone taal plannen, goedkeuren of annuleren. **Terminologie beheren** Termen in de woordenlijst van de werkruimte toevoegen, bewerken, vervangen of verwijderen. ## Account- en gebruikstools | Tool | Scope | Wat doet deze tool? | | -------------------- | -------------- | ------------------------------------------------------------------------------------------ | | `get_account` | `account:read` | Leest gegevens over de werkruimte, het abonnement, tegoed, limieten en mogelijkheden | | `get_credit_balance` | `account:read` | Leest het saldo en alle tegoedtoekenningen | | `get_usage` | `usage:read` | Leest het tegoed, het aantal woorden en de voltooide vertalingen over een bepaalde periode | ## Feedbacktool | Tool | Scope | Wat doet deze tool? | | --------------- | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- | | `send_feedback` | Geen naast authenticatie | Registreert feedback in vrije tekst over een onverwacht resultaat, verwarrend gedrag of iets dat volgens jou anders zou moeten werken | 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 | Tool | Scope | Wat doet deze tool? | | ----------------------- | --------------- | ----------------------------------------------------------------- | | `list_batches` | `batches:read` | Geeft bestaande vertalingen weer met paginering via een cursor | | `get_batch` | `batches:read` | Leest één vertaling, de voortgang en het huidige beoordelingsplan | | `show_translation` | `batches:read` | Toont de interactieve beoordeling in compatibele MCP Apps-hosts | | `get_batch_result_link` | `batches:read` | Geeft een downloadlink van 30 minuten voor een voltooid resultaat | | `update_batch` | `batches:write` | Hernoemt, archiveert of herstelt een vertaling | 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 | Tool | Scope | Wat doet deze tool? | | --------------------- | ---------------- | ------------------------------------------------------------------------------------------------------------------- | | `create_upload_url` | `batches:create` | Geeft een tijdelijke URL en headers voor een lokaal bestand. Hiervoor is een externe HTTP-client nodig. Kost niets. | | `create_translation` | `batches:create` | Maakt een vertaling van een bestand. Kost niets. | | `plan_translation` | `batches:create` | Bepaalt of verfijnt in gewone taal wat er vertaald moet worden. Kost niets. | | `approve_translation` | `batches:create` | **Kost tegoed** en start de vertaling | | `cancel_translation` | `batches:write` | Stopt een vertaling die bezig is; het werk dat al is uitgevoerd, wordt in rekening gebracht | 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. > **Warning: Alleen goedkeuren kost tegoed** > > Een agent kan zo vaak als nodig kosteloos een vertaling aanmaken en het plan opnieuw opstellen. `approve_translation` reserveert tegoed voor het plan en het gekozen kwaliteitsniveau. De tool is als destructief gemarkeerd, omdat uitgevoerd werk niet kan worden terugbetaald door de toolaanroep ongedaan te maken. Keur alleen goed als de gebruiker toestemming heeft gegeven voor het huidige plan, de uitsluitingen en de berekende kosten. Een expliciete doorlopende machtiging kan dat plan en budget dekken; de client kan alsnog om een eigen bevestiging vragen. `cancel_translation` is om dezelfde reden als destructief gemarkeerd: de kosten voor het al uitgevoerde werk worden in rekening gebracht en kunnen niet ongedaan worden gemaakt. ## Interactieve beoordeling met MCP Apps ![De vertaalbeoordeling van AI Glot geopend in een chat: het bestand, het plan en wat ongewijzigd blijft, weergegeven door een MCP Apps-host](/docs/screenshots/mcp/mcp-apps-translation-review.webp) _De beoordelingskaart die een MCP Apps-host in het gesprek opent_ 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](/docs/api/uploads/create) voor de HTTP-aanvraag en herstelregels. ## Woordenlijsttools | Tool | Scope | Wat doet deze tool? | | --------------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------- | | `list_glossaries` | `glossaries:read` | Geeft taalparen, aantallen termen en abonnementslimieten weer | | `get_glossary` | `glossaries:read` | Leest alle termen in één woordenlijst | | `edit_glossary_terms` | `glossaries:write` | Maakt een woordenlijst aan als die ontbreekt en voegt daarna termen toe, wijzigt of verwijdert ze, of vervangt ze volledig | | `delete_glossary` | `glossaries:write` | Verwijdert een woordenlijst en al haar termen definitief | `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: ```text 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. **Controleer mijn recente vertaalgebruik** Kopieer dit naar een assistent met MCP-ondersteuning nadat je AI Glot hebt verbonden. Controleer mijn AI Glot-account, tegoedsaldo en het gebruik van de afgelopen 30 dagen. Geef daarna een overzicht van recente mislukte of nog lopende vertalingen, leg eventuele bijzonderheden uit en wijzig of archiveer geen gegevens. > **Warning** > > Vraag om bevestiging voordat je alle woordenlijsttermen vervangt of een woordenlijst definitief verwijdert. Uit een vaag verzoek om op te schonen kun je niet veilig afleiden dat de gebruiker dit bedoelt.