Русский

English

Русский

English

Тема

Tools ​

MCP-сервер Templite экспортирует более 120 tools (точное число на текущей версии — около 140), сгруппированных по доменам. На этой странице — обзор по группам с реальными именами tools. Подробные параметры доступны в встроенных описаниях самого MCP-сервера (MCP inspector или --list-tools).

Конвенции ​

  • Имена tools — snake_case: list_pages, create_block, update_settings.
  • Поля блоков и пользователей — snake_case в payload: button_text, bg_image, phone_label.
  • Слаги — kebab-case (латиница нижнего регистра через дефис): hero-banner, contact-form.
  • block_type_id — integer:
    • 1 — Контент
    • 2 — Медиа
    • 3 — Навигация
    • 4 — Формы
  • update_block_data принимает page_block_id, а не block_id — это экземпляр блока на странице, не сам блок.

Группы ​

Blocks — 7 tools ​

  • list_blocks — Список блоков с фильтрами (тип, search, limit).
  • get_block — Получить блок по ID или slug.
  • create_block — Создать блок (можно сразу передать fields с вложенными children).
  • update_block — Обновить метаданные блока.
  • delete_block — Удалить блок.
  • update_block_code — Обновить код блока: template (Blade), style (SCSS), script (JS).
  • copy_block — Скопировать блок со всеми полями.

Block Fields — 3 tools ​

  • add_block_field — Добавить поле к блоку (с parent_id для вложенных).
  • update_block_field — Изменить поле.
  • remove_block_field — Удалить поле (рекурсивно для array).

Block Tabs & Sections — 8 tools ​

  • create_block_tab, update_block_tab, delete_block_tab, reorder_block_tabs.
  • create_block_section, update_block_section, delete_block_section, reorder_block_sections.

Block Types — 5 tools ​

  • list_block_types, get_block_type, create_block_type, update_block_type, delete_block_type.

Pages — 15 tools ​

  • list_pages, get_page, create_page, update_page, delete_page, copy_page.
  • list_page_blocks, add_block_to_page, update_block_data (по page_block_id!), remove_block_from_page.
  • update_page_block_status — изменить статус блока на странице.
  • toggle_block_cache, invalidate_block_cache — кэш блока на странице.
  • list_block_versions, restore_block_version — версии данных блока на странице.

Page Types — 8 tools ​

  • list_page_types, get_page_type, create_page_type, update_page_type, delete_page_type.
  • add_page_type_attribute, update_page_type_attribute, remove_page_type_attribute.

Templates — 4 tool ​

  • list_templates, get_template, create_template, update_template.

Template Fields — 8 tools ​

  • list_template_fields, add_template_field, update_template_field, remove_template_field.
  • get_template_code, update_template_code.
  • create_template_tab, create_template_section.

Components — 5 tools ​

  • list_components, get_component, create_component, update_component, delete_component.

Actions — 5 tools ​

  • list_actions, create_action, update_action, attach_action, detach_action.

Libraries — 5 tools ​

  • list_libraries, get_library, create_library, update_library, delete_library.

Media — 4 tools ​

  • list_files, get_file, upload_file, delete_file.

Settings (значения) — 2 tools ​

  • get_settings — Полное дерево настроек с значениями.
  • update_settings — Массовое обновление: {key: value} или [{field_id, value}].

Settings structure (Global Fields) — 12 tools ​

CRUD структуры настроек (страницы, секции, поля):

  • list_settings_pages, create_settings_page, update_settings_page, delete_settings_page, reorder_settings_pages.
  • create_settings_section, update_settings_section, delete_settings_section, reorder_settings_sections.
  • create_settings_field, update_settings_field, delete_settings_field.

Cache & Assets — 4 tools ​

  • clear_cache — очистка с scope (all / blocks / global / scss).
  • compile_page_assets — собрать ассеты для одной страницы.
  • compile_all_assets — собрать для всех страниц.
  • rebuild_assets — полный ребилд (clear + compile_all).

Presets — 5 tools ​

  • list_presets, get_preset, create_preset, update_preset, delete_preset.
  • Пресет может быть global (связанная ссылка) или local (шаблон-копия).

Cities — 12 tools ​

  • list_cities, get_city, create_city, update_city, delete_city, reorder_cities.
  • import_cities — bulk-импорт из CSV/TXT.
  • get_city_pages, get_city_page, update_city_page — городские переопределения страниц.
  • materialize_city_page — превратить виртуальный city-вариант в независимую страницу.
  • dematerialize_city_page — обратное действие.

Languages — 7 tools ​

  • list_languages, get_language, create_language, update_language, delete_language.
  • reorder_languages, set_default_language.

Translations — 9 tools ​

  • get_page_translation, save_page_translation — переводы страниц.
  • get_block_translation, save_block_translation — перевод одного блока.
  • get_block_translations, save_block_translations — bulk-операции с переводами блоков на странице.
  • copy_block_from_default — копировать данные блока из дефолтного языка как основу.
  • get_global_translations, save_global_translations — переводы глобальных настроек.

Users — 6 tools ​

  • list_users, get_user, create_user, update_user, delete_user.
  • toggle_user_active.

User Types — 5 tools ​

  • list_user_types, get_user_type, create_user_type, update_user_type, delete_user_type.

User Fields — 5 tools ​

  • list_user_fields, create_user_field, update_user_field, delete_user_field, reorder_user_fields.

Block vs Page Block ​

Ключевая концепция, на которой часто ошибаются:

  • Block — определение блока (шаблон, поля, код). ID — block_id.
  • Page Block — экземпляр блока на конкретной странице с заполненными данными. ID — page_block_id.

При обновлении значений полей конкретного экземпляра используйте update_block_data с page_block_id, а не block_id. Для изменения структуры самого блока (поля, код) — update_block / update_block_code с block_id.

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

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

  • update_block_data принимает page_block_id — экземпляр блока на странице. Для метаданных блока — update_block.
  • add_block_field для вложенных полей требует parent_id родителя (поле типа array).
  • Слаги — латиница нижнего регистра через дефис. block_slug = "hero-banner", не HeroBanner и не hero_banner.
  • Поля — snake_case. button_text, не buttonText.
  • При создании блока через create_block можно сразу передать fields с вложенными children — все создадутся рекурсивно.
  • update_settings принимает либо {key: value}, либо [{field_id, value}]. Сервер сам резолвит ID в ключи.
  • materialize_city_page создаёт независимую страницу — её можно править отдельно от исходника. dematerialize_city_page — обратное действие.
  • set_default_language нельзя применить к удалённому языку. Сначала создайте новый, потом меняйте default.

Связанные разделы ​

Распространяется под лицензией MIT.

Copyright © 2026 Templite