> ## 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 Guide de connexion

> sora MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) est un protocole de contexte de modèle lancé par Anthropic, permettant aux modèles d'IA (comme Claude, GPT, etc.) d'appeler des outils externes via une interface standardisée. Grâce au Sora MCP Server fourni par XHuoAPI, vous pouvez directement utiliser OpenAI Sora pour générer des vidéos AI dans des clients AI tels que Claude Desktop, VS Code, Cursor, etc.

## Vue d'ensemble des fonctionnalités

Le Sora MCP Server offre les fonctionnalités principales suivantes :

* **Génération de vidéos à partir de texte** — Générer des vidéos de haute qualité à partir de prompts textuels
* **Génération de vidéos à partir d'images** — Générer des vidéos basées sur des images
* **Vidéos avec cohérence de personnage** — Maintenir la cohérence des personnages à l'aide d'images de référence
* **Génération asynchrone** — Prise en charge de la soumission de tâches asynchrones et de la consultation des résultats
* **Multiples orientations d'image** — Prise en charge du mode paysage (landscape) et portrait
* **Consultation des tâches** — Surveiller l'avancement de la génération et obtenir des résultats

## Préparations préalables

Avant d'utiliser, vous devez obtenir un token API XHuoAPI :

1. Inscrivez-vous ou connectez-vous à la [plateforme XHuoAPI](https://api.xhuoapi.ai)
2. Rendez-vous sur la page [Sora Videos API](https://api.xhuoapi.ai/documents/sora-videos)
3. Cliquez sur « Acquire » pour obtenir un token API (première demande avec un quota gratuit)

## Installation et configuration

### Méthode 1 : installation avec pip (recommandée)

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

### Méthode 2 : installation à partir du code source

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

Une fois l'installation terminée, vous pouvez utiliser la commande `mcp-sora` pour démarrer le service.

## Utilisation dans Claude Desktop

Éditez le fichier de configuration de Claude Desktop :

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

Ajoutez la configuration suivante :

```json theme={null}
{
  "mcpServers": {
    "sora": {
      "command": "mcp-sora",
      "env": {
        "XHuoAPI_API_TOKEN": "votre token API"
      }
    }
  }
}
```

Si vous utilisez `uvx` (pas besoin d'installer le package à l'avance) :

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

Après avoir enregistré la configuration, redémarrez Claude Desktop pour pouvoir utiliser les outils Sora dans la conversation.

## Utilisation dans VS Code / Cursor

Créez un fichier `.vscode/mcp.json` dans le répertoire racine du projet :

```json theme={null}
{
  "servers": {
    "sora": {
      "command": "mcp-sora",
      "env": {
        "XHuoAPI_API_TOKEN": "votre token API"
      }
    }
  }
}
```

Ou utilisez `uvx` :

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

## Liste des outils disponibles

| Nom de l'outil                       | Description                                                        |
| ------------------------------------ | ------------------------------------------------------------------ |
| `sora_generate_video`                | Générer des vidéos à partir de prompts textuels                    |
| `sora_generate_video_from_image`     | Générer des vidéos basées sur des images                           |
| `sora_generate_video_with_character` | Générer des vidéos cohérentes avec des images de référence         |
| `sora_generate_video_async`          | Soumettre des tâches de génération de vidéos de manière asynchrone |
| `sora_get_task`                      | Consulter l'état d'une tâche unique                                |
| `sora_get_tasks_batch`               | Consulter l'état de plusieurs tâches                               |

## Exemples d'utilisation

Une fois la configuration terminée, vous pouvez directement appeler ces fonctionnalités en langage naturel dans le client AI, par exemple :

* « Aidez-moi à générer une vidéo d'un chat courant sur l'herbe avec Sora »
* « Générez une vidéo à partir de cette photo de personne, en maintenant la cohérence du personnage »
* « Générez une vidéo en mode portrait, le contenu est le lever de soleil sur la ville »
* « Générez une vidéo de manière asynchrone et consultez les résultats plus tard »

## Plus d'informations

* Dépôt GitHub : [XHuoAPI/SoraMCP](https://github.com/XHuoAPI/SoraMCP)
* Package PyPI : [mcp-sora](https://pypi.org/project/mcp-sora/)
* Documentation API : [API de génération de vidéos Sora](https://api.xhuoapi.ai/documents/sora)