Подключение Syntra к Claude и ChatGPT
Коннектор Syntra позволяет Claude и ChatGPT работать с вашим пространством Syntra через открытый протокол Model Context Protocol (MCP). Спрашивайте о проектах, задачах, рисках и спринтах обычными словами, а там, где пространство это разрешает, ассистент может создавать и обновлять их за вас.
Требования
- Аккаунт Syntra, который состоит в пространстве на платном плане: Starter, Business или Enterprise. Чтение через Claude и ChatGPT доступно на любом платном плане; запись — на плане Enterprise, вместе с API и webhooks. Подробнее — на странице тарифов.
- 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 и в мобильных приложениях.
- Найдите Syntra.В Claude откройте Customize (или Settings) → Connectors, найдите Syntra и нажмите Connect. Можно также сразу открыть страницу Syntra в каталоге.
- Войдите в Syntra.Откроется окно Syntra; войдите со своим аккаунтом Syntra (и вторым фактором, если он включён).
- Выберите пространство и разрешите доступ.На странице согласия указаны приложение (Claude, claude.ai), ваш пользователь, права и адрес, куда вас вернут. Если вы состоите в нескольких пространствах, выберите одно и нажмите «Разрешить».
- Спрашивайте.В новом чате спросите о своих проектах. Claude вызывает инструменты Syntra и показывает каждый вызов.
Claude Code подключается так же: claude mcp add --transport http syntra https://syntra.tymko.tech/mcp, затем выполните /mcp, чтобы войти.
Подключение в ChatGPT
- Добавьте собственный MCP-сервер.В ChatGPT откройте Plugins (Settings → Apps), нажмите Add, затем Add custom MCP server. Укажите URL
https://syntra.tymko.tech/mcpи выберите аутентификацию OAuth. - Войдите и разрешите доступ.ChatGPT представляется сам, поэтому в Syntra ничего регистрировать не нужно. Войдите в Syntra, выберите пространство и нажмите «Разрешить» на той же странице согласия, что и для Claude; приложение там названо ChatGPT (chatgpt.com).
- Используйте в чате.Упомяните 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 | Меняет название, цель или даты запланированного или активного спринта. Запись. |
Примеры запросов
- «Какие проекты отстают от графика в этом квартале и почему?»
- «Что изменилось в маркетинговых проектах с понедельника?»
- «Как идёт текущий спринт? Покажи burndown и что ещё открыто.»
- «У кого сейчас больше всего просроченных задач?»
- «Создай баг в проекте 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, укажите время, когда возникла проблема, и, если возможно, название инструмента, которое показал ассистент.