Formhaus — MCP-сервер для Claude Code: что делает и как установить
Проверяет схемы форм Formhaus на валидность и прогоняет многошаговые сценарии через движок @formhaus/core. Работает локально, без учётной записи.
MIT ★ 8 обновлён 2026-10-24
claude mcp add formhaus -- npx -y @formhaus/mcpЧто делает Formhaus
Сервер подключает десять инструментов: validate_definition находит ошибки в JSON-схеме формы и возвращает патчи для автоматического исправления; fix_definition применяет безопасные исправления сразу; simulate_path прогоняет заполнение формы с заданными ответами, показывает видимые поля на каждом шаге, ошибки валидации и итоговые значения для отправки. capabilities описывает типы полей, правила и операторы условий. Три инструмента — translation_template, example_definitions и capabilities — дают справку.
Остальные пять инструментов (publish_form, list_forms, get_submissions, update_form_settings, get_webhook, reveal_webhook_secret) работают с Formhaus Cloud через https://api.formhaus.dev. Для них нужен ключ FORMHAUS_API_KEY в окружении сервера: добавь его в поле env в .mcp.json или claude_desktop_config.json, затем перезапусти сервер. Ключ аккаунта (fh_live_...) открывает доступ ко всем формам и всем шести инструментам, агентский ключ (fh_agent_...) — только к формам, которые он создал, и для трёх последних инструментов всё равно нужен аккаунт-ключ. Без ключа publish_form создаст форму и вернёт агентский ключ один раз.
Требует Node 22.12 или новее. Симулятор не запускает кастомные валидаторы, onStepValidate и lifecycle-хуки.
Какие задачи решает
- проверить JSON-схему формы и получить список исправлений
- прогнать заполнение многошаговой формы с тестовыми данными
- опубликовать форму в Formhaus Cloud и получить endpoint
- получить список отправленных форм через API
- сгенерировать шаблон для перевода формы на другой язык
Примеры запросов агенту
- Проверь схему формы из
contact.jsonи примени все безопасные исправления - Прогони форму из
survey.jsonс ответами{"kind": "business"}до конца - Опубликуй форму из
feedback.jsonв Formhaus Cloud
Как установить Formhaus
Командой платформы
claude mcp add formhaus -- npx -y @formhaus/mcpКомандой платформы
codex mcp add mcp -- npx -y @formhaus/mcpФайл настроек
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@formhaus/mcp"
]
}
}
}Файл настроек
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@formhaus/mcp"
]
}
}
}Командой платформы
gemini mcp add mcp npx -y @formhaus/mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Formhaus
Как установить Formhaus в Claude Code?
Выполни claude mcp add formhaus -- npx -y @formhaus/mcp в терминале.
Что делает Formhaus?
Проверяет схемы форм Formhaus на ошибки, прогоняет многошаговые сценарии заполнения и публикует формы в Formhaus Cloud через API.
Нужен ли ключ API для локальной проверки форм?
Нет, validate_definition, fix_definition, simulate_path, translation_template, capabilities и example_definitions работают офлайн без ключа. Ключ нужен только для инструментов, которые обращаются к Formhaus Cloud.