MCP-сервер TTracker

Доступ

Тариф с фичей или покупка отдельно

Канал открывается только если в лицензии организации есть фича MCP-сервер. Два пути:

• выбрать тариф, где возможность уже включена;
• оставить текущий тариф и докупить фичу отдельно.

Без фичи вкладки «MCP» нет, ключ выпустить нельзя, вызовы на /mcp отклоняются. MCP-канал взаимодействия ограничен функциональностью, затрагивающей только задачи и не позволит проводить какие-либо финансовые операции (оплата, возврат итп.).

Смотреть тарифы · после оплаты администратор организации выпускает ключ в Настройки → MCP.

Инструменты

Что умеет сервер

Фиксированный набор из 26 методов. Файлы, кадры, шаблоны, отчёты и любые денежные операции в каталог не входят. Список методов клиент всегда видит целиком; отказ — в конкретном вызове, по правам сотрудника.

• session_whoamiКто вызвал канал: сотрудник, роли, организация и режим доступа. Без счетов и сумм.
• tasks_listСписок задач как в UI. Фильтры: статус, тип, приоритет, поиск, просрочка, объект (включая дочерние), заказчик. pageSize не больше 100.
• tasks_getКарточки по номерам (1–100 за вызов). В карточке — editableFields и actions для текущего состояния. Комментарии, аудит и связанные — только по флагам.
• task_changeМеняет данные карточки. Пустые поля не трогает. Какие поля можно менять — editableFields из tasks_get. labels=[] снимает метки.
• task_actionНажимает кнопку верхней панели карточки. Доступные id — actions из tasks_get. Комментарий обязателен, если в actions указано comment=required.
• task_types_listКаталог типов задач. includeArchived=true добавляет архивные.
• task_types_createСоздаёт тип. Нужен org-admin. Цвет и шаблон номера — по умолчанию, как в UI.
• task_types_updateМеняет тип по id. Пустые поля не трогает.
• task_types_archiveАрхивирует тип по id. Задачи с этим типом остаются.
• task_types_unarchiveВозвращает тип из архива по id.
• task_types_deleteУдаляет тип без задач и шаблонов. Иначе архивируйте.
• task_priorities_listКаталог приоритетов. includeArchived=true добавляет архивные.
• task_priorities_createСоздаёт приоритет. Нужен org-admin.
• task_priorities_updateМеняет приоритет по id. Пустые поля не трогает.
• task_priorities_archiveАрхивирует приоритет по id. Сначала снимите дефолт.
• task_priorities_unarchiveВозвращает приоритет из архива по id.
• task_priorities_deleteУдаляет приоритет без задач и шаблонов. Иначе архивируйте.
• task_labels_listМетки задач. Опциональный поиск.
• employees_assignableСотрудники, которых можно назначить на задачу.
• tasks_createСоздаёт задачу без файлов. Повторный вызов создаёт новую задачу. start=true берёт её в работу. Можно задать родителя, приоритет, объект и слот работ.
• tasks_commentТекстовый комментарий к задаче. Вложения не принимаются.
• tasks_startВзять задачу в работу по номеру.
• tasks_submitСдать задачу по номеру. Комментарий необязателен.
• tasks_reviewПринять или вернуть задачу по номеру. Комментарий необязателен.
• objects_listКаталог объектов обслуживания. Поиск по имени, коду и адресу. Архивные — по флагу, страницами.
• customers_listКаталог заказчиков. Архивные — по флагу, страницами.

Запуск

Ключ и адрес

1. Администратор организации открывает Настройки → MCP.
2. Выпускает ключ: имя (например Cursor), сотрудник, чей контекст будет у агента, необязательный срок.
3. Секрет показывается один раз. Сохраните его. Повторно увидеть нельзя — только отозвать и выпустить новый.
4. В harness указываются URL организации и заголовок Authorization: Bearer <секрет>.

Адрес канала: https://<slug>.ttracker.pro/mcp. Тенант берётся из хоста, не из токена: тот же секрет на чужом slug не сработает. Права вызова — права привязанного сотрудника, не того, кто выпустил ключ. Отзыв действует сразу. До 20 действующих ключей на организацию, 120 запросов/мин на ключ, 600 на организацию.

Harness

Cursor, Claude и остальные

Протокол — Streamable HTTP, без сессии. Подойдёт любой клиент, который ходит на удалённый MCP по HTTP и умеет передать Bearer. Ниже — готовые фрагменты; подставьте slug и секрет из настроек.

Cursor

MCP → Add new MCP server либо файл конфигурации клиента:

{
  "mcpServers": {
    "ttracker": {
      "url": "https://<slug>.ttracker.pro/mcp",
      "headers": {
        "Authorization": "Bearer ВАШ_СЕКРЕТ"
      }
    }
  }
}

Claude Desktop

Тот же смысл, поле type: http:

{
  "mcpServers": {
    "ttracker": {
      "type": "http",
      "url": "https://<slug>.ttracker.pro/mcp",
      "headers": {
        "Authorization": "Bearer ВАШ_СЕКРЕТ"
      }
    }
  }
}

Claude Code и другие CLI

Транспорт HTTP, то же URL и заголовок. Пример:

claude mcp add --transport http ttracker https://<slug>.ttracker.pro/mcp \
  --header "Authorization: Bearer ВАШ_СЕКРЕТ"

VS Code, Copilot, OpenAI, Grok, DeepSeek

В harness, который принимает удалённый MCP, достаточно URL https://<slug>.ttracker.pro/mcp и заголовка авторизации. Формат файла у каждого клиента свой — суть одна: HTTP-сервер TTracker, секрет в Bearer, без отдельного локального процесса.

Секрет не вставляйте в публичный чат и не коммитьте в репозиторий. Если ключ засветился — отзовите его во вкладке MCP.