Webiny MCP — Установка & Живое демо

Name: Webiny MCP MCP Server
Author: webiny

Зачем использовать

Ключевые функции

Инструменты для моделей контента, записей, страниц, файлов, форм — все редакционные поверхности
Auth через personal access token с привязкой к окружению
Поддержка мультитенантности (URL cms-manage содержит locale + tenant)
Чтение и запись — Claude может публиковать, а не только просматривать
Self-hosted serverless на AWS — ваши данные не покидают аккаунт

Живое демо

Как выглядит на практике

webiny-mcp.replay ▶ готово

0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "webiny-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@webiny/mcp-server",
        "--api-url",
        "https://your-project.cloudfront.net/cms/manage/en-US",
        "--token",
        "${WEBINY_TOKEN}"
      ]
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "webiny-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@webiny/mcp-server",
        "--api-url",
        "https://your-project.cloudfront.net/cms/manage/en-US",
        "--token",
        "${WEBINY_TOKEN}"
      ]
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "webiny-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@webiny/mcp-server",
        "--api-url",
        "https://your-project.cloudfront.net/cms/manage/en-US",
        "--token",
        "${WEBINY_TOKEN}"
      ]
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "webiny-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@webiny/mcp-server",
        "--api-url",
        "https://your-project.cloudfront.net/cms/manage/en-US",
        "--token",
        "${WEBINY_TOKEN}"
      ]
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "webiny-mcp",
      "command": "npx",
      "args": [
        "-y",
        "@webiny/mcp-server",
        "--api-url",
        "https://your-project.cloudfront.net/cms/manage/en-US",
        "--token",
        "${WEBINY_TOKEN}"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

{
  "context_servers": {
    "webiny-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@webiny/mcp-server",
          "--api-url",
          "https://your-project.cloudfront.net/cms/manage/en-US",
          "--token",
          "${WEBINY_TOKEN}"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add webiny-mcp -- npx -y @webiny/mcp-server --api-url https://your-project.cloudfront.net/cms/manage/en-US --token ${WEBINY_TOKEN}

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: Webiny MCP

Создать новую модель контента по описанию

👤 Разработчики Webiny / контент-инженеры ⏱ ~25 min intermediate

Когда использовать: PM говорит «нам нужен раздел Case Studies с такими-то полями». Хочется, чтобы Claude перевёл это в модель Webiny.

Предварительные требования

Запущенный проект Webiny — npx create-webiny-project, развёрнутый на AWS
Personal access token — Создать в Admin → Settings → Personal Access Tokens

Поток

Подключить MCP

Добавь Webiny MCP, используя manage API URL для окружения dev. Проверь, что можно получить список существующих моделей.✓ Скопировано

→ list_models возвращает как минимум встроенные модели
Создать модель

Создай модель контента CaseStudy с полями: title (text, required), client (text), summary (rich text), heroImage (file ref), publishedAt (datetime), tags (text, multi). Единственное число — «Case Study», множественное — «Case Studies».✓ Скопировано

→ create_content_model вызвана один раз; ID полей используют camelCase последовательно
Добавить тестовые записи

Теперь добавь 3 записи-заглушки, чтобы у редакционной команды было что посмотреть.✓ Скопировано

→ 3 записи созданы через create_entry с реалистичным placeholder-содержимым

Итог: Рабочая модель с тестовыми данными, готовая для редакционной команды за минуты — без кликов в интерфейсе.

Подводные камни

ID полей случайно содержат пробелы — Webiny их отвергает; MCP нормализует, но всегда проверяй перед отправкой
Неверный locale в URL — URL содержит /en-US/ — используй свой locale по умолчанию

Сочетать с: filesystem

Массово обновить записи для исправления опечатки в 200 статьях

👤 Команда контент-операций ⏱ ~30 min intermediate

Когда использовать: Юристы нашли неправильное название компании в старых записях; не хочется кликать 200 раз.

Поток

Найти затронутые записи

Webiny: поищи записи CaseStudy, содержащие «Acme Corp» в поле summary. Перечисли ID.✓ Скопировано

→ search_entries возвращает все совпадающие ID
Dry-run замены

Для каждой предложи новый summary с заменой «Acme Corp» на «Acme Inc.» Покажи сначала 3 примера.✓ Скопировано

→ 3 дифа показаны до любой записи
Применить

Выглядит правильно. Примени изменение ко всем совпадающим записям и переопубликуй их.✓ Скопировано

→ update_entry + publish_entry вызваны для каждой с прогресс-счётчиком

Итог: Сотни записей исправлены и переопубликованы в одном разговоре с audit trail.

Подводные камни

Автоматическая публикация пропускает ревью — Используй draft + APW workflow — не публикуй массовые правки напрямую в production

Создать лендинг в Page Builder по брифу

👤 Маркетинговые разработчики ⏱ ~20 min intermediate

Когда использовать: Есть текст и нужно добавить его в Page Builder Webiny без перетаскивания блоков.

Предварительные требования

Существующие шаблоны блоков — Иметь хотя бы блоки Hero, Features, CTA

Поток

Составить страницу

Создай страницу Page Builder с заголовком «Q2 Launch», используя блоки Hero + 3 Features + CTA. Наполни содержимым из /briefs/q2.md.✓ Скопировано

→ create_page возвращает URL черновика
Предпросмотр и публикация

Открой URL черновика. После одобрения опубликуй.✓ Скопировано

→ publish_page успешно; страница живая

Итог: Маркетинговый лендинг собран и опубликован за ~10 минут.

Подводные камни

Несоответствие схемы блока — Всегда сначала запускай list_block_templates для проверки доступных вариантов

Сочетать с: filesystem

Комбинации

Сочетайте с другими MCP — эффект x10

webiny-mcp + filesystem

Взять бриф из локального Markdown и поместить его в Webiny как текст страницы

Прочитай /briefs/q2.md, затем создай страницу Webiny с блоками Hero + Features + CTA с содержимым из брифа.✓ Скопировано

webiny-mcp + github

Открыть PR с изменениями модели после того как Claude спроектировал их

Webiny: создай модель CaseStudy. GitHub: открой PR с добавлением модели в seed-конфиг.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
list_content_models	(нет)	Исследование	1 GraphQL-вызов
create_content_model	name, fields[]	Создание нового раздела	1 вызов
search_entries	model, query, filter?	Найти затронутые элементы	1 вызов
create_entry	model, data	Запись одного элемента	1 вызов
update_entry	id, data	Редактировать существующий	1 вызов
publish_entry	id	Перевести черновик в живой	1 вызов
list_block_templates	(нет)	Перед составлением страниц	1 вызов
create_page	title, blocks[]	Создание в Page Builder	1 вызов

Стоимость и лимиты

Во что обходится

Квота API: Ограничено лимитами AWS-аккаунта (Lambda concurrency, DynamoDB throughput)
Токенов на вызов: 200–3000 в зависимости от размера записи
Деньги: Webiny — бесплатный OSS; применяется счёт AWS
Совет: Массовые операции создают fanout — установи лимиты Lambda concurrency, если не хочешь скачков стоимости

Безопасность

Права, секреты, радиус поражения

Минимальные скоупы: personal-access-token с правами чтения/записи контента

Хранение учётных данных: Токен в переменной окружения; ротация через интерфейс администратора

Исходящий трафик: Только ваш AWS CloudFront/API Gateway endpoint

Никогда не давайте: delete-environment tenant-admin

Используй токен для конкретного окружения; никогда не переиспользуй production-токен для dev-работы

Устранение неполадок

Частые ошибки и исправления

401 Unauthorized

Токен просрочен или неверное окружение. Сгенерируй новый PAT в интерфейсе администратора

Проверить: curl -H 'Authorization: Bearer $TOKEN' $URL

Ошибка валидации поля

Типы полей должны совпадать точно — text vs rich-text vs long-text. Используй list_content_models для проверки схемы

Lambda timeout при массовой операции

Обрабатывай пачками по 50; MCP не пагинирует записи автоматически

Альтернативы

Webiny MCP в сравнении

Альтернатива	Когда использовать	Компромисс
Strapi MCP	Используешь Strapi, а не Webiny	Другая CMS; другая история деплоя (контейнеры vs serverless)
Contentful MCP	SaaS CMS вместо self-host	Vendor lock-in; не OSS

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills