Довідник MCP tools і resources

Віддалений MCP-сервер FormDesigner надає AI-клієнтам інструменти для керування формами, заявками, темами та логікою. Нижче — повний список tools і resources (120 інструментів).

Endpoint: https://mcp.formdesigner.com.ua/v1/mcp

Ресурси MCP

Статичні resources доступні клієнтам із підтримкою resources/read. URI з префіксом formdesigner://.

URI Опис
formdesigner://field-types Каталог типів полів і нотатки щодо використання (html/text не для intro).
formdesigner://form-building-guide Патерни: start page, сторінки, поля, теми, bulk tools, theme у schema.
formdesigner://form-schema JSON Schema для тіла create_form_from_schema.
formdesigner://rule-reference Правила логіки: типи, оператори, дії, приклади.
formdesigner://form/{formId} Структура форми зі сторінками, полями та startPage.

Інструменти документації

Для клієнтів без resources/read (наприклад, ChatGPT Connectors) — ті самі JSON-гайди через tools.

Інструмент Опис
get_form_building_guide Як збирати форми (start page, результати quiz, bulk, теми).
get_form_schema JSON Schema для тіла create_form_from_schema.
get_rule_reference Правила логіки: типи, оператори, дії, приклади.
get_field_type_catalog Усі типи полів, аліаси та нотатки (list_field_types — лише за тарифом).
get_calculation_reference Поле calculation: формула, функції, підрахунок quiz.
get_template_reference inputSchema create_template — name/html на верхньому рівні, не body.
get_form_styling_reference CSS живої форми: theme, змінні --fd-*, customCssCode, селектори DOM.

Bulk-інструменти (FormSchema)

Інструмент Опис
create_form_from_schema Створити форму цілком з JSON FormSchema.
bulk_add_pages Додати кілька сторінок (з вкладеними полями) до форми.
bulk_add_fields Додати кілька полів на сторінки форми одним запитом.
bulk_create_rules Створити кілька правил логіки (fieldKey через idMap).
bulk_create_expressions Задати формули розрахунку для кількох полів.

Форми

Інструмент Опис
list_forms Список форм акаунта.
get_form Форма зі сторінками та полями.
create_form Створити форму.
update_form Оновити налаштування форми.
delete_form Видалити форму.
copy_form Копіювати форму.
list_archived_forms Список архівних форм.
move_form_to_archive Перемістити форму в архів.
restore_form_from_archive Відновити форму з архіву.
assign_form_groups Призначити групи формі.
get_start_page Налаштування intro/welcome екрана (start page).
update_start_page Налаштувати intro/welcome — не поле на сторінці 1.

Сторінки

Інструмент Опис
list_pages Список сторінок форми.
get_page Отримати сторінку.
create_page Створити сторінку.
update_page Оновити сторінку.
rename_page Перейменувати сторінку.
copy_page Копіювати сторінку.
delete_page Видалити сторінку.
reorder_pages Змінити порядок сторінок.
get_page_settings Навігатор: typeView, stepForm, animation тощо.
update_page_settings Увімкнути progress bar: typeView=1 (потрібно 2+ сторінки).

Поля

Інструмент Опис
list_field_types Допустимі типи полів (за тарифом).
list_fields Список полів на сторінці.
get_field Отримати поле.
add_field Додати поле.
update_field Оновити поле.
copy_field Копіювати поле.
delete_field Видалити поле.
reorder_fields Змінити порядок полів.

Варіанти відповідей

Інструмент Опис
list_field_options Список варіантів відповіді поля.
add_field_options Додати варіанти.
update_field_options Оновити варіанти.
delete_field_options Видалити варіант(и).
reorder_field_options Змінити порядок варіантів.

Теми

Інструмент Опис
list_themes Список тем.
get_theme Отримати тему (themeId=0 — системний шаблон).
create_theme_from_template Створити з шаблону з частковими overrides.
create_theme Створити тему (body зливається з системною).
update_theme Оновити тему (підтримується частковий body).
copy_theme Копіювати тему (themeId=0 — клон системної).
delete_theme Видалити тему.
assign_theme_to_form Призначити тему формі.

Заявки та статистика

Інструмент Опис
get_entries Список заявок.
get_entry Одна заявка.
delete_entries Видалити заявки за ID.
delete_all_entries Видалити всі (з опціональним фільтром).
mark_entries_viewed Позначити як переглянуті.
mark_entries_unviewed Позначити як непереглянуті.
mark_all_entries_viewed Позначити всі переглянутими.
mark_all_entries_unviewed Позначити всі непереглянутими.
set_entry_tags Призначити тег заявкам.
export_entries Поставити експорт у чергу (email).
get_entries_settings Налаштування відображення заявок.
update_entries_settings Оновити налаштування заявок.
get_entry_stats_by_date Статистика за датами.
get_entry_stats_by_field Статистика за полем.
get_unviewed_count Кількість непереглянутих.

Теги заявок

Інструмент Опис
list_entry_tags Список тегів.
get_entry_tag Отримати тег.
create_entry_tag Створити тег.
update_entry_tag Оновити тег.
delete_entry_tag Видалити тег.

Правила логіки та формули

Інструмент Опис
list_rules Список правил логіки.
get_rule Отримати правило.
create_rule Створити правило.
update_rule Оновити правило.
copy_rule Копіювати правило.
delete_rule Видалити правило.
list_expressions Список формул полів.
get_expression Отримати формулу.
create_expression Створити формулу.
update_expression Оновити формулу.
delete_expression Видалити формулу.

Flow (логіка переходів)

Інструмент Опис
list_flow_blocks Список блоків flow.
get_flow_block Отримати блок flow.
create_flow_block Створити блок.
update_flow_block Оновити блок.
move_flow_block Перемістити блок.
delete_flow_block Видалити блок.
create_flow_path Створити шлях.
delete_flow_path Видалити шлях.

Мови

Інструмент Опис
list_languages Список мов форми.
get_language Отримати мову.
create_language Додати мову.
update_language Оновити мову.
delete_language Видалити мову.

Модулі інтеграцій

Інструмент Опис
list_integration_module_types Каталог типів модулів.
list_available_modules Каталог доступних модулів.
get_available_module Модуль з каталогу.
list_form_modules Модулі, підключені до форми.
get_form_module Підключений модуль.
get_form_module_by_code Модуль за кодом.
attach_form_module Підключити модуль до форми.
detach_form_module Відключити модуль.
check_form_module Перевірити налаштування модуля.
get_form_module_fields Зіставлення полів модуля.

Набори повідомлень

Інструмент Опис
list_messages Список наборів повідомлень форми (тексти валідації, кнопок, системні рядки).
get_message Отримати набір повідомлень за ID.
get_default_message Стандартні тексти повідомлень (ключ → рядок).
create_message Створити набір повідомлень.
update_message Оновити набір повідомлень.
copy_message Копіювати набір повідомлень.
delete_message Видалити набір повідомлень.

HTML-шаблони

Інструмент Опис
list_templates Список HTML-шаблонів (повертає id).
get_template Отримати html/css шаблону.
create_template Створити шаблон — name і html на верхньому рівні.
bulk_create_templates Створити до 50 шаблонів — templates[] з key → idMap.