---
title: "Інструменти Ring MCP"
description: "Довідник Model Context Protocol для клонів Ring Platform"
locale: "uk"
---
# Інструменти Ring MCP

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

Ring надає HTTP-шлюз із сервісним токеном за адресою `/api/mcp/v1/*` у кожному клоні. Сервер `ring-mcp` (`AI-RING/ring-mcp/`) відкриває інструменти `ring-*` від імені SUPERADMIN. Повний посібник — у [Ring MCP Server](/docs/development/ring-mcp.md).

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

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

  
- **[Генеративні відео (VideoConductor)](/docs/development/generative-videos.md)** — Чернетка 480p, production 720p, ремастеринг і маніфест 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 на рівні клону та рівні Kingdom.

| Рівень | Пакет / сервер | Область |
|-------|------------------|-------|
| **Оператор клону** | `ring-mcp` → `/api/mcp/v1/*` | Один white-label екземпляр |
| **У межах Kingdom** | `legiox-mcp`, `ringdom-mcp`, `reggie-mcp` | AI-CONTEXT і поширення в Ringdom |

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

Кожна картка веде на окрему довідкову сторінку.

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

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

Додаткові інструменти `ring-*` описані в посібнику оператора [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` — цитовані чернетки з обраними зображеннями.

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