Справочник по MCP Birta

Два подключения

https://birta.dev/mcp

npx -y @birta/cli mcp

Проверенные клиенты

Это клиенты, для которых у Birta сейчас есть документация. Актуальные названия пунктов меню и вид конфигурации — в отдельном гайде. Клиент, которого здесь нет, не обязательно несовместим, но этим справочником он не проверен.

Справочник по инструментам

Наборы различаются ровно одним. Онлайн-клиент правит черновик Birta по файлам, потому что передать локальную папку ему нечем. Локальный клиент вместо этого передаёт папки целиком, поэтому пофайловой правки у него нет: файлы меняются на машине и заливаются заново. Всё остальное совпадает, включая публикацию черновика и его выброс.

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

Как работает авторизация

Как проходит сессия

Последовательность вызовов у каждого подключения — от первого отклонённого запроса до живого сайта. Заканчиваются они одинаково: черновик публикуется отдельным вызовом. Тому, кто попросил посмотреть заранее, адрес черновика отдают до этого вызова, и публикация ждёт его слова; в остальном последовательность та же. Здесь описаны протокольные сценарии Birta, а не интерфейс каждого стороннего клиента и не политики рабочих пространств.

POST /mcp without a bearer token
-> Unauthorized; WWW-Authenticate points to protected-resource metadata

dynamic client registration -> HTTP 201
authorization redirect       -> HTTP 302
token exchange               -> HTTP 200
listTools                     -> 32 tools

create_project -> create_version -> write_file
publish_version -> live URL + that version's own review address
GET version address -> that version, for whoever holds the address (the default)
list_version_comments -> the remarks left on that page
create_version -> write_file -> publish_version -> next live version

listTools -> 27 tools
list_projects
-> Authorization is required. The operation was not run.
   Open the returned link, approve access, then call this tool again.

resolve connection request -> HTTP 200, pending
approve installation       -> HTTP 200, approved
list_projects retry        -> success

create_project -> upload_draft({ dir, site_root, project })
-> Draft version 1, at its own address. Nothing is live.
publish_version -> live URL + that version's own review address
list_version_comments -> the remarks left on that page
upload_draft (next round) -> draft version 2 -> publish_version

Совместимость и ограничения

• В папке сайта должен быть index.html в корне.
• HTML, CSS, JavaScript, изображения и поддерживаемые статические файлы работают. Серверной части, базы данных, авторизации на сервере и постоянно работающих процессов нет.
• Одностраничное приложение опубликовать можно. Переходы внутри него должны работать через #: при обычных путях прямой заход и обновление страницы на любом пути, кроме корня, дают «страница не найдена».
• Сайт, опубликованный из отдельно собираемых исходников, нужно обновлять через те же исходники и сборку. Файловые инструменты онлайн-подключения не могут безопасно править сгенерированный результат так, будто это исходный проект.
• Поддержка клиента зависит от его транспорта, OAuth, работы с локальными процессами и настроек рабочего пространства. Поддержка протокола сама по себе не обещает, что заработает любой MCP-клиент.
• Отклонённый пакет не сохраняется: ни черновик, ни живой сайт не меняются. Публикация — всегда отдельный вызов по существующему черновику, так что ничто не выходит в свет как побочный эффект правки.

Что делать, если не работает