---
title: "Инструменты Ring MCP"
description: "Справочник Model Context Protocol для клонов Ring Platform — шлюз ring-mcp, область kingdom vs clone и страницы оператора по инструментам"
locale: "ru"
---
# Инструменты Ring MCP

**Подключите Cursor, Claude Desktop или любой MCP-хост к запущенному клону Ring** и управляйте сущностями, новостями, магазином, сообщениями и генеративными медиа на естественном языке.

Ring поставляет **HTTP-шлюз с сервисным токеном** по адресу `/api/mcp/v1/*` на каждом клоне. Stdio-сервер **`ring-mcp`** (`AI-RING/ring-mcp/`) открывает инструменты `ring-*`, которые вызывают этот шлюз от имени синтетического актора **SUPERADMIN**. Этот раздел документирует **отдельные инструменты**; полное руководство оператора — в [Ring MCP Server](/docs/development/ring-mcp.md).

  
- **[Ring MCP Server (руководство оператора)](/docs/development/ring-mcp.md)** — Установка ring-mcp, настройка токенов, полный каталог из 58 инструментов, устранение неисправностей.

  
- **[Генеративные изображения (ImageConductor)](/docs/development/generative-images.md)** — Архитектура провайдера, блок env, админ UI — общий бэкенд для image-инструментов.

  
- **[Генеративные видео (VideoConductor)](/docs/development/generative-videos.md)** — Черновик 480p vs production 720p, workflow ремастеринга, манифест CLI.

  
- **[Конфигурация окружения](/docs/deployment/environment.md)** — `RING_MCP_ACCESS_KEY`, ключи генерации изображений, хранилище ring-filebase.

```mermaid
flowchart LR
  Host["MCP host\n(Cursor, Claude)"]
  RingMcp["ring-mcp\nAI-RING/ring-mcp"]
  Gateway["/api/mcp/v1/*\nRing clone"]
  Services["features/*/services"]
  DB[("PostgreSQL / storage")]

  Host --> RingMcp --> Gateway --> Services --> DB

  subgraph Kingdom["Kingdom MCP — different scope"]
    Legiox["legiox-mcp"]
    Ringdom["ringdom-mcp"]
    Reggie["reggie-mcp"]
  end
```

## Что такое MCP?

[Model Context Protocol (MCP)](https://modelcontextprotocol.io/docs/getting-started/intro) — открытый стандарт подключения ИИ-приложений к внешним данным и инструментам. Ring реализует MCP в двух слоях:

| Слой | Пакет / сервер | Область |
|-------|------------------|-------|
| **Оператор клона** | `ring-mcp` → `/api/mcp/v1/*` | Один white-label экземпляр (этот раздел) |
| **В пределах Kingdom** | `legiox-mcp`, `ringdom-mcp`, `reggie-mcp` | AI-CONTEXT, деплой, распространение по Ringdom |

Пользовательские REST-маршруты Ring используют **session cookies Auth.js**. Шлюз MCP проверяет `Authorization: Bearer` против `RING_MCP_ACCESS_KEY` и внедряет сервисного актора — см. [Ring MCP Server — Architecture](/docs/development/ring-mcp.md#architecture-notes).

## Предпосылки

| Требование | Примечания |
|-------------|--------|
| Node.js 20+ | Базовая линия Ring Platform |
| Запущенный клон Ring | `npm run dev` или production-деплой |
| `RING_MCP_ACCESS_KEY` | В `.env.local` **приложения Ring** |
| `RING_MCP_ACCESS_KEY` | В Cursor `.cursor/mcp.json` — должен совпадать с одним серверным токеном |
| `ring-mcp` зарегистрирован | `AI-RING/ring-mcp/ring-mcp-server.js` в конфиге MCP-клиента |

{`cd AI-RING/ring-mcp
npm install
node ring-mcp-server.js --test

RING_API_BASE_URL=http://localhost:3000 \\
RING_MCP_ACCESS_KEY=your-token \\
npm run smoke`}

## Каталог инструментов

Каждая карточка ведёт на отдельную справочную страницу. Страницы добавляются по мере выхода инструментов.

  
- **[ring-image-create](/docs/mcp/ring-image-create.md)** — Генерация изображений через ImageConductor (xAI / Google Imagen) → CDN URL ring-filebase.

  
- **[ring-video-create](/docs/mcp/ring-video-create.md)** — Генерация видео через VideoConductor — черновик 480p или production 720p remaster.

Дополнительные инструменты `ring-*` (entities, news, store, `ring-news-generate` и др.) описаны в руководстве оператора [Ring MCP Server](/docs/development/ring-mcp.md#tool-reference-58-tools). Страницы по инструментам в `/docs/mcp/` появятся здесь по мере написания.

## Контракт ответа

Все обработчики `/api/mcp/v1/*` возвращают единообразный JSON:

{`{
  "success": true,
  "data": { }
}`}

{`{
  "success": false,
  "error": "Human-readable message"
}`}

Деструктивные мутации `ring-*` требуют **`confirm: true`** в аргументах инструмента — не обходите это в wrapper-ах.

## Связанное

  
- **[Автономная редакция](/docs/development/generative-newsroom.md)** — `ring-news-generate` — цитируемые черновики с featured images.

  
- **[Система документации](/docs/features/doc-system.md)** — MDX-компоненты, используемые на этих страницах.