Verbind je eigen AI-agent of software met Tolk2Go
Wat je kunt verbinden
- Andere AI-tools, zoals Microsoft Copilot, Gemini of Cursor.
- Agent builders, zoals n8n of Zapier.
- Je eigen chatbot of assistent.
- Je eigen software, zoals een plannings- of zaaksysteem, dat tolken direct boekt via de Tolk2Go- API, zonder AI.
AI-tools maken verbinding met de Tolk2Go- MCP server (Model Context Protocol via Streamable HTTP). Je eigen software gebruikt de REST API, beschreven in een OpenAPI contract. Zoeken naar talen, specialisaties en beschikbare tolken is openbaar en vereist geen aanmelding. Boeken gebeurt altijd namens één Tolk2Go-klantaccount.
Inloggen met OAuth
Voor MCP -clients die OAuth -inloggen ondersteunen. Er is geen sleutel nodig.
- Voeg de MCP server
https://api.tolk2go.com/api/v1/mcptoe aan de client. - Log in en geef toestemming. De client opent een Tolk2Go-pagina. De gebruiker logt in met diens Tolk2Go-klantaccount en kiest Toegang toestaan. Het wachtwoord blijft bij Tolk2Go.
- Ontkoppel op elk moment onder Toegang voor AI-agents in het account.
Tolk2Go ondersteunt OAuth 2.1 met PKCE en dynamische clientregistratie. De metagegevens van de autorisatieserver staan op https://api.tolk2go.com/.well-known/oauth-authorization-server.
Verbinden met een agentsleutel
Voor clients zonder OAuth -ondersteuning en voor je eigen software op de REST API.
- Gebruik het Tolk2Go-account waartoe de boekingen behoren. Nieuw? Maak een account aan eerst.
- Maak een agentsleutel aan. Log in en open Toegang voor AI-agents in het account, kies Sleutel aanmaken en kopieer de sleutel. Deze wordt maar één keer getoond: sla deze op in de beveiligde instellingen van de client, nooit in een chat of prompt.
- Verbind de client met de Tolk2Go- MCP server met behulp van de sleutel (zie voorbeeldconfiguratie hieronder), of geef deze het OpenAPI contract. Een client kan ook zelf een sleutel uitgeven na eenmalig inloggen via de API.
- Vervang of trek de sleutel in op elk moment onder Toegang voor AI-agents. Een ingetrokken sleutel stopt direct met werken.
Adressen
| Wat | Adres |
|---|---|
| MCP server (Streamable HTTP) | https://api.tolk2go.com/api/v1/mcp |
| OpenAPI contract | https://api.tolk2go.com/api/v1/spec |
| Gids voor AI-agents | https://www.tolk2go.com/llms.txt |
| Agent-vaardigheid en installatievoorbeelden | github.com/Tolk2Go-Organization/agent-skills |
Voorbeeld van een MCP -clientconfiguratie met een agentsleutel:
{
"mcpServers": {
"tolk2go": {
"type": "http",
"url": "https://api.tolk2go.com/api/v1/mcp",
"headers": { "Authorization": "Bearer t2g_agent_..." }
}
}
}
Wil je het volledige boekingstraject in één keer in je agent? Installeer de Tolk2Go-agentvaardigheid met npx skills add Tolk2Go-Organization/agent-skills.
Beveiliging
- Slechts één account. Een gekoppelde app of een agentsleutel kan alleen de boekingen zien en beheren van het account dat de koppeling heeft gemaakt.
- Eén keer getoond, veilig opgeslagen. Een agentsleutel wordt alleen weergegeven wanneer deze wordt uitgegeven. Tolk2Go slaat alleen een veilige hash op, nooit de sleutel zelf.
- Beperkte levensduur. Sleutels zijn standaard 90 dagen geldig (er kan gekozen worden voor 7 tot 365 dagen), zodat een agent weken later kan terugkeren zonder opnieuw in te loggen.
- Op elk moment roteren, intrekken of ontkoppelen. Onder toegang voor AI-agents ziet de klant elke sleutel met het laatste gebruik ervan en elke gekoppelde app, en vervangt of trekt met één klik een sleutel in of ontkoppelt een app.
- Nooit buitengesloten. Sleutel kwijt? Trek deze in het account in en maak een nieuwe aan. De normale accountlogin blijft altijd werken.
- Geen betalingen door de agent. Wanneer vooruitbetaling vereist is, ontvangt de agent een veilige betaallink voor de klant.
Veelgestelde vragen
Welke clients worden ondersteund?
Elke assistent of agent die het Model Context Protocol (MCP) via Streamable HTTP ondersteunt, met OAuth-aanmelding of een agentsleutel, en alle software die een REST API kan aanroepen zoals beschreven in OpenAPI.
Wat gebeurt er als een agentsleutel verloren gaat of uitlekt?
Log in, trek de sleutel in onder toegang voor AI-agents in het account en maak een nieuwe aan. De ingetrokken sleutel werkt niet meer en kon sowieso alleen toegang krijgen tot de boekingen van dat ene account.
Kan onze eigen software boeken zonder AI-assistent?
Ja. De REST API biedt dezelfde zoek-, boekings- en opvolgingsmogelijkheden als de MCP-server. Zie het OpenAPI-contract hierboven.
Hulp nodig bij het koppelen?
We helpen je IT-afdeling of ontwikkelaar graag bij het koppelen van Tolk2Go.