FAQ
Что нужно для подключения MCP Connector?
Зарегистрируйтесь в FormDesigner, создайте OAuth-приложение со scope forms и добавьте URL MCP-сервера в AI-клиент. Пошаговые инструкции — в разделе help/mcp и в инструкции по OAuth-приложению.
Какие AI-клиенты поддерживаются?
Claude.ai, Claude Code, Cursor, ChatGPT и другие клиенты с поддержкой MCP или custom connectors.
Чем AI-ассистент отличается от MCP Connector?
AI-ассистент — встроенный инструмент в личном кабинете FormDesigner. MCP Connector подключает FormDesigner к внешним AI-клиентам (Claude, Cursor, ChatGPT) через OAuth.
Какой URL у MCP-сервера?
Используйте https://mcp.formdesigner.ru/v1/mcp. Старый путь /mcp возвращает 404 — обновите URL в Cursor, Claude.ai и скриптах на /v1/mcp.
Запрос к /v1/mcp возвращает 401
Проверьте OAuth-токен или заголовки X-Client-Id / X-Client-Secret. Без credentials сервер вернёт 401 с WWW-Authenticate и ссылкой на discovery.
Какие OAuth scopes нужны для MCP?
Обязателен scope forms. При необходимости добавьте account и entries для расширенных операций.
Когда использовать OAuth, а когда client credentials?
OAuth (authorization code + PKCE) — для Claude.ai и Claude Code без секретов в конфиге. Client credentials (заголовки X-Client-Id / X-Client-Secret) — для Cursor, скриптов и автоматизаций. Включите useClientCredentials в OAuth-приложении для header auth.
Как долго хранятся MCP-сессии?
Временные MCP-сессии хранятся не более 1 часа.
Как отозвать доступ?
Удалите OAuth-приложение в профиле аккаунта или отключите connector в AI-клиенте.
Чем MCP отличается от REST API?
MCP — протокол для AI-ассистентов с ~100 инструментами и встроенными гайдами. REST API — для backend-интеграций с OpenAPI. См. справочник tools и resources.
Что такое FormSchema?
Инструмент для создания или обновления формы целиком из JSON одним вызовом — удобно для AI-агентов.
Сколько tools доступно в MCP Connector?
Около 100 инструментов: формы, поля, заявки, темы, логика, flow, языки, модули интеграций и др.
Где посмотреть полный список tools?
Публичный каталог — на https://formdesigner.ru/mcp/tools: все MCP tools и resources с описаниями.
К каким данным получает доступ MCP?
Только к формам и заявкам вашего аккаунта в рамках выданных OAuth scopes. Подробности — в политике конфиденциальности (раздел MCP Connector).
Можно ли использовать одно OAuth-приложение для нескольких AI-клиентов?
Да. Создайте одно OAuth-приложение и добавьте все нужные redirect URI (Claude.ai, loopback для Claude Code и т.д.) через запятую.
MCP отключается или зависает — что проверить?
Убедитесь, что URL заканчивается на /v1/mcp, credentials действительны, а scope forms включён. Сессии истекают через 1 час — переподключите клиент. Для Cursor проверьте заголовки X-Client-Id и X-Client-Secret.