> ## 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 Przewodnik Integracji

> sora MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) to protokół kontekstu modelu wprowadzony przez Anthropic, który pozwala modelom AI (takim jak Claude, GPT itp.) na wywoływanie zewnętrznych narzędzi za pomocą znormalizowanego interfejsu. Dzięki Sora MCP Server dostarczonemu przez XHuoAPI, możesz bezpośrednio używać OpenAI Sora do generowania filmów AI w klientach AI takich jak Claude Desktop, VS Code, Cursor itp.

## Przegląd funkcji

Sora MCP Server oferuje następujące kluczowe funkcje:

* **Generowanie wideo z tekstu** — generowanie wysokiej jakości wideo na podstawie tekstowych podpowiedzi
* **Generowanie wideo z obrazu** — generowanie wideo na podstawie obrazu
* **Wideo z zachowaniem spójności postaci** — utrzymywanie spójności postaci za pomocą referencyjnych obrazów
* **Generowanie asynchroniczne** — wsparcie dla asynchronicznego składania zadań i zapytań o wyniki
* **Różne orientacje obrazu** — wsparcie dla orientacji poziomej (landscape) i pionowej (portrait)
* **Zapytania o zadania** — monitorowanie postępu generowania i uzyskiwanie wyników

## Wymagania wstępne

Przed użyciem musisz uzyskać token API XHuoAPI:

1. Zarejestruj się lub zaloguj na [platformie XHuoAPI](https://api.xhuoapi.ai)
2. Przejdź do strony [Sora Videos API](https://api.xhuoapi.ai/documents/sora-videos)
3. Kliknij „Acquire”, aby uzyskać token API (pierwsze zgłoszenie daje darmowy limit)

## Instalacja i konfiguracja

### Metoda 1: Instalacja za pomocą pip (zalecana)

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

### Metoda 2: Instalacja ze źródła

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

Po zakończeniu instalacji możesz użyć polecenia `mcp-sora`, aby uruchomić serwis.

## Użycie w Claude Desktop

Edytuj plik konfiguracyjny Claude Desktop:

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

Dodaj następującą konfigurację:

```json theme={null}
{
  "mcpServers": {
    "sora": {
      "command": "mcp-sora",
      "env": {
        "XHuoAPI_API_TOKEN": "Twój token API"
      }
    }
  }
}
```

Jeśli używasz `uvx` (nie wymaga wcześniejszej instalacji pakietu):

```json theme={null}
{
  "mcpServers": {
    "sora": {
      "command": "uvx",
      "args": ["mcp-sora"],
      "env": {
        "XHuoAPI_API_TOKEN": "Twój token API"
      }
    }
  }
}
```

Po zapisaniu konfiguracji uruchom ponownie Claude Desktop, aby móc korzystać z narzędzi związanych z Sora w rozmowie.

## Użycie w VS Code / Cursor

Utwórz plik `.vscode/mcp.json` w katalogu głównym projektu:

```json theme={null}
{
  "servers": {
    "sora": {
      "command": "mcp-sora",
      "env": {
        "XHuoAPI_API_TOKEN": "Twój token API"
      }
    }
  }
}
```

Lub użyj `uvx`:

```json theme={null}
{
  "servers": {
    "sora": {
      "command": "uvx",
      "args": ["mcp-sora"],
      "env": {
        "XHuoAPI_API_TOKEN": "Twój token API"
      }
    }
  }
}
```

## Lista dostępnych narzędzi

| Nazwa narzędzia                      | Opis                                                                |
| ------------------------------------ | ------------------------------------------------------------------- |
| `sora_generate_video`                | Generowanie wideo na podstawie tekstowych podpowiedzi               |
| `sora_generate_video_from_image`     | Generowanie wideo na podstawie obrazu                               |
| `sora_generate_video_with_character` | Generowanie spójnego wideo z użyciem referencyjnych obrazów postaci |
| `sora_generate_video_async`          | Asynchroniczne składanie zadań do generowania wideo                 |
| `sora_get_task`                      | Zapytanie o status pojedynczego zadania                             |
| `sora_get_tasks_batch`               | Grupowe zapytanie o status zadań                                    |

## Przykłady użycia

Po skonfigurowaniu możesz bezpośrednio wywoływać te funkcje w kliencie AI za pomocą naturalnego języka, na przykład:

* „Pomóż mi wygenerować wideo z kotem biegającym po trawie za pomocą Sora”
* „Wygeneruj wideo na podstawie tego zdjęcia postaci, zachowując spójność”
* „Wygeneruj wideo w orientacji pionowej, którego treścią jest wschód słońca w mieście”
* „Asynchronicznie wygeneruj wideo i sprawdź wyniki później”

## Więcej informacji

* Repozytorium GitHub: [XHuoAPI/SoraMCP](https://github.com/XHuoAPI/SoraMCP)
* Pakiet PyPI: [mcp-sora](https://pypi.org/project/mcp-sora/)
* Dokumentacja API: [API do generowania wideo Sora](https://api.xhuoapi.ai/documents/sora)