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.com.ua/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.com.ua/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.