Serveur MCP Fixo — Guide d'intégration complet.
Référence technique pas à pas pour connecter tout agent IA compatible MCP à EaseUS Fixo. Couvre l'authentification, les schémas d'outils, les flux asynchrones, la gestion des erreurs et plus de 60 formats de fichiers pris en charge.
1. Vue d'ensemble
Le serveur MCP EaseUS Fixo permet à tout agent IA compatible MCP (Claude, Cursor, ChatGPT, Gemini, Windsurf, Trae, GitHub Copilot et plus de 50 autres) de réparer des fichiers vidéo, photo, document, archive et audio corrompus via une interface Model Context Protocol standardisée.
S'appuyant sur les 20 ans d'expertise d'EaseUS en réparation de données (120 M+ de fichiers réparés, note utilisateur de 4,8/5), Fixo MCP expose 4 outils spécialisés conformes aux bonnes pratiques MCP : JSON Schema typé, prise en charge des tâches asynchrones et livraison structurée des résultats.
| Élément | Valeur |
|---|---|
| Point de terminaison MCP | https://repair.easeus.com/fixo-mcp/v1 |
| Transport | Streamable HTTP (JSON-RPC) |
| Outils | 4 (check_file_health, query_upload_url, repair, get_repair_status) |
| Catégories | Vidéo, Photo, Document et archive, Audio |
| Formats | 100+ |
| Taille maximale du fichier | 100 MB par fichier |
| Authentification | OAuth 2.1 — Authorization Code + PKCE, enregistrement dynamique de client RFC 7591 |
| Livraison du résultat | URL de la page de résultats Web (aperçu + téléchargement) |
| Conservation des données | Suppression automatique 14 jours après la réparation |
2. Démarrage rapide — Connexion en un clic
Le moyen le plus simple de se connecter consiste à utiliser le prompt en un clic depuis la page d'accueil MCP. Aucune modification manuelle du JSON n'est requise.
Étape 1 : Copier le prompt
Accédez à la page d'accueil MCP et cliquez sur Copier le prompt. Le prompt contient :
Ajoutez le serveur MCP : https://repair.easeus.com/fixo-mcp/v1, OAuth 2.1 Authorization Code + PKCE (S256), aucune clé API requise.
Utilisez ensuite l'outil MCP fixo pour réparer {file path}.Étape 2 : Coller dans votre agent IA
Ouvrez votre assistant IA (Claude, Cursor, ChatGPT, etc.) et collez le prompt dans une nouvelle conversation.
Étape 3 : Configuration automatique par l'IA
L'IA lit ce guide et configure automatiquement la connexion au serveur Fixo MCP avec la bonne URL de point de terminaison.
Étape 4 : Commencer à réparer des fichiers
Demandez à votre IA de réparer un fichier corrompu. Elle utilisera les 4 outils MCP de Fixo pour vérifier l'état, téléverser le fichier, lancer la réparation, suivre la progression et renvoyer une URL de page de résultats.
3. Configuration manuelle
Si vous préférez une configuration manuelle, configurez votre client MCP avec le point de terminaison suivant : https://repair.easeus.com/fixo-mcp/v1
3.1 Claude Desktop
Modifiez ~/.claude.json (macOS/Linux) ou %APPDATA%\Claude\claude_desktop_config.json (Windows) :
{
"mcpServers": {
"fixo": {
"type": "http",
"url": "https://repair.easeus.com/fixo-mcp/v1"
}
}
}Redémarrez Claude Desktop. L'appel INITIALIZE déclenchera le flux d'autorisation OAuth.
3.2 Cursor
- Ouvrez Cursor → Settings → MCP
- Cliquez sur Add New MCP Server
- Sélectionnez le type URL
- Entrez :
https://repair.easeus.com/fixo-mcp/v1 - Cliquez sur Add
3.3 ChatGPT
ChatGPT prend en charge les serveurs MCP distants via des connecteurs :
- Activez le mode développeur dans Settings → Connectors → Advanced
- Créez un nouveau connecteur et saisissez l'URL du serveur MCP :
https://repair.easeus.com/fixo-mcp/v1 - Terminez l'autorisation OAuth dans le navigateur
- Les outils Fixo sont désormais disponibles dans votre conversation
3.4 Autres clients MCP
Tout client compatible MCP prenant en charge Streamable HTTP peut se connecter : Windsurf, Trae, GitHub Copilot, Continue.dev, Cline, Roo Code, etc. Tous utilisent le même point de terminaison : https://repair.easeus.com/fixo-mcp/v1
4. Authentification et autorisation
Fixo MCP utilise OAuth 2.1 (flux Authorization Code avec PKCE S256) pour une autorisation sécurisée sans mot de passe. Aucune clé API n'est nécessaire — les clients s'enregistrent à la volée via l'enregistrement dynamique de client RFC 7591.
| Paramètre | Valeur |
|---|---|
| Flux | OAuth 2.1 Authorization Code + PKCE (S256) |
| Scopes | repair:read (contrôle d'état, statut) · repair:write (téléversement, réparation) |
| Enregistrement du client | RFC 7591 — POST https://repair.easeus.com/fixo-mcp/v1/oauth/register |
| Métadonnées du serveur | RFC 8414 — /.well-known/oauth-authorization-server |
| Métadonnées de la ressource | RFC 9728 — /.well-known/oauth-protected-resource |
| Réponse non autorisée | HTTP 401 avec un en-tête WWW-Authenticate |
| TTL du jeton d'accès | 12 heures |
| TTL du jeton d'actualisation | 30 jours |
Flux de première connexion
- L'appel INITIALIZE renvoie HTTP 401 avec un en-tête
WWW-Authenticatepointant vers les métadonnées de la ressource protégée - Votre client découvre le serveur d'autorisation et s'enregistre via l'enregistrement dynamique de client RFC 7591
- La page d'autorisation s'ouvre dans un navigateur — connectez-vous avec votre compte EaseUS et approuvez la demande
- Le client échange l'authorization code (PKCE S256) contre des jetons et relance automatiquement l'appel d'outil
5. Catalogue des outils — 4 outils MCP
Tous les outils suivent la méthode JSON-RPC tools/call de MCP avec un JSON Schema typé pour les entrées et les sorties.
check_file_health
Vérifie si un fichier est sain et peut être réparé. Première étape recommandée avant toute réparation — suggérez-le à l'utilisateur et exécutez-le uniquement avec son consentement. Pré-contrôles locaux : rejeter les fichiers de 0 octet, rejeter les fichiers dont chaque octet a la même valeur et vérifier que les octets d'en-tête/de pied correspondent à l'extension.
Input: file_name (obligatoire, extension comprise), file_url (obligatoire — download_url de query_upload_url)
Output: health_status (Intact | Unknown | Damaged), message
Scope: repair:read
query_upload_url
Récupère l'URL d'envoi S3 et les champs de formulaire nécessaires pour téléverser un fichier local (max. 100 MB). Téléversez avec un POST multipart/form-data vers upload_url contenant chaque paire clé-valeur de fields ainsi que le fichier lui-même (de préférence avec curl en utilisant une option -F par entrée de fields). Une fois le téléversement réussi, transmettez download_url comme file_url aux autres outils.
Input: file_name (obligatoire, extension comprise)
Output: upload_url, download_url, fields, message (instructions de téléversement)
Scope: repair:write
repair
Crée et lance une tâche de réparation pour un fichier téléversé. Si get_repair_status renvoie NeedPwd ou PwdErr, demandez à l'utilisateur le mot de passe du fichier, puis relancez l'appel avec le même file_name et file_url plus password.
Input: file_name (obligatoire), file_url (obligatoire), password (facultatif — fichiers chiffrés uniquement)
Output: task_id, error (0 en cas de succès), message
Scope: repair:write
get_repair_status
Vérifie le statut et la progression (0–100) d'une tâche de réparation créée par repair. Tant que le statut est Pending ou Processing, attendez au moins 3 secondes entre les appels. Arrêtez l'interrogation à Completed, Failed, NeedPwd ou PwdErr. Le message de réponse contient l'action suivante recommandée.
Input: task_id (obligatoire — renvoyé par repair)
Output: status, progress (0–100), message
Scope: repair:read
Exemple de schéma d'entrée/sortie (repair)
// Entrée
{
"file_name": "birthday.mp4",
"file_url": "https://d225fhq0dla1l8.cloudfront.net/upload/birthday.mp4"
}
// Sortie
{
"code": 200,
"task_id": "fixo_a1b2c3d4e5",
"error": 0,
"message": "Tâche de réparation créée avec succès."
}6. Formats de fichiers pris en charge (100+)
| Catégorie | Formats |
|---|---|
| Vidéo | MP4, MOV, MKV, WEBM, AVI, ASF, WMV, M4V, 3GP, 3G2, FLV, SWF, MPG, RM, RMVB, MPEG, INSV, MTS, M2TS, TS, RSV, DAT, MXF, BRAW, OGV, DIVX, DV, CRM, LRV, LRF, R3D |
| Photo | JFIF, JPE, JIF, JPG, JPEG, PNG, GIF, CR2, CR3, CRW, NEF, NRW, TIF, TIFF, DNG, ARW, RAF, GPR, ORF, SR2, X3F, HEIC, BMP, RW2, RAW, AVIF, WEBP, SVG, SRW, ERF, PEF, SRF, MRW, 3FR, JXL |
| Document et archive | DOC, DOCX, DOCM, DOTM, DOTX, XLS, XLSX, XLSM, XLTM, XLTX, PPT, PPTX, PPTM, POTM, POTX, PDF, ZIP, ZIPX, EXE, XML, RAR, HTML, AI, PSD, PSB, HWP, PAGES, NUMBERS, KEY, CSV, 7Z, RTF, TXT, HWPX, PST, DXF |
| Audio | MP3, AAC, WAV, FLAC, M4A, WMA, AIF, AIFF, OGG, OGA, APE |
7. Tâches asynchrones et livraison des résultats
La réparation s'exécute de manière asynchrone. Cycle de vie de la tâche : Pending → Processing → Completed / Failed (avec NeedPwd / PwdErr pour les fichiers chiffrés).
| Statut | Signification | Action |
|---|---|---|
Pending | Tâche acceptée, en attente d'un worker | Interroger get_repair_status |
Processing | Réparation en cours | Continuer l'interrogation — attendre au moins 3 secondes entre les appels |
Completed | Réparation terminée avec succès | Suivre les instructions de téléchargement dans message |
Failed | La réparation n'a pas pu être terminée | Présenter le message d'échec à l'utilisateur |
NeedPwd | Le fichier est protégé par mot de passe | Demander le mot de passe à l'utilisateur et relancer repair avec celui-ci |
PwdErr | Le mot de passe fourni était incorrect | Demander le bon mot de passe et relancer repair |
Bonnes pratiques d'interrogation
- Attendez au moins 3 secondes entre les appels à
get_repair_status - Arrêtez l'interrogation à
Completed,Failed,NeedPwdouPwdErr - La réponse
messagecontient toujours l'action suivante recommandée
Livraison des résultats
- Les fichiers binaires n'entrent jamais dans le contexte de l'IA — cela économise des jetons
- À l'état
Completed, connectez-vous sur repair.easeus.com/history-repair/ pour télécharger le fichier réparé - Sans filigrane, qualité d'origine complète
8. Gestion des erreurs
Les erreurs sont renvoyées soit comme erreurs d'outil MCP (ToolError), soit comme résultats structurés avec un champ code différent de 200.
| code | Description | Résolution |
|---|---|---|
| 401 (HTTP) | Aucun bearer token sur le point de terminaison MCP | Terminez l'autorisation OAuth — l'en-tête WWW-Authenticate pointe vers les métadonnées |
| 3 | file_name n'a pas d'extension | Transmettez le nom de fichier d'origine avec son extension |
| 2006 | Le jeton OAuth a expiré | Réautorisez et réessayez l'appel |
| 5002 | Quota quotidien de réparations gratuites épuisé | Passez à Pro sur repair.easeus.com ou utilisez l'application de bureau Fixo |
| ToolError | Paramètres invalides ou échec du service en amont | Lisez le message d'erreur, corrigez les arguments et réessayez |
9. Limites de débit
| Limite | Offre gratuite | Pro / Compte EaseUS |
|---|---|---|
| Réparations par jour | 1 | Illimité |
| Taille maximale du fichier | 100 MB | 100 MB |
| Interrogation du statut | 1 appel toutes les 3 secondes par tâche | 1 appel toutes les 3 secondes par tâche |
10. Sécurité et confidentialité
- Chiffrement : TLS en transit pour tout le trafic MCP, de téléversement et de téléchargement
- OAuth 2.1 : Authorization Code + PKCE garantit une autorisation sécurisée sans exposer les mots de passe au client IA
- Moindre privilège :
repair:readcouvre les contrôles d'état et l'interrogation du statut ;repair:writen'est requis que pour les téléversements et les réparations - Confidentialité : Les fichiers ne sont jamais partagés avec des tiers et ne sont jamais utilisés pour l'entraînement de l'IA
- Conservation des données : Le fichier sera automatiquement supprimé après 14 jours
- Conformité : GDPR, CCPA, SOC 2 Type II, ISO 27001
11. FAQ
Qu'est-ce que le serveur Fixo MCP ?
Le serveur Fixo MCP est une implémentation du Model Context Protocol qui permet aux agents IA de réparer des fichiers vidéo, photo, document, archive et audio corrompus grâce à 4 outils MCP standardisés.
Quels clients IA prennent en charge Fixo MCP ?
Tout client compatible MCP prenant en charge Streamable HTTP : Claude Desktop, Claude Code, Cursor, GitHub Copilot, ChatGPT, Google Gemini, Windsurf, Trae, Continue.dev, Cline, Roo Code et plus de 50 autres.
Fixo MCP est-il gratuit ?
Oui. Tous les utilisateurs bénéficient d'une réparation gratuite par jour (100 MB maximum). Les titulaires d'un compte EaseUS Pro bénéficient de réparations illimitées par jour. Les fichiers de plus de 100 MB nécessitent le client de bureau.
Dois-je installer quelque chose ?
Non. Fixo MCP est un service cloud accessible via le point de terminaison Streamable HTTP. Vous avez seulement besoin d'un client IA compatible MCP.
Où trouver mes fichiers réparés ?
Lorsqu'une tâche atteint l'état Completed, connectez-vous avec votre compte sur repair.easeus.com/history-repair/ pour prévisualiser et télécharger le fichier réparé. Sans filigrane, avec la qualité d'origine complète.
Combien de temps prend une réparation ?
La plupart des fichiers sont réparés en 30 à 60 secondes. Les fichiers plus volumineux ou fortement corrompus peuvent prendre quelques minutes. L'outil get_repair_status affiche la progression en temps réel (0–100).
12. Support et contact
| Canal | Contact |
|---|---|
| Portail de support | easeus.com/support.html |
| [email protected] | |
| Page d'accueil MCP | repair.easeus.com/mcp/ |
| Réparation en ligne | repair.easeus.com |
| Logiciel de bureau | easeus.com/repair-tools |
Fixo MCP est répertorié dans les annuaires Smithery, Glama, PulseMCP et mcp.so.
Annexe : Exemple complet — Réparer une vidéo corrompue
Étape 1 : Obtenir l'URL de téléversement
// Appel
{ "name": "query_upload_url", "arguments": { "file_name": "birthday.mp4" } }
// Résultat
{
"code": 200,
"data": {
"upload_url": "https://fixo-uploads.s3.amazonaws.com/",
"download_url": "https://d225fhq0dla1l8.cloudfront.net/upload/birthday.mp4",
"fields": {
"key": "upload/birthday.mp4",
"policy": "eyJleHBpcmF0aW9uIjoi...",
"x-amz-algorithm": "AWS4-HMAC-SHA256",
"x-amz-signature": "a1b2c3..."
},
"message": "Après avoir reçu l'URL de téléversement et avant d'envoyer le fichier, vérifiez si le fichier local dépasse 100 MB..."
}
}Étape 2 : Téléverser le fichier
Envoyez une requête POST multipart/form-data vers upload_url avec chaque entrée de fields plus le fichier lui-même :
curl -F "key=upload/birthday.mp4" \
-F "policy=eyJleHBpcmF0aW9uIjoi..." \
-F "x-amz-algorithm=AWS4-HMAC-SHA256" \
-F "x-amz-signature=a1b2c3..." \
-F "file=@/path/to/birthday.mp4" \
https://fixo-uploads.s3.amazonaws.com/Étape 3 : Vérifier l'état du fichier (facultatif, recommandé)
// Appel
{ "name": "check_file_health", "arguments": { "file_name": "birthday.mp4", "file_url": "https://d225fhq0dla1l8.cloudfront.net/upload/birthday.mp4" } }
// Résultat
{
"code": 200,
"health_status": "Damaged",
"message": "Le fichier est endommagé. Appelez l'outil de réparation avec le même file_name et file_url pour le réparer."
}Étape 4 : Lancer la réparation
// Appel
{ "name": "repair", "arguments": { "file_name": "birthday.mp4", "file_url": "https://d225fhq0dla1l8.cloudfront.net/upload/birthday.mp4" } }
// Résultat
{
"code": 200,
"task_id": "fixo_a1b2c3d4e5",
"error": 0,
"message": "Tâche de réparation créée avec succès."
}Étape 5 : Interroger le statut jusqu'à la fin
// Interrogation, en attendant au moins 3 secondes entre les appels
{ "name": "get_repair_status", "arguments": { "task_id": "fixo_a1b2c3d4e5" } }
// Résultat final
{
"code": 200,
"task_id": "fixo_a1b2c3d4e5",
"status": "Completed",
"progress": 100,
"message": "Réparation terminée. Connectez-vous avec votre compte sur https://repair.easeus.com/history-repair/ puis téléchargez le fichier réparé."
}