Підключіть власного ШІ-агента або програмне забезпечення до Tolk2Go
Що можна підключити
- Інші інструменти ШІ, такі як Microsoft Copilot, Gemini або Cursor.
- Конструктори агентів, такі як n8n або Zapier.
- Власний чат-бот або асистент.
- Власне програмне забезпечення, наприклад система планування або ведення справ, яка бронює перекладачів безпосередньо через API Tolk2Go без використання ШІ.
Інструменти ШІ підключаються до сервера MCP Tolk2Go (Model Context Protocol через Streamable HTTP). Власне програмне забезпечення використовує REST API, описаний у контракті OpenAPI. Пошук мов, спеціалізацій і доступних перекладачів є загальнодоступним і не потребує входу. Бронювання завжди здійснюється від імені одного облікового запису клієнта Tolk2Go.
Вхід через OAuth
Для клієнтів MCP, які підтримують вхід через OAuth. Ключ не потрібен.
- Додайте сервер MCP
https://api.tolk2go.com/api/v1/mcpдо клієнта. - Увійдіть і надайте дозвіл. Клієнт відкриває сторінку Tolk2Go. Користувач входить за допомогою свого облікового запису клієнта Tolk2Go та вибирає «Дозволити доступ». Пароль залишається в Tolk2Go.
- Відключіть у будь-який час у розділі Доступ для ШІ-агентів в обліковому записі.
Tolk2Go підтримує OAuth 2.1 із PKCE та динамічну реєстрацію клієнтів. Метадані сервера авторизації доступні за адресою https://api.tolk2go.com/.well-known/oauth-authorization-server.
Підключення за допомогою ключа агента
Для клієнтів без підтримки OAuth та для власного програмного забезпечення через REST API.
- Використовуйте обліковий запис Tolk2Go, якому належать бронювання. Уперше тут? Спочатку створіть обліковий запис.
- Створіть ключ агента. Увійдіть в систему та відкрийте розділ Доступ для ШІ-агентів в обліковому записі, виберіть «Створити ключ» і скопіюйте його. Він показується лише один раз: збережіть його в налаштуваннях конфіденційних даних клієнта і ніколи не вставляйте в чат або промпт.
- Підключіть клієнт до сервера MCP Tolk2Go за допомогою ключа (приклад конфігурації наведено нижче) або надайте йому контракт OpenAPI. Клієнт також може згенерувати ключ самостійно після одноразового входу через API.
- Замініть або відкличте ключ у будь-який час у розділі «Доступ для ШІ-агентів». Відкликаний ключ негайно припиняє діяти.
Адреси
| Що | Адреса |
|---|---|
| Сервер MCP (Streamable HTTP) | https://api.tolk2go.com/api/v1/mcp |
| Контракт OpenAPI | https://api.tolk2go.com/api/v1/spec |
| Посібник для ШІ-агентів | https://www.tolk2go.com/llms.txt |
| Навичка агента та приклади налаштування | github.com/Tolk2Go-Organization/agent-skills |
Приклад конфігурації клієнта MCP із ключем агента:
{
"mcpServers": {
"tolk2go": {
"type": "http",
"url": "https://api.tolk2go.com/api/v1/mcp",
"headers": { "Authorization": "Bearer t2g_agent_..." }
}
}
}
Бажаєте отримати повний цикл бронювання у своєму агенті одразу? Установіть навичку агента Tolk2Go за допомогою npx skills add Tolk2Go-Organization/agent-skills.
Безпека
- Лише один обліковий запис. Підключений застосунок або ключ агента може бачити та керувати лише бронюваннями того облікового запису, який його підключив.
- Відображається один раз, зберігається безпечно. Ключ агента відображається лише під час створення. Tolk2Go зберігає лише безпечний хеш, ніколи не сам ключ.
- Обмежений термін дії. За замовчуванням ключі дійсні 90 днів (можна обрати від 7 до 365 днів), тому агент може повернутися через кілька тижнів без повторного входу.
- Оновлюйте, відкликайте або відключайте в будь-який час. У розділі доступу для ШІ-агентів клієнт бачить кожен ключ із часом його останнього використання та кожен підключений застосунок, а також може замінити або відкликати ключ чи відключити застосунок в один клік.
- Ви ніколи не втратите доступ. Втратили ключ? Відкличте його в обліковому записі та створіть новий. Звичайний вхід до облікового запису працюватиме завжди.
- Жодних платежів від агента. Якщо потрібна попередня оплата, агент отримує безпечне платіжне посилання для клієнта.
Часті запитання
Які клієнти підтримуються?
Будь-який асистент або агент, який підтримує Model Context Protocol (MCP) через Streamable HTTP, зі входом через OAuth або ключем агента, а також будь-яке програмне забезпечення, здатне викликати REST API, описаний в OpenAPI.
Що станеться, якщо ключ агента втрачено або скомпрометовано?
Увійдіть, відкличте ключ у розділі доступу для ШІ-агентів в обліковому записі та створіть новий. Відкликаний ключ припиняє діяти, до того ж він міг мати доступ лише до бронювань цього одного облікового запису.
Чи може наше власне програмне забезпечення здійснювати бронювання без ШІ-асистента?
Так. REST API пропонує такі ж можливості пошуку, бронювання та подальшого супроводу, як і сервер MCP. Дивіться контракт OpenAPI вище.
Потрібна допомога з підключенням?
Ми з радістю допоможемо вашому ІТ-відділу або розробнику підключити Tolk2Go.