Connectez votre propre agent IA ou logiciel à Tolk2Go
Ce que vous pouvez connecter
- D’autres outils d’IA, comme Microsoft Copilot, Gemini ou Cursor.
- Des créateurs d’agents, comme n8n ou Zapier.
- Votre propre chatbot ou assistant.
- Votre propre logiciel, tel qu’un système de planification ou de gestion de dossiers, qui réserve des interprètes directement via l’API Tolk2Go, sans IA.
Les outils d’IA se connectent au serveur MCP de Tolk2Go (Model Context Protocol sur HTTP streamable). Votre propre logiciel utilise l’REST API, décrit dans un contrat OpenAPI. La recherche de langues, de spécialisations et d’interprètes disponibles est publique et ne nécessite aucune connexion. La réservation s’effectue toujours pour le compte d’un compte client Tolk2Go.
Se connecter avec OAuth
Pour les clients MCP prenant en charge la connexion OAuth. Aucune clé n’est requise.
- Ajoutez le serveur MCP
https://api.tolk2go.com/api/v1/mcpau client. - Connectez-vous et autorisez l’accès. Le client ouvre une page Tolk2Go. L’utilisateur se connecte avec son compte client Tolk2Go et choisit Autoriser l’accès. Le mot de passe reste chez Tolk2Go.
- Déconnectez-vous à tout moment sous Accès agent IA dans le compte.
Tolk2Go prend en charge OAuth 2.1 avec PKCE et l’enregistrement dynamique des clients. Les métadonnées du serveur d’autorisation se trouvent à l’adresse https://api.tolk2go.com/.well-known/oauth-authorization-server.
Se connecter avec une clé d’agent
Pour les clients ne prenant pas en charge OAuth et pour votre propre logiciel sur l’REST API.
- Utilisez le compte Tolk2Go auquel sont rattachées les réservations. Nouveau client ? Créez d’abord un compte.
- Créez une clé d’agent. Connectez-vous et ouvrez Accès agent IA dans le compte, choisissez Créer une clé et copiez la clé. Elle ne s’affiche qu’une seule fois : conservez-la dans les paramètres secrets du client, jamais dans une discussion ou un prompt.
- Connectez le client au serveur MCP de Tolk2Go avec la clé (exemple de configuration ci-dessous), ou fournissez-lui le contrat OpenAPI. Un client peut également générer lui-même une clé après s’être connecté une fois via l’API.
- Remplacez ou révoquez la clé à tout moment sous Accès agent IA. Une clé révoquée cesse immédiatement de fonctionner.
Adresses
| Élément | Adresse |
|---|---|
| Serveur MCP (HTTP streamable) | https://api.tolk2go.com/api/v1/mcp |
| Contrat OpenAPI | https://api.tolk2go.com/api/v1/spec |
| Guide pour les agents IA | https://www.tolk2go.com/llms.txt |
| Skill d’agent et exemples de configuration | github.com/Tolk2Go-Organization/agent-skills |
Exemple de configuration d’un client MCP avec une clé d’agent :
{
"mcpServers": {
"tolk2go": {
"type": "http",
"url": "https://api.tolk2go.com/api/v1/mcp",
"headers": { "Authorization": "Bearer t2g_agent_..." }
}
}
}
Vous souhaitez intégrer immédiatement l’ensemble du parcours de réservation dans votre agent ? Installez le skill d’agent Tolk2Go avec npx skills add Tolk2Go-Organization/agent-skills.
Sécurité
- Un seul compte. Une application connectée ou une clé d’agent ne peut voir et gérer que les réservations du compte qui l’a connectée.
- Affichée une seule fois, stockée en toute sécurité. Une clé d’agent n’est affichée que lors de son émission. Tolk2Go ne stocke qu’un hachage sécurisé, jamais la clé elle-même.
- Durée de validité limitée. Les clés sont valables 90 jours par défaut (durée configurable de 7 à 365 jours), ce qui permet à un agent de revenir plusieurs semaines plus tard sans avoir à se reconnecter.
- Renouvelez, révoquez ou déconnectez à tout moment. Sous l’accès agent IA, le client voit chaque clé avec sa dernière utilisation ainsi que chaque application connectée, et peut remplacer ou révoquer une clé ou déconnecter une application en un clic.
- Jamais bloqué. Clé perdue ? Révoquez-la dans le compte et créez-en une nouvelle. La connexion habituelle au compte continue toujours de fonctionner.
- Aucun paiement par l’agent. Lorsqu’un prépaiement est requis, l’agent reçoit un lien de paiement sécurisé pour le client.
Foire aux questions
Quels clients sont pris en charge ?
Tout assistant ou agent prenant en charge le Model Context Protocol (MCP) via Streamable HTTP, avec connexion OAuth ou une clé d’agent, ainsi que tout logiciel capable d’appeler une REST API décrite dans OpenAPI.
Que se passe-t-il si une clé d’agent est perdue ou compromise ?
Connectez-vous, révoquez la clé sous Accès agent IA dans le compte, et créez-en une nouvelle. La clé révoquée cesse immédiatement de fonctionner, et elle ne pouvait de toute façon accéder qu’aux réservations de ce seul compte.
Notre propre logiciel peut-il réserver sans assistant IA ?
Oui. L’REST API offre les mêmes fonctionnalités de recherche, de réservation et de suivi que le serveur MCP. Consultez le contrat OpenAPI ci-dessus.
Besoin d’aide pour la connexion ?
Nous serons ravis d’aider votre service informatique ou votre développeur à connecter Tolk2Go.