# Taskless для агента, который пишет код

С плагином агент аккуратнее работает с задачами из Taskless: разбирается в задаче до кода, начинает с теста и отчитывается тем, что реально запустил. Правила вашего проекта при этом главнее.

[Установить плагин](https://taskless.ru/mcp#install) [Только MCP](https://taskless.ru/mcp#mcp-only)

## Что получает агент

Восемь коротких инструкций — skills. Агент открывает нужную на своём шаге, а не держит в голове все сразу. По ним же работают дроны нашего роя.

### Вход в задачу

`taskless-start`

Читает задачу и память проекта. Мелкую и ясную делает сразу, сырую возвращает автору с конкретными вопросами.

### Спека и дерево задач

`taskless-shape`

Фичу оформляет спекой на один-три экрана и подзадачами примерно по полчаса: критерии приёмки, оценка, зависимости. Кода в плане нет.

### Сначала тест

`taskless-build`

Критерий приёмки становится первым тестом. Агент видит его красным на текущем коде и только потом пишет код.

### Проверка запуском

`taskless-check`

Сделанное запускает, а не перечитывает. Вывод прогона прикладывает к критерию приёмки.

### Ревью

`taskless-review`

Проходит дифф по классам дефектов: свой — перед сдачей, чужой — когда попросят.

### Сдача

`taskless-ship`

PR со ссылкой на задачу и зелёными обязательными проверками. Задача закрывается после мержа.

### Отладка

`taskless-debug`

Баг начинается с теста, который его воспроизводит. Сначала первопричина, потом исправление.

### По-человечески

`taskless-writing`

Описания PR, комментарии и спеки на русском — без канцелярита и штампов, как пишет человек.

### Хуки

На старте сессии агент получает короткую памятку по работе с задачами. Коммит без слага задачи не блокируется: хук подсказывает, куда слаг вписать. Мерж ждёт зелёных обязательных проверок, а если защита ветки требует ревью — ещё и одобрения.

### Память проекта

Спеки и решения лежат документами в Taskless, в папке проекта. Следующая задача начинается с них, и через месяц видно, почему сделано так, а не иначе.

## Установка

Плагин ставит всё сразу: MCP-сервер, skills и хуки. При первом запросе клиент откроет браузер для входа в Taskless — токены копировать не нужно.

1. `/plugin marketplace add taskless-app/taskless`
2. `/plugin install taskless@taskless-app`

## Если у проекта уже есть свои правила

### Ваши файлы плагин не трогает

Он не пишет в `CLAUDE.md`, `AGENTS.md` и `.claude/`. В репозитории появляется только каталог `taskless-docs/` — или то место под спеки, которое задал проект.

### Правила проекта главнее

С этого начинается каждый skill: где ваши правила расходятся с набором, агент следует проекту. Свой формат коммитов остаётся — слаг задачи можно указать трейлером или в описании PR.

### Спеки живут в Taskless, копия — у вас

Спека — документ в Taskless, его видят все, кто работает над задачей. Копия ложится в `taskless-docs/specs/` вместе с первой подзадачей: спеки лежат рядом с кодом и переживут потерю базы. Правят их в Taskless, копию руками не трогают.

## Только MCP, без плагина

Если плагин ставить не хочется или клиент его не умеет, подключите один MCP-сервер. Задачи, документы и остальные инструменты будут, а skills и хуки приезжают только с плагином.

`https://taskless.ru/api/mcp`

### Claude Code

`claude mcp add --transport http -s user taskless https://taskless.ru/api/mcp`

Флаг -s user подключает сервер во всех ваших проектах. При первом запросе откроется браузер для входа в Taskless.

### Cursor

```
{
  "mcpServers": {
    "taskless": {
      "url": "https://taskless.ru/api/mcp"
    }
  }
}
```

Вставьте в Settings → MCP → Edit JSON. Вход Cursor пройдёт сам.

### Универсальный JSON

```
{
  "name": "taskless",
  "transport": "http",
  "url": "https://taskless.ru/api/mcp",
  "auth": "oauth2"
}
```

Для любого MCP-клиента с OAuth 2.1 и HTTP-транспортом.

## Что доступно

176 инструментов, сгруппированных по направлениям. Список живой: он собирается из реестра сервера, а не переписывается руками.

### Задачи и спринты

Заводит и двигает задачи по статусам, ведёт доски и спринты, оценивает трудозатраты — весь цикл задачи из чата, без переключения в отдельный таск-трекер.

«Заведи задачу на рефакторинг авторизации, оцени часы и назначь на Ваню»

**Полный список**

- `list_tasks` — Задачи и отчёты за период: что закрыто, создано или изменилось — с фильтрами по людям, проектам, статусам и срокам.
- `get_task` — Детали задачи по id ИЛИ slug'у вида PROJ-42.
- `get_task_context` — ВЕСЬ бриф по задаче одним вызовом — начинай работу над задачей с него, а не с шести запросов.
- `get_task_history` — Журнал изменений задачи (TaskActivity) по id ИЛИ slug'у.
- `create_task` — Сначала прочитай \`get_dev_guide\`.
- `update_task` — Обновить задачу.
- `start_task` — Сначала прочитай \`get_dev_guide\`.
- `finish_task` — Сначала прочитай \`get_dev_guide\`.
- `delete_task` — Удаляет задачу в корзину на 30 дней.
- `list_deleted_tasks` — Удалённые задачи (корзина, хранятся 30 дней): кто удалил, когда и когда сотрётся.
- `restore_task` — Вернуть задачу из корзины: id или слаг из list_deleted_tasks.
- `set_acceptance_checks` — Записать критерии готовности задачи — машиночитаемые проверки «команда → чего ждём».
- `report_acceptance_check` — Отчитаться по одной проверке из критериев готовности: passed — прошла, failed — упала, pending — снова не проверялась.
- `set_task_blocker` — Задать или снять порядок между двумя задачами: «A блокирует B».
- `set_task_relation` — Связать две задачи или снять связь — то же, что человек делает в карточке задачи.
- `list_task_roles` — Включённые роли воркспейса и их статусы.
- `set_task_role` — Назначить человека в роль в карточке.
- `clear_task_role` — Снять человека с роли в карточке.
- `add_comment` — Сначала прочитай \`get_dev_guide\`.
- `update_comment` — Отредактировать СВОЙ комментарий к задаче (только автор коммента).
- `delete_comment` — Удалить СВОЙ комментарий к задаче (только автор коммента).
- `toggle_reaction` — Поставить/снять эмодзи-реакцию на комментарий (toggle).
- `accept_suggestion` — Принять предложение со звонка как ЗАДАЧУ (kind=task_create).
- `update_suggestion` — Исправить предложение со звонка.
- `list_sprints` — Список спринтов борда.
- `create_sprint` — Создать спринт в борде.
- `update_sprint` — Обновить спринт (название, цель, даты).
- `start_sprint` — Запустить спринт (перевести в active).
- `complete_sprint` — Завершить активный спринт.
- `delete_sprint` — Удалить спринт (только planned или не-завершённые).
- `list_boards` — Список бордов (досок задач) в workspace.
- `create_board` — Создать борд задач (канбан-доску).
- `update_board` — Обновить борд.
- `delete_board` — Убрать доску, которая больше не нужна: задачи остаются в проектах, уходит только сама доска.
- `create_workflow_state` — Заводит НОВУЮ колонку на досках воркспейса — она сразу появляется у всех, кто эти доски смотрит, и в неё становится можно ставить задачи.
- `update_workflow_state` — Переименовывает колонку доски и/или меняет её цвет и категорию.
- `reorder_workflow_states` — Меняет порядок колонок на досках слева направо.
- `delete_workflow_state` — УДАЛЯЕТ колонку доски и ПЕРЕНОСИТ все её задачи в другую колонку (reassignTo) — одной транзакцией, ни одна задача не остаётся без статуса.
- `list_labels` — Список лейблов воркспейса.
- `create_label` — ВОРКСПЕЙС: workspaceId передавай ЯВНО.
- `delete_label` — Удалить лейбл воркспейса.
- `update_label` — Переименовать/перекрасить лейбл (rename/recolor).

### Документы и заметки

Пишет и правит спеки прямо из диалога, управляет доступом (кто читает, кто комментирует, кто редактирует), делится наружу публичной ссылкой или по почте. Читает и заводит заметки — личные и те, что остались от созвонов.

«Собери спеку по этой фиче в документ и открой доступ ревьюеру на комментирование»

**Полный список**

- `create_document` — ВОРКСПЕЙС: workspaceId передавай ЯВНО.
- `get_document` — Прочитать документ по id — ЕДИНСТВЕННЫЙ тул, отдающий содержимое (остальные документные тулы тела не возвращают).
- `update_document` — Обновить документ: title / body / parentId / color (hex #rrggbb, null — снять) / labelIds (полная замена набора тэгов).
- `list_documents` — Список документов.
- `archive_document` — Архивировать (archived=true, по умолчанию) или разархивировать (archived=false) документ.
- `move_document_page` — Переставить страницу внутри книги или перенести её в другую книгу.
- `save_spec` — ВОРКСПЕЙС: workspaceId передавай ЯВНО.
- `attach_document` — Привязать документ к сущности (task|project|user|call).
- `detach_document` — Отвязать документ от сущности.
- `grant_document_access` — Выдать/сменить роль на документ субъекту.
- `revoke_document_access` — Снять доступ субъекту (user|team|workspace) на документ.
- `list_document_access` — Состав доступа документа: явные роли (user/team/workspace) + активные публичные ссылки.
- `create_document_share` — Создать публичную ссылку на документ (открывается без входа): /share/d/<token>.
- `revoke_document_share` — Отозвать публичную ссылку по shareId (из list_document_access / create_document_share).
- `export_document` — Выгрузить документ в файл — markdown, HTML, PDF и другие форматы.
- `send_document` — Отправить документ.
- `append_to_document` — Дописать markdown в КОНЕЦ тела документа.
- `set_document_body` — Заменить тело документа ЦЕЛИКОМ на markdown — прежнее тело пропадает без возврата, дописать в конец можно append_to_document.
- `insert_document_image` — Вставить картинку в КОНЕЦ тела документа.
- `attach_file_to_document` — Вставить файл-вложение (плашка со скачиванием) в КОНЕЦ тела документа.
- `list_notes` — Заметки, которые вам видны: общие и ваши личные — с фильтром по звонку, задаче и статусу.
- `get_note` — Одна заметка целиком — с телом и привязкой; личную отдаёт только её автору.
- `create_note` — Записать заметку по ходу разговора: общую для команды или личную, с привязкой к задаче, проекту или звонку.
- `update_note` — Поправить текст заметки или отбросить её, когда она отработала.

### Звонки, встречи, расшифровки

Читает итоги созвонов по расшифровке — решения, открытые вопросы, кто что сказал — и превращает предложенные на звонке задачи в реальные, без пересмотра записи.

«Что решили на вчерашнем созвоне по продажам — и какие задачи из этого предлагались?»

**Полный список**

- `list_calls` — Звонки воркспейса (последние).
- `list_call_sessions` — Сессии звонка (по callId): кто был (участники), краткий итог, счётчики предложений/заметок.
- `get_call_summary` — Без аргументов — итог последнего звонка, callId — итог этого звонка.
- `export_call_transcript` — Выгрузить ПОЛНЫЙ транскрипт звонка (реплики со спикерами и таймкодами, не итог) в формате txt|md|json|srt|vtt.
- `list_suggestions` — Предложения со звонков (задачи/решения/коммитменты, которые AI извлёк).
- `reject_suggestion` — Отклонить предложение со звонка (status=rejected) — одно (id) или пачкой (ids, до 200).
- `delete_suggestion` — Удалить предложение со звонка насовсем — когда это явный шум и не нужно даже в отклонённых.
- `reopen_suggestion` — Вернуть отклонённое предложение со звонка в pending («Передумать» в интерфейсе): его снова можно править и принять.
- `merge_suggestions` — Слить дубль в другое предложение со звонка — как «Слить» в интерфейсе.
- `undo_suggestion` — Отменить то, что агент воркспейса сделал сам после звонка (autoApplied): снять отпуск, удалить комментарий, отменить встречу (участникам уйдёт отмена).
- `redo_suggestion` — Вернуть отменённое через undo_suggestion: агент воркспейса снова ставит отпуск, комментарий или встречу.
- `list_meetings` — События календаря в \[from, to\] (ISO datetime).
- `create_meeting` — participants — имена, почты или @handle (до 50), сервер сам найдёт людей; время без смещения — по поясу создателя.
- `update_meeting` — Обновить встречу (title, description, startAt, endAt, allDay, visibility, teamId, projectId, участники).

### Деплой и релизы

Катит релиз наравне с человеком: смотрит, какие GitHub Actions workflow'ы привязаны к проекту, и запускает нужный — тегом, веткой или ручным диспетчем — под своим именем в GitHub. Состояние проверок ветки или коммита читает там же, не уходя в консоль за \`gh\`.

«Зарелизь админку версией 1.4.0»

**Полный список**

- `list_project_workflows` — Список GitHub Actions workflow'ов проекта со всеми привязанными репо.
- `dispatch_workflow` — Запустить workflow_dispatch на конкретном GitHub Actions workflow'е.
- `create_tag` — Создать git-тэг в репе (push refs/tags/<fullTag>).
- `create_github_release` — Создать GitHub Release.
- `push_branch` — Создать новую ветку в репе (push refs/heads/<branchName>).
- `list_deployments` — Список деплоев workspace или конкретного проекта с фильтрами по status/environment/времени.
- `get_last_deployment` — Самый свежий деплой проекта (по умолчанию env=prod).
- `get_branch_checks` — СОСТОЯНИЕ ПРОВЕРОК ВЕТКИ ИЛИ КОММИТА — список чеков с исходами, агрегат (success | failure | pending | none) и ссылка на прогон.

### Рой агентов

Оркестрирует параллельных агентов-дронов на задачах: снаряжает прогоны, следит за прогрессом и здоровьем роя, отвечает на вопросы дронов, когда те упираются в решение.

«Запусти рой на все задачи спринта, которые ни от чего не зависят»

**Полный список**

- `swarm_claim_work` — Атомарно взять следующую claimable-задачу СВОЕГО роя и создать прогон (SwarmRun queued + событие spawned).
- `swarm_run_upsert` — Создать или обновить прогон СВОЕГО роя.
- `swarm_run_take` — Взять прогон СВОЕГО роя на КОНКРЕТНУЮ машину (атомарно).
- `swarm_event_append` — Добавить событие/шаг в прогон СВОЕГО роя (step/spawned/pr_opened/stalled/…).
- `swarm_ask` — Задать вопрос оператору от дрона (событие kind=question в СВОЁМ прогоне).
- `swarm_answer` — Ответить на вопрос дрона в СВОЁМ прогоне (событие kind=answer).
- `swarm_heartbeat` — Пульс демона роя — используется автоматически, не вызывается вручную.
- `swarm_command_ack` — Подтверждение демона роя, что команда владельца исполнена, — используется автоматически.
- `swarm_notify` — Отправить нотификацию об аномалии в рое в инбокс владельца.
- `swarm_notify_resolve` — Погасить уведомления роя, чьё условие разрешилось (по тем же ключам).
- `swarm_list_runs` — Прогоны роя агентов и их события — история и статус выполнения задач.
- `swarm_list_hosts` — Машины роя: какие компьютеры на связи, чем заняты, сколько тянут и что обслуживают.
- `swarm_host_forget` — Убрать компьютер из роя — когда его сознательно отключили, а не он замолчал.
- `swarm_host_drain` — Вывести компьютер роя из ротации на обслуживание: новых задач не получает, начатые доводит до конца.
- `swarm_repo_config` — Прочитать конфиг роя для репозитория по его имени (owner/repo).
- `swarm_repo_scout_report` — Разведка репозитория: предложить его разметку — зоны, чем поднять окружение, чем проверять. Применяет человек.
- `swarm_repo_rule_propose` — Правило о репозитории от агента, который об него споткнулся: чем проверять, как поднять окружение, какие тут порядки.
- `swarm_repo_rule_pending` — Правила о репозитории, ждущие решения проверяющего: что предложил агент и почему.
- `swarm_repo_rule_decide` — Решение проверяющего по правилам о репозитории: что записать в карточку репозитория, а что оставить человеку.
- `swarm_zone_note_propose` — Заметка о куске кода от агента, который в нём разбирался: что здесь важно знать и на чём легко споткнуться.
- `swarm_zone_note_pending` — Заметки о коде, ждущие решения проверяющего: что предложил агент и почему.
- `swarm_zone_note_decide` — Решение проверяющего по заметкам о коде: что запомнить на будущее, а что отбросить.
- `swarm_zone_note_confirm` — Агент назвал заметки о коде, которые ему пригодились, — такие держатся в памяти дольше.
- `swarm_host_repo_work` — Брать ли этому компьютеру роя работу по этому репозиторию: клон остаётся на месте, новых задач по нему не приходит.
- `swarm_my_repos` — Репозитории, за которые отвечает рой — по ним компьютер сам находит их клоны у себя.
- `get_swarm_guide` — Полный runbook по управлению роем агентов: как запустить, наблюдать и завершить прогон.
- `set_my_swarm` — Включить/выключить ЛИЧНЫЙ рой дронов (свой флаг User.swarmEnabled).
- `set_swarm_review` — Поменять модель ревьюеров и/или лимит кругов ревью роя.
- `swarm_run_log` — Хвост лога прогона: что агент делал и на чём остановился — с любого компьютера роя.
- `swarm_daemon_log` — Хвост лога роя на выбранном компьютере — когда агент не запустился вовсе.
- `swarm_log_deliver` — Ответ компьютера роя на запрос лога — используется автоматически, не вызывается вручную.
- `swarm_wait_event` — Дождаться следующего события в рое — агент спит внутри вызова, вместо того чтобы опрашивать рой по кругу.
- `swarm_attention` — Что в рое требует человека: вопросы агентов без ответа, PR на решении, застрявшие прогоны, отвалившиеся компьютеры.
- `swarm_host_command` — Отдать команду компьютеру роя: пауза и продолжение, перезапуск, обновление, сколько агентов держать, остановить прогон.
- `swarm_command_status` — Чем закончилась команда компьютеру роя — вызов ждёт исхода, а не «отправил и забыл».
- `swarm_deps_status` — Держит ли прогон зависимость: по каждой ссылке — снята она или ещё ждёт, и почему.

### Поиск по смыслу

Находит нужное по смыслу, даже если точных слов запроса в тексте нет — по задачам, документам, комментариям и расшифровкам звонков разом.

«Где мы обсуждали биллинг, даже если в тексте было „оплата“?»

**Полный список**

- `search` — Глобальный поиск по тексту в workspace (задачи + проекты).
- `search_knowledge` — Семантический поиск ПО СМЫСЛУ (эмбеддинги) по задачам, комментариям, документам и транскриптам звонков.

### Личная память

Записи человека для всех его подключений: Claude Code, Cursor и других, кроме роя. Видит их только он сам — из любого своего воркспейса, не из чужого и не глазами администратора команды.

«Запомни: деплой по пятницам не катим» — «Что я говорил про деплой?»

**Полный список**

- `personal_memory` — Показать состояние личной памяти человека или включить/выключить её после его ответа.
- `remember` — Запомнить утверждение про человека для всех его подключений (Claude Code, Cursor и другие), но не для роя.
- `import_memory` — Принять готовые записи из согласованных человеком файлов.
- `recall` — Вспомнить из личной памяти этого человека: поиск по смыслу среди его записей.
- `forget` — Забыть запись личной памяти.
- `list_memory` — Показать текущие записи личной памяти этого человека.

### Команда и организация

Держит контекст о команде под рукой: кто где, какие проекты и воркспейсы, кто в отпуске, напоминания, активность в чатах, загрузка файлов и картинок.

«Кто сейчас в отпуске и на кого перевесить его задачи?»

**Полный список**

- `who_am_i` — Текущий юзер + дефолтный workspace (lastWorkspaceId из web UI или единственное пространство).
- `list_workspaces` — Все workspace'ы юзера.
- `list_users` — Участники workspace'а.
- `list_workflow_states` — Workflow-статусы (этапы Kanban) в workspace.
- `list_projects` — Проекты в указанном (или дефолтном) workspace.
- `create_project` — ВОРКСПЕЙС: workspaceId передавай ЯВНО.
- `set_project_swarm` — Прочитать или изменить конфиг роя дронов проекта (swarmConfig).
- `update_project` — Обновить проект: имя, описание, видимость и/или родителя (re-parenting).
- `set_project_repos` — Привязать и отвязать репозитории проекта.
- `create_space` — Завести пространство в воркспейсе: владелец и админ всегда, участник — когда это разрешено настройкой.
- `get_project_brief` — Прочитать бриф проекта — что это за проект, из чего состоит, какие в нём конвенции и грабли.
- `update_project_brief` — Дописать/поправить бриф проекта.
- `list_channels` — Каналы воркспейса, которые вам видны, — с поиском по имени: есть ли уже канал под эту тему.
- `create_channel` — Завести новый канал для обсуждения и сразу позвать в него нужных людей.
- `list_messages` — Прочитать переписку в канале: кто что написал, когда и с какими файлами.
- `list_thread` — Прочитать обсуждение под конкретным сообщением — весь тред целиком.
- `send_message` — Написать в канал или ответить в тред — с файлами и упоминаниями, от вашего имени.
- `edit_message` — Поправить своё сообщение в канале — опечатку, ссылку, устаревшую цифру.
- `delete_message` — Удалить своё сообщение из канала.
- `list_posts` — Лента постов воркспейса — то же, что видно на главной.
- `get_post` — Один пост целиком — тело (ProseMirror JSON) и его plain-text-версия без обрезки, авторы, закреплённость.
- `create_post` — Опубликовать пост в ленте воркспейса — «Новость» на главной.
- `update_post` — Поправить пост — правит создатель или админ воркспейса (иначе forbidden).
- `delete_post` — Удалить пост из ленты — мягко: он пропадает из ленты, list_posts и поиска, но строка остаётся в БД, и восстановить его отсюда нечем.
- `pin_post` — Закрепить пост наверху ленты — только владелец или админ воркспейса (иначе admin_only).
- `unpin_post` — Снять закреп — пост возвращается в ленту в хронологическом порядке, сам пост остаётся.
- `list_absences` — Список отсутствий (отпуск/больничный/командировка/отсутствие/блок) воркспейса.
- `set_absence` — Поставить отсутствие: kind (vacation|sick|trip|absent|block), startAt/endAt (ISO datetime), note — опционально.
- `update_absence` — Изменить отсутствие по absenceId: kind (vacation|sick|trip|absent|block)/startAt/endAt/note (простой текст, как в set_absence; note=null очищает описание).
- `clear_absence` — Снять (удалить) отсутствие по absenceId.
- `create_reminder` — ВОРКСПЕЙС: workspaceId передавай ЯВНО.
- `list_reminders` — Список напоминаний: входящие (мне), поставленные мной или все.
- `read_activity` — Активность чатов за период (дефолт 30 дней), сгруппированная по воркспейсам → комнатам → тредам, строго в рамках твоей видимости.
- `upload_file` — ВОРКСПЕЙС: workspaceId передавай ЯВНО.
- `create_upload` — ВОРКСПЕЙС: workspaceId передавай ЯВНО.
- `finalize_upload` — Шаг 2/2 presigned-загрузки: подтвердить залитый по create_upload файл.
- `upload_from_url` — ВОРКСПЕЙС: workspaceId передавай ЯВНО.
- `get_file` — Прочитать вложение по uploadId (id из «Файлы (N):» в get_task, из descriptor'а upload_file/finalize_upload, из вложений коммента).

### Встроенные руководства

Знает, как разобраться самому: гайды по разработке через Taskless, по SSO-интеграции и по русским текстам без канцелярита живут прямо внутри MCP — агент запрашивает их по имени, без внешней документации.

«Прочитай гайд по разработке через Taskless и начни с задачи PRJ-1»

**Полный список**

- `get_dev_guide` — Гайд разработки через Taskless для агента-разработчика: как быть быстрым, экономичным и не переизобретать — Taskless как мозг/память проекта.
- `get_sso_guide` — Гайд по SSO-интеграции: как подключить вход через Taskless в своё приложение.
- `get_writing_guide` — Гайд «по-человечески»: как писать русский текст для людей без ИИ-канцелярита — основная часть и полный каталог маркеров.
- `get_briefing` — Компактный обзор состояния роя и проекта ОДНИМ вызовом — начинай сессию с него вместо дампов list_tasks/состояния демона.

### Наборы инструментов под роль

Инструментов больше сотни, и держать их все перед глазами агенту незачем: подключение выбирает набор под роль — исполнителю полтора десятка вызовов, оркестратору свой. Остальное агент достаёт сам, когда действительно понадобилось.

«Найди инструмент для работы с документами и создай документ по этому обсуждению»

**Полный список**

- `list_tools` — Каталог всех инструментов Taskless и схемы их аргументов — агент находит нужный сам.
- `call_tool` — Вызвать инструмент, которого нет в текущем наборе, — по имени и аргументам.

## Сколько тулов приезжает агенту

### Набор под роль, а не весь реестр

Не все. Сотня схем разом съедает контекст ещё до первой полезной мысли, да и выбрать нужный тул из сотни — отдельная задача, в которой легко промахнуться. Поэтому аккаунт-агент при подключении получает набор под свою роль: исполнителю — полтора десятка вызовов на его цикл (взять задачу, прочитать контекст, отчитаться комментом, приложить скрины, закрыть), оркестратору — постановка, спринты, релизы и Swarm. Остальное не пропадает: в каждом наборе есть `list_tools` и `call_tool` — каталог всего, что аккаунту разрешено, и вызов по имени. Тул подтягивается тогда, когда действительно понадобился.

Человека это не касается: подключаетесь собой — видите весь реестр, как и раньше. Урезанный набор — только у аккаунтов-агентов, и роль можно задать явно, прямо в URL: `https://taskless.ru/api/mcp?role=executor`. Это не про права: роль решает, что показать в списке, а что аккаунту вообще позволено вызвать — по-прежнему его собственный белый список.

## Поставить Swarm

Через MCP вы работаете с Taskless сами. Swarm — обратная сторона: дроны берут задачи из того же трекера, пишут код в отдельных ветках на вашей машине и приносят PR. Ставится четырьмя командами.

```
npm i -g @taskless-app/swarm
swarm install
swarm login
swarm start
```

`swarm install` не советует, а доводит окружение до рабочего: проверяет Node, `claude`, `gh`, Chromium для скриншотов — и ставит то, чего не хватает, спрашивая согласие там, где нужен sudo. `swarm start` уходит в фон, терминал остаётся вам. Подробнее — на [странице Swarm](https://taskless.ru/swarm).

## Авторизация

При первом запросе MCP-клиент сам начинает вход по OAuth: откроется страница `/oauth/authorize`, где вы подтверждаете доступ к своему аккаунту. Токены копировать не нужно, срока годности у них нет — access_token клиент обновляет сам. Сессии видны в настройках профиля, там же их отзывают.

## Если не подключилось

### Клиент получил токены, но не переподключился

**«Got new credentials, but reconnecting failed»** в Claude Code — гонка в клиенте: токены он получил, а переподключиться с первого раза не успел. Обычно хватает полного перезапуска Claude Code. Не помог — пересоздайте конфиг.

```
claude mcp remove taskless
claude mcp add --transport http -s user taskless https://taskless.ru/api/mcp
```

После повторного добавления вход проходит чисто. Если «failed» всё равно, `CLAUDE_MCP_DEBUG=1 claude` покажет подробный лог.

## Подключить свой агент

Нужен аккаунт в Taskless: MCP-сервер работает поверх него, а не отдельно. Свободная регистрация пока закрыта — напишите пару слов о том, чем занимаетесь и на чём пишете.

[Запросить инвайт](mailto:support@taskless.ru?subject=%D0%98%D0%BD%D0%B2%D0%B0%D0%B9%D1%82%20%D0%B2%20Taskless) [Как устроен Swarm](https://taskless.ru/swarm)

MCP-сервер Taskless: HTTP, OAuth 2.1. Токены копировать не нужно, срока годности у них нет. Сессии видны в настройках профиля, там же их отзывают.
