> ## 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 Guia de Integração

> sora MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) é um protocolo de contexto de modelo lançado pela Anthropic, que permite que modelos de IA (como Claude, GPT, etc.) chamem ferramentas externas através de interfaces padronizadas. Através do Sora MCP Server fornecido pela XHuoAPI, você pode usar diretamente o OpenAI Sora para gerar vídeos de IA em clientes de IA como Claude Desktop, VS Code, Cursor, entre outros.

## Visão Geral das Funcionalidades

O Sora MCP Server oferece as seguintes funcionalidades principais:

* **Geração de vídeo a partir de texto** — Gera vídeos de alta qualidade a partir de prompts de texto
* **Geração de vídeo a partir de imagem** — Gera vídeos com base em imagens
* **Vídeo com consistência de personagem** — Mantém a consistência do personagem usando imagens de referência
* **Geração assíncrona** — Suporta envio de tarefas assíncronas e consulta de resultados
* **Vários formatos de tela** — Suporta paisagem (landscape) e retrato (portrait)
* **Consulta de tarefas** — Monitora o progresso da geração e obtém resultados

## Preparativos

Antes de usar, você precisa obter o Token da API da XHuoAPI:

1. Registre-se ou faça login na [plataforma XHuoAPI](https://api.xhuoapi.ai)
2. Vá para a página [Sora Videos API](https://api.xhuoapi.ai/documents/sora-videos)
3. Clique em "Acquire" para obter o Token da API (o primeiro pedido oferece um crédito gratuito)

## Instalação e Configuração

### Método 1: Instalação via pip (recomendado)

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

### Método 2: Instalação a partir do código-fonte

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

Após a instalação, você pode usar o comando `mcp-sora` para iniciar o serviço.

## Usando no Claude Desktop

Edite o arquivo de configuração do Claude Desktop:

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

Adicione a seguinte configuração:

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

Se usar `uvx` (sem necessidade de instalar pacotes previamente):

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

Salve a configuração e reinicie o Claude Desktop para usar as ferramentas relacionadas ao Sora nas conversas.

## Usando no VS Code / Cursor

Crie um arquivo `.vscode/mcp.json` no diretório raiz do projeto:

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

Ou use `uvx`:

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

## Lista de Ferramentas Disponíveis

| Nome da Ferramenta                   | Descrição                                             |
| ------------------------------------ | ----------------------------------------------------- |
| `sora_generate_video`                | Gera vídeo a partir de prompts de texto               |
| `sora_generate_video_from_image`     | Gera vídeo com base em imagens                        |
| `sora_generate_video_with_character` | Gera vídeo consistente usando imagens de referência   |
| `sora_generate_video_async`          | Envia tarefas de geração de vídeo de forma assíncrona |
| `sora_get_task`                      | Consulta o status de uma única tarefa                 |
| `sora_get_tasks_batch`               | Consulta o status de várias tarefas                   |

## Exemplos de Uso

Após a configuração, você pode chamar essas funcionalidades diretamente em linguagem natural nos clientes de IA, por exemplo:

* "Ajude-me a gerar um vídeo de um gato correndo na grama com o Sora"
* "Gere um vídeo a partir desta foto de uma pessoa, mantendo a consistência do personagem"
* "Gere um vídeo em formato retrato, com o conteúdo sendo o nascer do sol na cidade"
* "Gere um vídeo de forma assíncrona e consulte os resultados mais tarde"

## Mais Informações

* Repositório no GitHub: [XHuoAPI/SoraMCP](https://github.com/XHuoAPI/SoraMCP)
* Pacote PyPI: [mcp-sora](https://pypi.org/project/mcp-sora/)
* Documentação da API: [API de Geração de Vídeos Sora](https://api.xhuoapi.ai/documents/sora)