Подключение собственного ИИ-агента или ПО к Tolk2Go
Что можно подключить
- Другие ИИ-инструменты, такие как Microsoft Copilot, Gemini или Cursor.
- Платформы для создания агентов, такие как n8n или Zapier.
- Собственный чат-бот или ассистент.
- Собственное программное обеспечение, например система планирования или ведения дел, которая бронирует переводчиков напрямую через Tolk2Go API, без участия ИИ.
ИИ-инструменты подключаются к серверу Tolk2Go MCP (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, к которому относятся бронирования. Впервые у нас? Сначала создайте аккаунт.
- Создайте ключ агента. Войдите в систему, откройте раздел Доступ для ИИ-агента в аккаунте, выберите «Создать ключ» и скопируйте его. Он отображается только один раз: сохраните его в защищенных настройках клиента, ни в коем случае не в чате или промпте.
- Подключите клиент к серверу Tolk2Go MCP с помощью ключа (пример конфигурации приведен ниже) или передайте ему контракт 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 выше.
Нужна помощь с подключением?
Мы с радостью поможем вашему IT-отделу или разработчику подключить Tolk2Go.