Підключіть свого ШІ-асистента (MCP)
Transept має MCP-ендпоїнт, до якого ШІ-асистенти підключаються напряму. Після підключення асистент може керувати повним циклом робіт (імпортувати документи, запускати процеси перекладу різними мовами, працювати з глосаріями та стайл-гайдами, зчитувати результати), тоді як права доступу та баланс слів залишаються під вашим повним контролем.
На цій сторінці
Що таке MCP-ендпоїнт?
MCP (Model Context Protocol) — це стандарт, який ШІ-асистенти використовують для виклику зовнішніх інструментів. Transept надає для цього один ендпоїнт, https://app.transept.ai/api/public/v1/mcp. Підключений до нього асистент отримує ті ж можливості, що й скрипт через API, але оформлені у вигляді інструментів, які він може викликати самостійно: створити документ, оцінити вартість запуску, запустити процес, відстежувати його статус та зчитати готові переклади.
Практична відмінність від звичайного копіювання тексту в чат-бот: асистент працює з вашими справжніми документами, застосовуючи ваші глосарії, стайл-гайди та пам'ять перекладів. Результати потрапляють у Transept, де ви можете переглянути та експортувати їх, як і будь-яку іншу роботу.
Як підключити Claude Code, Claude Desktop або Cursor?
Підключення відбувається через стандартний протокол OAuth: додайте URL-адресу у свій клієнт, і під час першого з'єднання відкриється вікно браузера із запитом на доступ. Підтвердьте його, і клієнт буде прив'язаний — вставляти жодні ключі не потрібно. Готові фрагменти налаштувань для кожного клієнта можна знайти на сторінці Integrations у додатку.
| Клієнт | Налаштування |
|---|---|
| Claude Code | Виконайте claude mcp add --transport http transept https://app.transept.ai/api/public/v1/mcp у терміналі |
| Claude Desktop | Налаштування → Конектори → Додати власний конектор, вставте URL-адресу ендпоїнту |
| Cursor | Додайте сервер із "url": "https://app.transept.ai/api/public/v1/mcp" до його файлу mcp.json |
| Інші варіанти | Будь-який MCP-клієнт, що працює через потоковий HTTP: вкажіть для нього ту саму URL-адресу |
Чи потрібен мені API-ключ?
Для інтерактивних клієнтів вони не потрібні: там використовується OAuth. Ключі призначені для систем, що не мають доступу до браузера. У будь-якому разі підключення з'явиться в розділі Налаштування → Розробник як запис, який можна будь-коли скасувати, тож відключення виконується одним кліком незалежно від способу підключення.
| Ви підключаєте | Спосіб автентифікації |
|---|---|
| Асистент, з яким ви працюєте безпосередньо (Claude, Cursor) | OAuth: підтвердження в браузері при першому підключенні, нічого вставляти не потрібно |
| CI, сервер, автономний агент | API-ключ із розділу Налаштування → Розробник, що передається в заголовку Authorization: Bearer |
Що саме може робити асистент?
Інструменти охоплюють повний цикл роботи, тож в одному діалозі можна пройти шлях від імпорту документа до отримання перевірених перекладів:
- Імпорт контенту: вставлені документи або каталог рядків із ключами, контекстами та плейсхолдерами.
- Безкоштовно оцінювати вартість запуску, запускати процеси перекладу всіма цільовими мовами одночасно та відстежувати прогрес для кожної з них.
- Створювати та розширювати глосарії, переглядати стайл-гайди та звертатися до пам'яті перекладів перед початком перекладу.
- Отримувати результати: поблоково для прози або за ID рядка для каталогів.
- Реєструвати вебхуки, щоб ваші власні системи отримували підписану подію після завершення запуску.
- Що за задумом винесено за межі: завантаження файлів та експорт у бінарні формати (DOCX, XLIFF, TMX) здійснюються через REST API, а керування ключами залишається дією людини в додатку; асистент ніколи не зможе самостійно згенерувати собі ключ.
Як захищені мої витрати?
Три запобіжники, кожен із яких діє на стороні Transept, а не покладається на самого асистента:
- Дозволи. Кожен виклик інструменту перевіряється на відповідність наданим вами правам: областям доступу ключа або згоді OAuth. Виклик, що виходить за ці межі, відхиляється із зазначенням назви відсутнього дозволу.
- Оцінка, потім підтвердження. Будь-яка операція, що передбачає витрату слів, спочатку повертає оціночну кількість слів і зупиняється. Запуск відбувається лише після явного підтвердження асистентом, тож ви бачите вартість у чаті ще до початку виконання. Етапи перевірки у ваших робочих процесах так само призупиняють виконання; для продовження потрібне чітке схвалення від вас або від асистента за вашою вказівкою.
- Відкликання. Ви можете розірвати підключення зі свого боку в будь-який момент: наступний виклик асистента, доступ якого відкликано, буде відхилено, навіть посеред діалогу.
Чи може контент надходити та виходити без моєї безпосередньої участі в додатку?
Так: поєднайте підключення з тригером вебхуку, і цикл замкнеться. Ваша поштова платформа, CMS або скрипт надсилають контент через POST-запит на URL-адресу тригера (тіло запиту стає документом), робочий процес перекладає його, а вебхук або асистент зчитує готові переклади: на один вхідний шаблон ви отримуєте десять мов на виході, і при цьому ніхто навіть не відкриває редактор.
Саме цей принцип лежить в основі локалізації поштових шаблонів та безперервної роботи з каталогом рядків: платформа надсилає лише те, що змінилося, Transept перекладає ці зміни, а ваш конвеєр забирає результати. Ваша роль — це перевірка, а всю механічну роботу делеговано системі.
Чи може асистент витрачати мої слова без дозволу?
Ні. Будь-який інструмент, що ініціює платний запуск, спочатку лише повертає оціночну кількість слів і більше нічого не робить; асистент має надати явне підтвердження перед початком запуску, і це підтвердження відображається у вашому чаті. Безкоштовні дії (імпорт, оцінка, зчитування результатів) не потребують підтвердження, оскільки вони ніколи не тарифікуються.
Як відключити асистента?
У розділі Налаштування → Розробник. Кожне підключення (згода OAuth або вставлений ключ) відображається там як запис із можливістю відкликання. Відкличте його — і наступний виклик асистента буде відхилено; на стороні асистента нічого очищувати не потрібно.
Які клієнти MCP підтримуються?
Будь-який клієнт, що працює з MCP через потоковий HTTP: Claude Code, Claude Desktop, Cursor та новіші фреймворки агентів — усі вони підтримуються. Інтерактивні клієнти підключаються через OAuth; headless-клієнти передають API-ключ у заголовку Bearer. В обох випадках URL-адреса кінцевої точки однакова.
Досі потрібна допомога? Запитайте Literess у застосунку або напишіть на [email protected].