> ## 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 Integrationsguide

> sora MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) är en modellkontextprotokoll som lanserats av Anthropic, vilket tillåter AI-modeller (som Claude, GPT etc.) att anropa externa verktyg via standardiserade gränssnitt. Genom Sora MCP Server som tillhandahålls av XHuoAPI kan du direkt använda OpenAI Sora för att generera AI-videor i AI-klienter som Claude Desktop, VS Code, Cursor etc.

## Funktionsöversikt

Sora MCP Server erbjuder följande kärnfunktioner:

* **Textgenererad video** — Generera högkvalitativa videor genom textpromptar
* **Bildgenererad video** — Generera video baserat på bilder
* **Karaktärskonsistensvideo** — Bevara karaktärskonsistens med referensbilder
* **Asynkron generering** — Stöd för asynkron uppgiftsinlämning och resultatfrågor
* **Flera bildriktningar** — Stöd för liggande (landscape) och stående (portrait)
* **Uppgiftsfråga** — Övervaka genereringsprocessen och hämta resultat

## Förberedelser

Innan användning behöver du skaffa en XHuoAPI API-token:

1. Registrera dig eller logga in på [XHuoAPI-plattformen](https://api.xhuoapi.ai)
2. Gå till sidan [Sora Videos API](https://api.xhuoapi.ai/documents/sora-videos)
3. Klicka på "Acquire" för att få API-token (första ansökan ger gratis kvot)

## Installationskonfiguration

### Metod ett: pip-installation (rekommenderas)

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

### Metod två: källkodinstallation

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

När installationen är klar kan du använda kommandot `mcp-sora` för att starta tjänsten.

## Använda i Claude Desktop

Redigera konfigurationsfilen för Claude Desktop:

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

Lägg till följande konfiguration:

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

Om du använder `uvx` (ingen förinstallation av paket krävs):

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

Spara konfigurationen och starta om Claude Desktop för att använda Sora-relaterade verktyg i dialogen.

## Använda i VS Code / Cursor

Skapa `.vscode/mcp.json` i projektets rotkatalog:

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

Eller använd `uvx`:

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

## Tillgängliga verktyg

| Verktygsnamn                         | Beskrivning                                   |
| ------------------------------------ | --------------------------------------------- |
| `sora_generate_video`                | Generera video genom textpromptar             |
| `sora_generate_video_from_image`     | Generera video baserat på bilder              |
| `sora_generate_video_with_character` | Generera konsistensvideo med referenskaraktär |
| `sora_generate_video_async`          | Asynkront skicka videogenereringsuppgifter    |
| `sora_get_task`                      | Fråga status för enskild uppgift              |
| `sora_get_tasks_batch`               | Batchfråga uppgiftsstatus                     |

## Användningsexempel

När konfigurationen är klar kan du direkt använda dessa funktioner med naturligt språk i AI-klienten, till exempel:

* "Hjälp mig att generera en video av en katt som springer på gräset med Sora"
* "Generera en video med denna personbild, behåll karaktärskonsistensen"
* "Generera en stående video med innehållet stads soluppgång"
* "Asynkront generera en video och fråga resultatet senare"

## Mer information

* GitHub-repo: [XHuoAPI/SoraMCP](https://github.com/XHuoAPI/SoraMCP)
* PyPI-paket: [mcp-sora](https://pypi.org/project/mcp-sora/)
* API-dokumentation: [Sora videogenererings-API](https://api.xhuoapi.ai/documents/sora)