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

# Sora MCP Integrationsguide

> sora MCP server integration

[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 AceData Cloud 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 AceData Cloud API-token:

1. Registrera dig eller logga in på [AceData Cloud-plattformen](https://platform.acedata.cloud)
2. Gå till sidan [Sora Videos API](https://platform.acedata.cloud/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/AceDataCloud/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": {
        "ACEDATACLOUD_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": {
        "ACEDATACLOUD_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": {
        "ACEDATACLOUD_API_TOKEN": "din API-token"
      }
    }
  }
}
```

Eller använd `uvx`:

```json theme={null}
{
  "servers": {
    "sora": {
      "command": "uvx",
      "args": ["mcp-sora"],
      "env": {
        "ACEDATACLOUD_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: [AceDataCloud/SoraMCP](https://github.com/AceDataCloud/SoraMCP)
* PyPI-paket: [mcp-sora](https://pypi.org/project/mcp-sora/)
* API-dokumentation: [Sora videogenererings-API](https://platform.acedata.cloud/documents/sora)