MCP: Woove Site в Claude и Cursor

Ключ API, подключение Claude Code, Cursor и Claude Desktop, список инструментов

MCP (Model Context Protocol) — способ дать ИИ-помощнику инструменты. Сервер Woove отдаёт Claude Code, Cursor, Claude Desktop и другим MCP-клиентам инструменты Woove Site: сайты, страницы, блоки Woove Zero на Zero-языке, секции из библиотеки, публикацию и сборку по макету. Помощник собирает сайт из чата, а вы правите результат в кабинете.

Ключ API

«Аккаунт» → «Ключи API и MCP» → название → «Создать ключ». Ключ показывается один раз, сразу скопируйте его.

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

Подключение

Адрес сервера: https://woove.ru/mcp, транспорт Streamable HTTP. Ключ принимается тремя способами: заголовком Authorization: Bearer wv_КЛЮЧ, заголовком X-Api-Key: wv_КЛЮЧ, параметром адреса ?key=wv_КЛЮЧ. Последний способ для клиентов, которые не умеют задавать заголовки.

В Claude Code сервер добавляется одной командой. Добавьте к ней --scope user, чтобы он был во всех проектах, и проверьте список командой claude mcp list.

claude mcp add --transport http woove https://woove.ru/mcp --header "Authorization: Bearer wv_ВАШ_КЛЮЧ"

• Cursor, Windsurf — В файле ~/.cursor/mcp.json: { "mcpServers": { "woove": { "url": "https://woove.ru/mcp", "headers": { "Authorization": "Bearer wv_ВАШ_КЛЮЧ" } } } }
• VS Code — В файле .vscode/mcp.json: { "servers": { "woove": { "type": "http", "url": "https://woove.ru/mcp", "headers": { "Authorization": "Bearer wv_ВАШ_КЛЮЧ" } } } }
• Claude Desktop — Через мост mcp-remote в claude_desktop_config.json: { "mcpServers": { "woove": { "command": "npx", "args": ["-y", "mcp-remote", "https://woove.ru/mcp", "--header", "Authorization: Bearer wv_ВАШ_КЛЮЧ"] } } }
• Клиент без заголовков — Ключ в адресе: https://woove.ru/mcp?key=wv_ВАШ_КЛЮЧ. Так же подключается mcp-remote: npx -y mcp-remote "https://woove.ru/mcp?key=wv_ВАШ_КЛЮЧ". Адрес с ключом остаётся в файлах настроек и в истории команд, поэтому храните его как пароль.
• Проверка — Попросите помощника: «покажи мои сайты в Woove». Он вызовет whoami или list_sites и перечислит их.

Инструменты

• whoami — Почта аккаунта, число сайтов, открыт ли конструктор. Проверка связи.
• list_sites, site_url — Сайты аккаунта и их адреса.
• list_pages, get_page, create_page — Страницы с блоками; новая пустая страница.
• zero_reference — Справочник Zero-языка — помощник читает его перед первым блоком.
• create_zero_block, update_zero_block, get_block — Блок Woove Zero из текста на Zero-языке, его правка и чтение.
• neiro_zero_block — Блок словами или по макету (ссылка на картинку, base64, PDF) силами Woove Neiro.
• page_from_mockup — Целая страница по макету: Neiro режет его на блоки.
• list_library, add_library_section, update_section_fields — Готовые секции Woove Blocks: найти, поставить на страницу, поменять тексты.
• set_page_blocks — Порядок блоков на странице, убрать блок.
• publish_page — Опубликовать страницу или отправить правки на сайт.

Если не подключается

Проверьте ключ одной командой в терминале. Сервер ответит почтой аккаунта и числом инструментов, а на чужой или отозванный ключ вернёт 401 с подсказкой.

curl "https://woove.ru/mcp?ping=1&key=wv_ВАШ_КЛЮЧ"
{"ok":true,"account":"vy@pochta.ru","tools":17}

• Ключ из другого аккаунта — В ответе стоит чужая почта или приходит 401. Создайте ключ в том аккаунте, где лежат сайты: «Аккаунт» → «Ключи API и MCP».
• Лишние пробелы и кавычки — Заголовок целиком выглядит так: Authorization: Bearer wv_КЛЮЧ. Кавычки из файла настроек в значение заголовка попадать не должны, пробел после Bearer один.
• Адрес без https — Сервер живёт на https://woove.ru/mcp. По http клиент получает переадресацию и часть клиентов теряет на ней заголовок с ключом.
• Старый клиент — Нужна поддержка транспорта Streamable HTTP. Клиенты со старым транспортом SSE подключаются через мост mcp-remote.
• Ключ отозван — Удалённый ключ перестаёт работать сразу. Список ключей и дата последнего обращения видны в разделе «Ключи API и MCP».

Что просить помощника

«Собери в Woove для сайта 12 страницу «Услуги»: обложка, три карточки услуг с ценами, форма записи, опубликуй». «Возьми макет по ссылке … и собери из него главную сайта 12». «На странице 240 замени обложку на тёмную из библиотеки и поменяй заголовок на …».

Помощник видит только ваши сайты, а секции и Zero-язык описаны в самих инструментах. Правки Neiro (neiro_zero_block, page_from_mockup) тратят лимит правок по тарифу, остальные инструменты бесплатны. Изменения попадают на сайт после publish_page, до этого они лежат в черновике.

Если не работает