Руководство по MCP-серверу Agent Grid

Agent Grid — это управляемый хаб от Anima, где AI-агенты создают, размещают, публикуют и делятся веб-приложениями. Этот репозиторий — руководство по MCP-серверу и навык, который учит вашего агента программирования использовать его: установите как плагин Claude Code, навык Codex или обычный MCP-сервер.

Agent Grid находится по адресу app.agentgrid.io. Полную документацию см. в нашей справочной документации.

Что умеет ваш агент

Создавать приложение по подсказке, сайту или дизайну Figma — опишите его, клонируйте URL или передайте фреймы Figma и получите работающее приложение по живому URL.
Размещать уже существующий код — импортируйте проект или создайте пустой репозиторий и отправляйте в него изменения.
Редактировать любой артефакт через git — каждый артефакт — это настоящий git-репозиторий; клонируйте, коммитьте, пушьте.
Публиковать по общедоступному живому URL — и снимать с публикации.
Генерировать код с учётом дизайна в вашу собственную кодовую базу — фреймы Figma в файлы вашего репозитория, адаптированные под ваш стек.

Всё является артефактом: один git-репозиторий в рабочем пространстве вашей команды, доступный по его sessionId.

Быстрый старт: плагин Claude Code

/plugin marketplace add AnimaApp/mcp-server-guide
/plugin install anima@mcp-server-guide

Это настраивает MCP-сервер и устанавливает навык. Аутентифицируйтесь, когда будет предложено. Вот и всё.

Установка и настройка

Требования

AI-инструмент для программирования с поддержкой MCP — Claude Code, Codex, Cursor, VS Code или любой другой, поддерживающий streamable HTTP
Аккаунт Agent Grid

URL сервера: https://api.agentgrid.io/v1/mcp · Транспорт: streamable HTTP

Claude Code (вручную)

В вашем терминале (не внутри Claude Code):

claude mcp add --transport http anima https://api.agentgrid.io/v1/mcp

Перезапустите Claude Code
Выполните /mcp, выберите anima и аутентифицируйтесь в браузере
(Опционально) Подключите Figma во время аутентификации, чтобы включить сценарии работы с Figma

Управляйте серверами с помощью claude mcp list, claude mcp get anima, claude mcp remove anima. См. документацию Anthropic по MCP.

OpenAI Codex

codex mcp add anima --url https://api.agentgrid.io/v1/mcp

Или в ~/.codex/config.toml:

[mcp_servers.anima]
url = "https://api.agentgrid.io/v1/mcp"

Затем установите навык (рекомендуется):

codex skill install AnimaApp/mcp-server-guide/skills/anima

См. документацию OpenAI по Codex MCP.

VS Code

Cmd Shift P / Ctrl Shift P → MCP: Add Server
Выберите HTTP
URL: https://api.agentgrid.io/v1/mcp
ID сервера: anima
Выберите глобальную область или область рабочего пространства

{
  "servers": {
    "anima": {
      "type": "http",
      "url": "https://api.agentgrid.io/v1/mcp"
    }
  }
}

Примечание

MCP в VS Code требует GitHub Copilot. См. документацию VS Code.

Cursor

Cursor > Settings > Cursor Settings > MCP > + Add new global MCP server:

{
  "mcpServers": {
    "anima": {
      "url": "https://api.agentgrid.io/v1/mcp"
    }
  }
}

Нажмите Connect для аутентификации. См. документацию Cursor.

Любой другой клиент

{
  "mcpServers": {
    "anima": {
      "url": "https://api.agentgrid.io/v1/mcp"
    }
  }
}

Нет MCP? Используйте CLI

Anima CLI запускает те же инструменты из оболочки — MCP-сервер настраивать не нужно:

npx @animaapp/cli@latest login
npx @animaapp/cli@latest create -t p2c -p "SaaS dashboard with sidebar and analytics"

Как давать подсказки агенту

Создать что-то новое

"Создай мне панель аналитики SaaS с боковой панелью, карточками KPI и лентой активности."

Ваш агент создаёт артефакт, ждёт сборки и возвращает URL живого предпросмотра. Попросите варианты — и он сможет сгенерировать несколько параллельно для сравнения.

Клонировать сайт или реализовать дизайн Figma как живое приложение

"Клонируй stripe.com/payments в приложение." "Преврати этот фрейм Figma в работающий сайт: https://figma.com/design/..."

Редактировать существующий артефакт

"Заголовок на https://app.agentgrid.io/artifacts/xyz сломан на мобильных — исправь."

Агент клонирует git-репозиторий артефакта, исправляет и отправляет. Изменения контента всегда проходят через git.

Реализовать дизайн Figma в вашей собственной кодовой базе

"Реализуй этот дизайн Figma в моём проекте: https://figma.com/design/..."

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

Опубликовать

"Опубликуй это."

Публикация делает приложение общедоступным для всего мира — она не нужна только для того, чтобы поделиться, поскольку URL артефакта уже доступен для просмотра.

Доступ к дизайн-системе (Enterprise)

"Реализуй форму входа в соответствии с нашей дизайн-системой, используя этот URL Figma: ..."

Настройка дизайн-системы выполняется нашей командой. Свяжитесь с нами, чтобы её настроить.

Лучшие практики

Описывайте замысел, а не CSS. Agent Grid учитывает дизайн; шестнадцатеричные значения и размеры в пикселях в подсказке переопределяют это и дают обобщённые результаты. Скажите, для чего это, для кого и какие 3–5 функций важны.

Будьте конкретны при реализации. "Реализуй форму входа, используя наши существующие компоненты Button и Input из src/components/ui" лучше, чем "реализуй этот дизайн".

Разбивайте большие дизайны. Сначала заголовок, затем сетка карточек, затем подвал. Сфокусированные запросы точнее.

Устранение неполадок

Типичные проблемы — асинхронная генерация, валидация типа создания, истечение срока действия git-токена, семантика публикации — описаны в справочнике по устранению неполадок навыка.

MCP не распознаётся: убедитесь, что сервер настроен в вашем инструменте и аутентификация завершена.

Проблемы с аутентификацией: удалите и заново добавьте сервер, очистите файлы cookie, перезапустите клиент.

Что находится в этом репозитории

Путь	Назначение
`skills/anima/SKILL.md`	Навык, который читает ваш агент
`skills/anima/references/`	Справочник по инструментам, настройка, git-процесс, примеры, устранение неполадок
`.claude-plugin/`	Манифесты плагина и маркетплейса Claude Code
`.mcp.json`	MCP-сервер, который устанавливает плагин
`server.json`	Запись в реестре MCP
`anima/SKILL.md`	Зеркало навыка, синхронизируемое через CI