Переглянути довідковий центр

Підключіть свого ШІ-асистента (MCP)

Підтримує Vitalii VlasiukCo-founder

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 у додатку.

Одноразове налаштування для кожного MCP-клієнта.
КлієнтНалаштування
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. Ключі призначені для систем, що не мають доступу до браузера. У будь-якому разі підключення з'явиться в розділі Налаштування → Розробник як запис, який можна будь-коли скасувати, тож відключення виконується одним кліком незалежно від способу підключення.

OAuth або API-ключ — залежно від того, як працює асистент.
Ви підключаєтеСпосіб автентифікації
Асистент, з яким ви працюєте безпосередньо (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].