MCP-сервер
Подключите Claude, Cursor или любой MCP-клиент к SetFork — списки, прогоны и мастера-эксперты как инструменты.
У SetFork есть удалённый MCP-сервер (Streamable HTTP) — ИИ-агенты работают со списками, прогоняют их шаг за шагом и даже зовут на помощь мастеров-экспертов как с полноценными инструментами.
Адрес
https://setfork.com/api/mcp
Authorization: Bearer sf_…Создайте токен в Настройках → API и доступ по MCP — подробности в разделе API-токены.
Подключение из Claude Code
claude mcp add --transport http setfork https://setfork.com/api/mcp \
--header "Authorization: Bearer sf_YOUR_TOKEN"Или в любом MCP-клиенте с поддержкой удалённых серверов: URL
https://setfork.com/api/mcp, заголовок Authorization: Bearer sf_….
Инструменты
Токен с областью read открывает инструменты чтения; для создания и изменения
нужна область write (см. API-токены). Правка своего списка
всегда называет версию, от которой собрана (baseVersion из get_list): если список
успел уйти вперёд, запись отказывает, а не затирает чужую правку.
Чтение и поиск
| Инструмент | Область | Что делает |
|---|---|---|
search_lists | read | Ищет публичные списки (и ваши приватные) по словам и смыслу — ссылки owner/slug |
get_list | read | Список целиком: все блоки со стабильным bid, номер версии, файлы скилла, ваши неопубликованные правки |
get_script | read | Список как готовый скрипт (sh / ps1 / py); можно взять только нужные пункты |
my_drafts | read | Ваши неопубликованные списки |
my_catalogs | read | Ваши полки — чтобы разложить новый список |
Запись списков
| Инструмент | Область | Что делает |
|---|---|---|
create_list | write | Новый список — черновиком, видным только вам |
bulk_create_lists | write | До 25 списков за вызов; по умолчанию только отчёт, пишет с dryRun:false |
patch_list | write | Точечная правка блоков по bid: изменить, вставить, удалить, переставить. С publish:false правки копятся в черновике |
update_list | write | Замена всего состава: чего нет во входе — исчезает |
publish_draft | write | Накопленные правки — одной версией (сначала отчёт, потом confirm:true) |
discard_draft | write | Выбросить накопленные правки |
publish_lists | write | Опубликовать черновики пачкой (отчёт, потом confirm:true) |
rename_list | write | Сменить адрес списка; прежний адрес ведёт на него навсегда — и страница, и git, и скачивание скилла |
delete_list | write | Удалить список безвозвратно (только с confirm:true) |
Скиллы и релизы
| Инструмент | Область | Что делает |
|---|---|---|
publish_skill | write | Скилл целиком: блоки и файлы scripts/, references/, assets/ одной версией; можно передать исходный SKILL.md. Файлы дополняются, удаляются только явно |
list_releases | read | Релизы списка, новые сверху |
create_release | write | Релиз из версии: git-тег, заголовок, заметки в Markdown (отчёт, потом confirm:true) |
Чужие списки: предложения, задачи, проверки
| Инструмент | Область | Что делает |
|---|---|---|
suggest_edit | write | Предложить правку чужого списка — владелец примет или отклонит |
pending_suggestions | read | Предложения, ждущие вашего решения |
review_suggestion | write | Отзыв на предложение: одобрить или попросить изменений |
apply_suggestion / merge_suggestion | write | Принять предложение в свой список |
revert_suggestion | write | Откатить принятое предложение |
report_check | write | Результат внешней проверки предложения (как статус CI) |
search_issues / get_issue | read | Задачи списка и их обсуждение |
create_issue / add_issue_comment | write | Завести задачу, ответить в ней |
close_issue / reopen_issue | write | Закрыть с исходом (сделано / не будет / дубль) или переоткрыть |
Прогоны и источники
| Инструмент | Область | Что делает |
|---|---|---|
start_run | write | Начать (или продолжить) прогон списка |
check_step | write | Отметить шаг: выполнен / не выполнен / заблокирован с причиной |
get_run | read | Прогон: шаги с отметками и общий прогресс |
report_run | write | Отчёт о проверке версии прогоном — поднимает уровень проверки |
register_source / list_sources | write / read | Внешние источники знаний для списков |
Мастера мастерской
| Инструмент | Область | Что делает |
|---|---|---|
list_gnomes | read | Ростер мастеров-экспертов: id, имя, домены, в чём силён каждый — зовите первым |
ask_gnome | write | Вопрос одному мастеру в его специальности (совет, набросок, критика); можно приложить список как контекст |
gnome_review | write | Мастер гильдии ревьюит существующий список по кодексу гильдии и возвращает конкретные правки |
council_draft | write | Собирает полный совет мастеров по теме (распорядитель → эксперты → критик → старейшина); возвращает draftId |
get_council_draft | read | Опрашивает состояние совета: статус, ход обсуждения (кто из мастеров что сказал) и варианты-кандидаты |
ask_gnome, gnome_review и council_draft тратят вашу ИИ-квоту — как
генерация на сайте, — и поэтому требуют токена со скоупом write: тратить
деньги это не чтение. Быстрый ответ одного эксперта — ask_gnome; полноценный
список из спора нескольких — council_draft (1–4 минуты, опрашивайте
get_council_draft раз в ~20 с).
Правила безопасности те же, что и в интерфейсе: новые списки агент создаёт
черновиками, а всё, что выходит наружу или необратимо (публикация, релиз,
удаление), идёт в два шага — сначала отчёт, потом confirm:true, чтобы клиент
мог спросить человека. Менять список может только владелец или соавтор.
Зачем это нужно
Агенты умеют читать канонические списки («возьми командный ранбук по деплою и
следуй ему»), исполнять их с отметкой прогресса (start_run → check_step),
создавать новые («преврати этот разбор инцидента в переиспользуемый чек-лист и
сохрани черновиком на вычитку») и советоваться с профильным мастером, не выходя
из своего рабочего окружения.