API ВЕГА

Formasty MCP

Создавайте и управляйте готовыми к использованию в production формами, тестами, опросами, рабочими процессами и конвейерами обработки ответов с помощью AI-агентов.

Это публичный репозиторий с документацией к официальному удалённому MCP-серверу Formasty на базе Model Context Protocol. Приложение Formasty и его backend остаются закрытыми. В этом репозитории намеренно нет реализации сервера, конфигурации инфраструктуры, данных клиентов и учётных данных.

Подключение

ПараметрЗначение
Имя сервераformasty
URL удалённого MCP-сервераhttps://app.formasty.com/api/mcp
ТранспортStreamable HTTP
URL устаревшего SSE-подключенияhttps://app.formasty.com/api/mcp/sse
АутентификацияOAuth; для клиентов, управляемых разработчиками, предусмотрен резервный вариант с API-ключом
Официальное имя в реестреcom.formasty/form-builder

Если ваш клиент поддерживает удалённые MCP-серверы, добавьте https://app.formasty.com/api/mcp и пройдите OAuth-аутентификацию в Formasty. Этот репозиторий содержит только документацию: не клонируйте его и не запускайте как сервер.

Claude

В Claude откройте Настройки > Коннекторы, добавьте пользовательский коннектор, укажите URL удалённого MCP-сервера и пройдите аутентификацию в Formasty. Один и тот же коннектор работает во всех версиях Claude, поддерживающих удалённый MCP.

Cursor

После одобрения плагина Formasty для Cursor Marketplace установите его через Настройки Cursor > Плагины или выполните команду:

/add-plugin formasty

Чтобы подключиться вручную до одобрения плагина для Marketplace, добавьте следующую конфигурацию в настройки MCP пользователя или проекта:

{
  "mcpServers": {
    "formasty": {
      "url": "https://app.formasty.com/api/mcp"
    }
  }
}

Cursor поддерживает Streamable HTTP и OAuth для удалённых MCP-серверов.

VS Code и GitHub Copilot

Добавьте следующую конфигурацию в mcp.json профиля пользователя или рабочей области:

{
  "servers": {
    "formasty": {
      "type": "http",
      "url": "https://app.formasty.com/api/mcp"
    }
  }
}

Cline

Используйте интерфейс Cline для подключения удалённого сервера или установите его через CLI:

cline mcp install formasty --transport http https://app.formasty.com/api/mcp

ChatGPT

В рабочей области с доступом разработчика к приложениям MCP создайте пользовательское приложение, указав https://app.formasty.com/api/mcp в качестве URL MCP-сервера. Пройдите OAuth-аутентификацию и проверьте запрашиваемые разрешения для инструментов, прежде чем публиковать приложение в рабочей области.

Gemini CLI

Установите официальное расширение Formasty для Gemini CLI с GitHub:

gemini extensions install https://github.com/QuantumCoderSys/formasty-mcp

Перезапустите Gemini CLI, выполните /mcp list и, если потребуется аутентификация, пройдите её с помощью /mcp auth formasty. Файл gemini-extension.json в корне репозитория задаёт размещённую конечную точку Streamable HTTP; пакет backend и локальный процесс сервера не устанавливаются.

Мост совместимости

Для клиентов, поддерживающих только stdio, например более старых версий Claude Desktop, используйте удалённый мост:

{
  "mcpServers": {
    "formasty": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.formasty.com/api/mcp"
      ]
    }
  }
}

Не размещайте API-ключ Formasty в публичном репозитории, общей конфигурации, обращении в службу поддержки или на снимке экрана. Для клиентских приложений предпочтительна OAuth-аутентификация.

Агенты и специалисты, проверяющие размещение в каталогах, могут воспользоваться llms-install.md, где приведены краткие инструкции по установке и проверке. Gemini CLI также получает специальные инструкции по работе из файла GEMINI.md.

Возможности агентов

  • Создавать формы с нуля или на основе стартовых шаблонов Formasty.

  • Создавать формы для сбора лидов, опросы, формы для сбора информации, заявки, формы бронирования, листы ожидания, голосования и тесты.

  • Добавлять, обновлять, перемещать, менять порядок и удалять шаги и поля.

  • Настраивать темы, обложки, расписание, параметры, экраны благодарности и завершения.

  • Создавать условные рабочие процессы, переменные, правила маршрутизации, тесты на соответствие и тесты с начислением баллов.

  • Проверять и анализировать черновики перед публикацией.

  • Публиковать формы и получать ресурсы для обмена, встраивания и подключения.

  • Читать ответы и управлять ими, а также создавать выгрузки ответов с учётом разрешений пользователя.

  • Настраивать поддерживаемые веб-хуки, пиксели аналитики, менеджеры тегов и пользовательские домены.

  • Импортировать поддерживаемые формы Google Forms и Typeform.

В текущем публичном контракте доступно 75 операций. Полный список см. в файле TOOLS.md или запросите MCP tools/list, чтобы получить актуальные схемы и аннотации безопасности.

Аутентификация и разрешения

OAuth-подключения действуют от имени пользователя Formasty, выполнившего вход. Доступ к инструментам также ограничен следующими условиями:

  • Областью действия OAuth или API-ключа

  • Членством в рабочей области и разрешениями роли

  • Доступом к выбранной рабочей области

  • Ограничениями функций тарифов Free, Pro и Business

  • Оптимистическими версиями черновиков и проверкой на стороне сервера

  • Явным подтверждением пользователя и хост-приложения для операций с существенными последствиями

В общедоступной информации доступны только определения инструментов. Для вызова инструментов и доступа к данным рабочей области требуется аутентификация.

Полезные ссылки

Безопасность и конфиденциальность

Перед сообщением об уязвимости ознакомьтесь с SECURITY.md, а описание потоков данных, связанных с MCP, см. в PRIVACY.md. Не указывайте в публичных обращениях токены доступа, API-ключи, ответы на формы, данные клиентов, URL закрытых форм или данные для воспроизведения проблемы из реальной рабочей области.

Поддержка

Информацию о поддержке см. в SUPPORT.md. По вопросам учётной записи, оплаты, конфиденциальности или безопасности, требующим особого внимания, пишите на support@formasty.com.

Лицензия

Документация и метаданные в этом репозитории доступны по лицензии MIT. Использование размещённого сервиса Formasty регулируется Условиями предоставления услуг Formasty.