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

> veo 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 Veo MCP Server fornito da XHuoAPI, puoi utilizzare direttamente Google Veo per generare video AI in client AI come Claude Desktop, VS Code, Cursor, ecc.

## Panoramica delle funzionalità

Veo 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 basati su immagini
* **Supporto multi-modello** — supporta modelli come veo3, veo2, veo31-fast-ingredients, ecc.
* **Varie risoluzioni** — supporta output in 4K, 1080p, GIF, ecc.
* **Varie proporzioni** — supporta formati 16:9, 9:16, ecc.
* **Upgrade a 1080p** — aggiorna video già generati a 1080p
* **Query attività** — monitora lo stato di generazione e ottieni i risultati

## Prerequisiti

Prima dell'uso, devi ottenere un API Token da XHuoAPI:

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

## Installazione e configurazione

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

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

### Metodo 2: installazione da sorgente

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

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

## Uso 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": {
    "veo": {
      "command": "mcp-veo",
      "env": {
        "XHuoAPI_API_TOKEN": "tuo API Token"
      }
    }
  }
}
```

Se usi `uvx` (non richiede installazione preventiva di pacchetti):

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

Salva la configurazione e riavvia Claude Desktop per usare gli strumenti Veo nelle conversazioni.

## Uso in VS Code / Cursor

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

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

Oppure usa `uvx`:

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

## Elenco strumenti disponibili

| Nome strumento        | Descrizione                          |
| --------------------- | ------------------------------------ |
| `veo_text_to_video`   | Genera video da prompt testuali      |
| `veo_image_to_video`  | Genera video basati su immagini      |
| `veo_get_1080p`       | Aggiorna video a risoluzione 1080p   |
| `veo_get_task`        | Consulta lo stato di un singolo task |
| `veo_get_tasks_batch` | Consulta lo stato di più task        |

## Esempi d'uso

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

* "Aiutami a generare un video time-lapse del cielo stellato con Veo"
* "Genera un video 4K da questa foto di paesaggio"
* "Crea un breve video verticale in formato 9:16"
* "Aggiorna questo video a 1080p"

## Ulteriori informazioni

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