# formio-uag

formio-uag связывает AI-агента с формами Form.io через MCP. Он превращает схемы форм в понятное описание и помогает собирать структурированные данные.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 12
- Автор: formio
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/formio/uag
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/mcp/formio-uag

## Что делает

formio-uag передаёт агенту структуру формы Form.io в формате Markdown. На её основе сервер поддерживает два сценария: преобразует разговорный ввод в данные по JSON-схеме формы и запускает агентные процессы с существующими отправками и контекстом.

Схемы Form.io могут менять контекст обработки без обновления приложения или повторного обучения агентов. В сервере есть инструмент `agent_provide_data`; репозиторий также содержит примеры пользовательского модуля, диалоговой формы и агентного процесса. Для установки через `npx` нужны значения `PROJECT`, `PROJECT_KEY`, `ADMIN_KEY`, `UAG_LICENSE` и `JWT_SECRET`; первый способ также передаёт `MONGO`, `BASE_URL` и `PORTAL_SECRET`.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `PROJECT`, `PROJECT_KEY`, `ADMIN_KEY`, `UAG_LICENSE`, `JWT_SECRET`, `PORT`, `PROJECT_TTL`, `JWT_EXPIRE_TIME`, `PORTAL_SECRET`, `MONGO` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add formio-uag -e PROJECT=<PROJECT> -e PROJECT_KEY=<PROJECT_KEY> -e ADMIN_KEY=<ADMIN_KEY> -e UAG_LICENSE=<UAG_LICENSE> -e JWT_SECRET=<JWT_SECRET> -e PORTAL_SECRET=<PORTAL_SECRET> -e MONGO=<MONGO> -e BASE_URL=<BASE_URL> -- npx -y @formio/uag
```
Вместо <…> подставьте свои значения. Ещё 10 переменных окружения — в README сервера

### Codex

**Командой платформы**
```bash
codex mcp add formio-uag --env PROJECT=<PROJECT> --env PROJECT_KEY=<PROJECT_KEY> --env ADMIN_KEY=<ADMIN_KEY> --env UAG_LICENSE=<UAG_LICENSE> --env JWT_SECRET=<JWT_SECRET> -- npx -y @formio/uag
```
Вместо <…> подставьте свои значения. Ещё 10 переменных окружения — в README сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "formio-uag": {
            "command": "npx",
            "args": [
                "-y",
                "@formio/uag"
            ],
            "env": {
                "PROJECT": "<PROJECT>",
                "PROJECT_KEY": "<PROJECT_KEY>",
                "ADMIN_KEY": "<ADMIN_KEY>",
                "UAG_LICENSE": "<UAG_LICENSE>",
                "JWT_SECRET": "<JWT_SECRET>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 10 переменных окружения — в README сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "formio-uag": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@formio/uag"
            ],
            "env": {
                "PROJECT": "<PROJECT>",
                "PROJECT_KEY": "<PROJECT_KEY>",
                "ADMIN_KEY": "<ADMIN_KEY>",
                "UAG_LICENSE": "<UAG_LICENSE>",
                "JWT_SECRET": "<JWT_SECRET>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 10 переменных окружения — в README сервера

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e PROJECT=<PROJECT> -e PROJECT_KEY=<PROJECT_KEY> -e ADMIN_KEY=<ADMIN_KEY> -e UAG_LICENSE=<UAG_LICENSE> -e JWT_SECRET=<JWT_SECRET> formio-uag npx -y @formio/uag
```
Вместо <…> подставьте свои значения. Ещё 10 переменных окружения — в README сервера

## Когда брать
- преобразовать разговорный ввод в данные формы
- передать агенту структуру Form.io-формы
- запустить обработку отправки по заданному контексту
- обновить контекст агента через JSON-схему формы

## Примеры запросов агенту
- Разбери этот запрос по схеме формы Form.io и подготовь структурированные данные.
- Используй `agent_provide_data`, чтобы проанализировать существующую отправку по заданному контексту.
- Покажи, какие данные нужно собрать для этой формы, и заполни их из разговора.

## Похожие
- [formio-mcp](https://affpapa.org/nevibecode/mcp/formio-mcp.md) — MCP-сервер · ★ 8
- [configuring-ai-agents](https://affpapa.org/nevibecode/skills/configuring-ai-agents.md) — скилл · 2900 установок
- [Deep Agentic Core MCP](https://affpapa.org/nevibecode/mcp/deep-agentic-core-mcp.md) — MCP-сервер · ★ 65
- [platform-custom-lightning-type-generate](https://affpapa.org/nevibecode/skills/platform-custom-lightning-type-generate.md) — скилл · 5700 установок
- [Stepgate](https://affpapa.org/nevibecode/mcp/stepgate.md) — MCP-сервер · ★ 13
- [Repo Architect Agent](https://affpapa.org/nevibecode/agents/repo-architect-agent.md) — субагент · ★ 40451

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md