> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Sora MCP інтеграційний посібник

> sora MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) — це протокол контексту моделі, розроблений компанією Anthropic, який дозволяє AI моделям (таким як Claude, GPT тощо) викликати зовнішні інструменти через стандартизований інтерфейс. Завдяки Sora MCP Server, наданому XHuoAPI, ви можете безпосередньо використовувати OpenAI Sora для створення AI відео в таких AI клієнтах, як Claude Desktop, VS Code, Cursor тощо.

## Огляд функцій

Sora MCP Server надає такі основні функції:

* **Генерація відео з тексту** — створення відео високої якості за допомогою текстових підказок
* **Генерація відео з зображення** — створення відео на основі зображення
* **Відео з узгодженістю персонажів** — збереження узгодженості персонажів за допомогою референсних зображень
* **Асинхронна генерація** — підтримка асинхронної подачі завдань та запиту результатів
* **Різні орієнтації зображення** — підтримка горизонтальної (landscape) та вертикальної (portrait) орієнтації
* **Запит завдань** — моніторинг прогресу генерації та отримання результатів

## Попередня підготовка

Перед використанням вам потрібно отримати XHuoAPI API Token:

1. Зареєструйтесь або увійдіть на [платформу XHuoAPI](https://api.xhuoapi.ai)
2. Перейдіть на сторінку [Sora Videos API](https://api.xhuoapi.ai/documents/sora-videos)
3. Натисніть «Acquire», щоб отримати API Token (перший запит надає безкоштовний ліміт)

## Встановлення та налаштування

### Спосіб перший: установка через pip (рекомендується)

```bash theme={null}
pip install mcp-sora
```

### Спосіб другий: установка з вихідного коду

```bash theme={null}
git clone https://github.com/XHuoAPI/SoraMCP.git
cd SoraMCP
pip install -e .
```

Після завершення установки ви можете використовувати команду `mcp-sora` для запуску сервісу.

## Використання в Claude Desktop

Редагуйте конфігураційний файл Claude Desktop:

* **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
* **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

Додайте наступну конфігурацію:

```json theme={null}
{
  "mcpServers": {
    "sora": {
      "command": "mcp-sora",
      "env": {
        "XHuoAPI_API_TOKEN": "ваш API Token"
      }
    }
  }
}
```

Якщо ви використовуєте `uvx` (не потрібно заздалегідь встановлювати пакет):

```json theme={null}
{
  "mcpServers": {
    "sora": {
      "command": "uvx",
      "args": ["mcp-sora"],
      "env": {
        "XHuoAPI_API_TOKEN": "ваш API Token"
      }
    }
  }
}
```

Збережіть конфігурацію та перезапустіть Claude Desktop, щоб мати можливість використовувати інструменти Sora в діалозі.

## Використання в VS Code / Cursor

У кореневій директорії проекту створіть файл `.vscode/mcp.json`:

```json theme={null}
{
  "servers": {
    "sora": {
      "command": "mcp-sora",
      "env": {
        "XHuoAPI_API_TOKEN": "ваш API Token"
      }
    }
  }
}
```

Або використовуйте `uvx`:

```json theme={null}
{
  "servers": {
    "sora": {
      "command": "uvx",
      "args": ["mcp-sora"],
      "env": {
        "XHuoAPI_API_TOKEN": "ваш API Token"
      }
    }
  }
}
```

## Список доступних інструментів

| Назва інструменту                    | Опис                                                            |
| ------------------------------------ | --------------------------------------------------------------- |
| `sora_generate_video`                | Генерація відео за текстовими підказками                        |
| `sora_generate_video_from_image`     | Генерація відео на основі зображення                            |
| `sora_generate_video_with_character` | Генерація узгодженого відео з референсним зображенням персонажа |
| `sora_generate_video_async`          | Асинхронна подача завдання на генерацію відео                   |
| `sora_get_task`                      | Запит статусу окремого завдання                                 |
| `sora_get_tasks_batch`               | Пакетний запит статусу завдань                                  |

## Приклади використання

Після налаштування ви можете безпосередньо використовувати ці функції в AI клієнті природною мовою, наприклад:

* «Допоможи мені створити відео, де кіт бігає по траві, за допомогою Sora»
* «Створи відео на основі цього зображення людини, зберігаючи узгодженість персонажа»
* «Створи вертикальне відео з темою сходу сонця в місті»
* «Асинхронно створити відео та пізніше запитати результат»

## Додаткова інформація

* Репозиторій GitHub: [XHuoAPI/SoraMCP](https://github.com/XHuoAPI/SoraMCP)
* Пакет PyPI: [mcp-sora](https://pypi.org/project/mcp-sora/)
* Документація API: [API для генерації відео Sora](https://api.xhuoapi.ai/documents/sora)