> ## 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 Seedance MCP

> seedance MCP 服务器集成

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

## Panoramica delle funzionalità

Seedance MCP Server offre le seguenti funzionalità principali:

* **Generazione video da testo** — genera video di alta qualità da prompt testuali
* **Generazione video da immagine** — genera video con riferimento a immagini (modalità primo frame, ultimo frame, immagine di riferimento, ecc.)
* **Supporto multi-modello** — supporta vari modelli come Seedance 1.5 Pro, 1.0 Pro, 1.0 Lite, ecc.
* **Varie risoluzioni** — supporta risoluzioni 480p, 720p, 1080p
* **Diversi rapporti d'aspetto** — supporta 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 e altri rapporti
* **Durata flessibile** — supporta video da 2 a 12 secondi
* **Generazione audio** — alcuni modelli supportano la generazione audio simultanea
* **Query delle attività** — monitora il progresso della generazione e ottieni i risultati

## Prerequisiti

Prima di iniziare, devi ottenere un API Token da XHuoAPI:

1. Registrati o accedi alla [piattaforma XHuoAPI](https://api.xhuoapi.ai)
2. Vai alla pagina [Seedance Videos API](https://api.xhuoapi.ai/documents/seedance-videos)
3. Clicca su "Acquire" per ottenere l'API Token (la prima richiesta include un credito gratuito)

## Installazione e configurazione

### Metodo 1: installazione tramite pip (consigliato)

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

### Metodo 2: installazione da sorgente

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

Dopo l'installazione, puoi avviare il servizio con il comando `mcp-seedance`.

## 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": {
    "seedance": {
      "command": "mcp-seedance",
      "env": {
        "XHuoAPI_API_TOKEN": "il_tuo_API_Token"
      }
    }
  }
}
```

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

```json theme={null}
{
  "mcpServers": {
    "seedance": {
      "command": "uvx",
      "args": ["mcp-seedance"],
      "env": {
        "XHuoAPI_API_TOKEN": "il_tuo_API_Token"
      }
    }
  }
}
```

Salva la configurazione e riavvia Claude Desktop per utilizzare gli strumenti Seedance nelle conversazioni.

## Utilizzo in VS Code / Cursor

Crea il file `.vscode/mcp.json` nella radice del progetto:

```json theme={null}
{
  "servers": {
    "seedance": {
      "command": "mcp-seedance",
      "env": {
        "XHuoAPI_API_TOKEN": "il_tuo_API_Token"
      }
    }
  }
}
```

Oppure usa `uvx`:

```json theme={null}
{
  "servers": {
    "seedance": {
      "command": "uvx",
      "args": ["mcp-seedance"],
      "env": {
        "XHuoAPI_API_TOKEN": "il_tuo_API_Token"
      }
    }
  }
}
```

## Elenco degli strumenti disponibili

| Nome strumento                       | Descrizione                                                 |
| ------------------------------------ | ----------------------------------------------------------- |
| `seedance_generate_video`            | Genera video da prompt testuale                             |
| `seedance_generate_video_from_image` | Genera video con riferimento a immagine                     |
| `seedance_get_task`                  | Consulta lo stato di un singolo task                        |
| `seedance_get_tasks_batch`           | Consulta lo stato di più task in batch                      |
| `seedance_list_models`               | Elenca tutti i modelli disponibili e le loro capacità       |
| `seedance_list_resolutions`          | Elenca risoluzioni e rapporti d'aspetto disponibili         |
| `seedance_list_actions`              | Elenca tutti gli strumenti e esempi di workflow disponibili |

## Esempi d'uso

Dopo la configurazione, puoi chiamare queste funzionalità direttamente con linguaggio naturale nei client AI, ad esempio:

* "Per favore genera un video time-lapse di una strada cittadina con Seedance"
* "Usa questa foto come primo frame per generare un video di 8 secondi"
* "Genera un breve video verticale 1080p con rapporto 9:16"
* "Genera un video con audio usando il modello Seedance 1.5 Pro"

## Ulteriori informazioni

* Repository GitHub: [XHuoAPI/SeedanceMCP](https://github.com/XHuoAPI/SeedanceMCP)
* Pacchetto PyPI: [mcp-seedance](https://pypi.org/project/mcp-seedance/)
* Documentazione API: [Seedance Video Generation API](https://api.xhuoapi.ai/documents/seedance)