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

# Guida all'integrazione Sora MCP

> sora MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) è un protocollo di contesto del modello lanciato da Anthropic, che consente ai modelli AI (come Claude, GPT, ecc.) di chiamare strumenti esterni tramite interfacce standardizzate. Attraverso il Sora MCP Server fornito da XHuoAPI, puoi utilizzare direttamente OpenAI Sora per generare video AI in client AI come Claude Desktop, VS Code, Cursor, ecc.

## Panoramica delle funzionalità

Il Sora MCP Server offre le seguenti funzionalità principali:

* **Generazione video da testo** — Genera video di alta qualità tramite suggerimenti testuali
* **Generazione video da immagini** — Genera video basati su immagini
* **Video con coerenza del personaggio** — Mantiene la coerenza del personaggio utilizzando immagini di riferimento
* **Generazione asincrona** — Supporta l'invio di compiti asincroni e la consultazione dei risultati
* **Varie orientazioni video** — Supporta orizzontale (landscape) e verticale (portrait)
* **Consultazione dei compiti** — Monitora il progresso della generazione e ottiene risultati

## Preparazione preliminare

Prima di utilizzare, devi ottenere il Token API di XHuoAPI:

1. Registrati o accedi alla [piattaforma XHuoAPI](https://api.xhuoapi.ai)
2. Vai alla pagina [Sora Videos API](https://api.xhuoapi.ai/documents/sora-videos)
3. Clicca su "Acquire" per ottenere il Token API (il primo acquisto include un credito gratuito)

## Installazione e configurazione

### Metodo 1: installazione pip (consigliato)

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

### Metodo 2: installazione da sorgente

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

Dopo l'installazione, puoi avviare il servizio utilizzando il comando `mcp-sora`.

## Utilizzo in Claude Desktop

Modifica il file di configurazione di Claude Desktop:

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

Aggiungi la seguente configurazione:

```json theme={null}
{
  "mcpServers": {
    "sora": {
      "command": "mcp-sora",
      "env": {
        "XHuoAPI_API_TOKEN": "il tuo Token API"
      }
    }
  }
}
```

Se utilizzi `uvx` (non è necessario installare pacchetti in anticipo):

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

Dopo aver salvato la configurazione, riavvia Claude Desktop per utilizzare gli strumenti Sora nella conversazione.

## Utilizzo in VS Code / Cursor

Crea `.vscode/mcp.json` nella directory principale del progetto:

```json theme={null}
{
  "servers": {
    "sora": {
      "command": "mcp-sora",
      "env": {
        "XHuoAPI_API_TOKEN": "il tuo Token API"
      }
    }
  }
}
```

Oppure utilizza `uvx`:

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

## Elenco degli strumenti disponibili

| Nome dello strumento                 | Descrizione                                               |
| ------------------------------------ | --------------------------------------------------------- |
| `sora_generate_video`                | Genera video tramite suggerimenti testuali                |
| `sora_generate_video_from_image`     | Genera video basati su immagini                           |
| `sora_generate_video_with_character` | Genera video coerenti utilizzando immagini di riferimento |
| `sora_generate_video_async`          | Invia compiti di generazione video in modo asincrono      |
| `sora_get_task`                      | Consulta lo stato di un singolo compito                   |
| `sora_get_tasks_batch`               | Consulta lo stato di più compiti in batch                 |

## Esempi di utilizzo

Dopo aver completato la configurazione, puoi chiamare queste funzionalità direttamente in linguaggio naturale nel client AI, ad esempio:

* "Aiutami a generare un video di un gatto che corre sull'erba con Sora"
* "Genera un video da questa foto di una persona, mantenendo la coerenza del personaggio"
* "Genera un video verticale, il contenuto è l'alba in città"
* "Genera un video in modo asincrono e consulta i risultati in seguito"

## Maggiori informazioni

* Repository GitHub: [XHuoAPI/SoraMCP](https://github.com/XHuoAPI/SoraMCP)
* Pacchetto PyPI: [mcp-sora](https://pypi.org/project/mcp-sora/)
* Documentazione API: [API di generazione video Sora](https://api.xhuoapi.ai/documents/sora)