Конектори

Підключіть Syntra до Claude і ChatGPT

Конектор Syntra дає Claude і ChatGPT змогу працювати з вашим простором у Syntra через відкритий протокол Model Context Protocol (MCP). Питайте про проєкти, задачі, ризики й спринти звичайними словами, а там, де простір це дозволяє, доручайте асистенту створювати й змінювати їх за вас.

Що потрібно

  • Акаунт Syntra, що входить до простору на платному плані: Starter, Business або Enterprise. Читання через Claude і ChatGPT доступне на будь-якому платному плані; запис — на плані Enterprise, разом з API та вебхуками. Див. ціни.
  • Claude (будь-який план, що підтримує конектори) або ChatGPT (план, який дає змогу додати власний MCP-сервер).
  • Нічого не треба встановлювати, реєструвати OAuth-додаток чи створювати client ID або API-ключ. Ви входите в Syntra у браузері, вибираєте простір і один раз дозволяєте доступ.

Адреса сервера: https://syntra.tymko.tech/mcp. Простір ви вибираєте на сторінці згоди під час підключення. Якщо ви в кількох просторах і хочете окремий конектор для кожного, можна натомість узяти власну адресу простору, https://syntra.tymko.tech/mcp/<workspace> — її видно в Syntra на сторінці «API» цього простору. Це необов’язково.

Підключення в Claude

Syntra є в каталозі конекторів Claude (Claude Connectors Directory) як конектор від спільноти. Claude сам представляється Syntra через Client ID Metadata Document, тож налаштовувати OAuth-додаток, client ID чи API-ключ не треба. Конектор працює в Claude у вебі, у Claude Desktop і в мобільних застосунках.

  1. Знайдіть Syntra.У Claude відкрийте Customize (або Settings) → Connectors, знайдіть Syntra і натисніть Connect. Можна й одразу відкрити сторінку Syntra в каталозі.
  2. Увійдіть у Syntra.Відкриється вікно Syntra; увійдіть зі своїм акаунтом Syntra (і другим фактором, якщо його ввімкнено).
  3. Виберіть простір і дозвольте доступ.Сторінка згоди показує додаток (Claude, claude.ai), вашого користувача, рівень доступу і куди вас поверне. Якщо ви в кількох просторах, виберіть один і натисніть «Дозволити».
  4. Питайте.У новому чаті запитайте про свої проєкти. Claude викликає інструменти Syntra й показує кожен виклик.

Claude Code підключається так само: claude mcp add --transport http syntra https://syntra.tymko.tech/mcp, потім виконайте /mcp, щоб увійти.

Підключення в ChatGPT

  1. Додайте власний MCP-сервер.У ChatGPT відкрийте Plugins (Settings → Apps), натисніть Add, потім Add custom MCP server. Вкажіть URL https://syntra.tymko.tech/mcp і виберіть OAuth як спосіб автентифікації.
  2. Увійдіть і дозвольте.ChatGPT представляється сам, тож у Syntra нічого реєструвати не треба. Увійдіть у Syntra, виберіть простір і натисніть «Дозволити» на тій самій сторінці згоди, що й для Claude; додаток там названо ChatGPT (chatgpt.com).
  3. Користуйтеся в чаті.Згадайте Syntra або виберіть її в меню інструментів, а потім поставте запитання.

У каталозі застосунків ChatGPT Syntra поки немає, тому наразі її додають як власний MCP-сервер.

Інші MCP-клієнти

Інші клієнти, що підтримують віддалені MCP-сервери, підключаються до https://syntra.tymko.tech/mcp через OAuth за допомогою OAuth-додатка, зареєстрованого в налаштуваннях простору на вкладці «API»: вхід і сторінка згоди ті самі, що описано вище. Клієнти, які надсилають власні заголовки, можуть натомість використати ключ доступу Syntra: Authorization: Bearer syn_…. Наприклад, Claude Code з ключем: claude mcp add --transport http syntra https://syntra.tymko.tech/mcp --header "Authorization: Bearer syn_…". Ключі простору видають власники й адміністратори в налаштуваннях простору на вкладці «API»; будь-який учасник може створити особистий ключ у «Налаштування» → «API-ключі». OAuth-додатки й ключі доступу доступні на плані Enterprise.

Інструменти

Кожне підключення отримує інструменти читання. Інструменти запису з’являються лише на плані Enterprise, якщо для простору ввімкнено запис і ви дозволили «читання і запис» на сторінці згоди. Жоден інструмент нічого не видаляє.

ІнструментЩо робить
list_projectsПроєкти, які ви бачите: код, назва, статус, прогрес, пріоритет, квартал, лідер, дедлайн, департамент, світлофори, відкриті ризики. Лише читання.
get_projectОдин проєкт повністю: опис, бюджет, світлофори, кількість задач за статусами, самі задачі та ризики з планом зниження. Лише читання.
list_tasksЗадачі в усіх ваших проєктах або в одному, спершу нещодавно змінені; фільтри за проєктом, статусом, виконавцем, спринтом чи датою зміни. Лише читання.
list_sprintsСпринти за департаментами: дати, статус, кількість задач і Story Points. Лише читання.
get_sprintОдин спринт повністю: ціль, Story Points, його задачі й графік згоряння (burndown). Лише читання.
whoamiВід імені якого користувача і в якому просторі діє підключення, і яка роль. Лише читання.
create_taskСтворює задачу або баг-репорт у проєкті від вашого імені. Запис.
update_taskЗмінює задачу: назву, опис, статус, виконавця, дедлайн, мітки, Story Points, спринт. Запис.
add_task_commentДодає коментар до задачі; виконавець і лідер проєкту отримують сповіщення. Запис.
create_projectСтворює проєкт з описом, статусом, пріоритетом, кварталом, дедлайном і лідером. Запис.
update_projectЗмінює поля проєкту, світлофори або бюджет. Запис.
add_riskРеєструє ризик у проєкті з його серйозністю і планом зниження. Запис.
update_riskЗмінює текст ризику, серйозність, план зниження або статус (закрити чи відкрити знову). Запис.
create_sprintПланує новий спринт для департаменту. Запис.
update_sprintЗмінює назву, ціль або дати запланованого чи активного спринту. Запис.

Приклади запитів

  • «Які проєкти цього кварталу відстають від графіка і чому?»
  • «Що змінилося в маркетингових проєктах з понеділка?»
  • «Як іде поточний спринт? Покажи графік згоряння і що ще не закрито.»
  • «У кого зараз найбільше прострочених задач?»
  • «Створи баг у проєкті P-117: кнопка оформлення замовлення на iOS нічого не робить, додай кроки відтворення.»
  • «Додай високий ризик у P-131: постачальник може зірвати дату запуску; план зниження — другий постачальник.»

Права доступу

  • Ваші права, і не більше. Асистент діє від вашого імені у вибраному просторі й бачить рівно те, що дозволяє ваша роль; закриті проєкти лишаються прихованими, якщо ви не можете їх відкрити.
  • Читання для кожного учасника. Учасники просторів на будь-якому платному плані (Starter, Business або Enterprise) можуть підключитися й читати.
  • Запис на Enterprise, коли дозволено з обох боків. Інструменти запису працюють лише на плані Enterprise, де суперадмін Syntra ввімкнув для простору запис через MCP (власник просить про це підтримку), а ви вибрали «читання і запис» на сторінці згоди. Інакше підключення працює лише на читання, хоч би що запитував асистент.
  • Жодних видалень. Жоден інструмент не видаляє проєкти, задачі, ризики, спринти чи коментарі.
  • Лише для конектора. Токени, видані Claude і ChatGPT, працюють лише для MCP-підключення, а не для решти API Syntra.
  • Зміни видно. Зміни, зроблені через конектор, з’являються в Syntra під вашим ім’ям — в історії задачі та проєкту і в журналі аудиту.

Приватність і дані

Syntra передає асистенту лише результати інструментів, які він викликає, і лише в межах того, що бачите ви. Syntra не отримує й не зберігає ваші розмови з Claude чи ChatGPT; що асистент робить із результатами інструментів, визначають умови Anthropic або OpenAI для вашого акаунта. Вхід працює через OAuth 2.0 з PKCE: асистент ніколи не бачить вашого пароля від Syntra, а Syntra зберігає лише хеші виданих нею токенів. Подробиці — у політиці конфіденційності, переліку субпідрядників з обробки даних і угоді про обробку даних (DPA).

Як відключити

Видаліть конектор у Claude чи ChatGPT і відкличте згоду в Syntra: «Налаштування» → «API-ключі» → «Мої дозволи». Кожен учасник робить це для свого доступу сам. Після цього refresh-токен асистента одразу перестає працювати, а поточний токен доступу спливає протягом 24 годин. Власник простору також може попросити підтримку вимкнути запис для всього простору.

Якщо щось не працює

«Немає простору, до якого можна підключити цей додаток»

Жоден із ваших просторів не на платному плані, або адреса простору в URL конектора належить простору, учасником якого ви не є. Зверніться до власника простору або підключіться через загальну адресу https://syntra.tymko.tech/mcp.

Асистент каже, що підключення лише на читання

Простір не на плані Enterprise, запис для нього вимкнено або ви дозволили лише читання. Для запису потрібен план Enterprise; попросіть власника, щоб для простору ввімкнули запис, потім відключіться, підключіться знову й виберіть «читання і запис» на сторінці згоди.

У відповідях бракує проєкту

Попросіть асистента виконати whoami: він покаже користувача, простір і роль, з якими працює підключення. Проєктів, які ви не можете відкрити в Syntra, асистент теж не бачить.

Підтримка

Напишіть на support@tymko.tech, вкажіть час, коли виникла проблема, і, якщо можете, назву інструмента, яку показав асистент.