Fixo MCP Server — Guía completa de integración.
Referencia técnica paso a paso para conectar cualquier agente de IA compatible con MCP a EaseUS Fixo. Incluye autenticación, esquemas de herramientas, flujos asíncronos, manejo de errores y más de 60 formatos de archivo compatibles.
1. Resumen
EaseUS Fixo MCP Server permite que cualquier agente de IA compatible con MCP (Claude, Cursor, ChatGPT, Gemini, Windsurf, Trae, GitHub Copilot y más de 50 más) repare archivos corruptos de vídeo, foto, documento, archivo comprimido y audio a través de una interfaz estandarizada de Model Context Protocol.
Impulsado por los 20 años de experiencia de EaseUS en reparación de datos (más de 120 millones de archivos reparados, valoración de usuarios de 4,8/5), Fixo MCP expone 4 herramientas especializadas que siguen las mejores prácticas de MCP: JSON Schema tipado, soporte para tareas asíncronas y entrega estructurada de resultados.
| Elemento | Valor |
|---|---|
| Endpoint MCP | https://repair.easeus.com/fixo-mcp/v1 |
| Transporte | Streamable HTTP (JSON-RPC) |
| Herramientas | 4 (check_file_health, query_upload_url, repair, get_repair_status) |
| Categorías | Vídeo, Foto, Documento y archivo comprimido, Audio |
| Formatos | 100+ |
| Tamaño máximo de archivo | 100 MB por archivo |
| Autenticación | OAuth 2.1 — Authorization Code + PKCE, registro dinámico de clientes RFC 7591 |
| Entrega de resultados | URL de la página web de resultados (vista previa + descarga) |
| Retención de datos | Eliminación automática 14 días después de la reparación |
2. Inicio rápido — Conexión con un clic
La forma más fácil de conectarse es usar el prompt de un clic desde la página principal de MCP. No es necesario editar JSON manualmente.
Paso 1: Copiar el prompt
Ve a la página principal de MCP y haz clic en Copiar prompt. El prompt contiene:
Agrega el servidor MCP: https://repair.easeus.com/fixo-mcp/v1, OAuth 2.1 Authorization Code + PKCE (S256), no se requiere clave API.
Luego usa la herramienta MCP de fixo para reparar {file path}.Paso 2: Pégalo en tu agente de IA
Abre tu asistente de IA (Claude, Cursor, ChatGPT, etc.) y pega el prompt en una nueva conversación.
Paso 3: La IA se configura automáticamente
La IA lee este documento guía y configura automáticamente la conexión con el servidor Fixo MCP usando la URL correcta del endpoint.
Paso 4: Empieza a reparar archivos
Pídele a tu IA que repare un archivo dañado. Usará las 4 herramientas MCP de Fixo para comprobar el estado, subir el archivo, iniciar la reparación, supervisar el progreso y devolver una URL de la página de resultados.
3. Configuración manual
Si prefieres la configuración manual, configura tu cliente MCP con este endpoint: https://repair.easeus.com/fixo-mcp/v1
3.1 Claude Desktop
Edita ~/.claude.json (macOS/Linux) o %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"fixo": {
"type": "http",
"url": "https://repair.easeus.com/fixo-mcp/v1"
}
}
}Reinicia Claude Desktop. La llamada INITIALIZE activará el flujo de autorización OAuth.
3.2 Cursor
- Abre Cursor → Settings → MCP
- Haz clic en Add New MCP Server
- Selecciona el tipo URL
- Introduce:
https://repair.easeus.com/fixo-mcp/v1 - Haz clic en Add
3.3 ChatGPT
ChatGPT admite servidores MCP remotos mediante conectores:
- Activa el modo desarrollador en Settings → Connectors → Advanced
- Crea un nuevo conector e introduce la URL del servidor MCP:
https://repair.easeus.com/fixo-mcp/v1 - Completa la autorización OAuth en el navegador
- Las herramientas de Fixo ya estarán disponibles en tu conversación
3.4 Otros clientes MCP
Cualquier cliente compatible con MCP que admita Streamable HTTP puede conectarse: Windsurf, Trae, GitHub Copilot, Continue.dev, Cline, Roo Code, etc. Todos usan el mismo endpoint: https://repair.easeus.com/fixo-mcp/v1
4. Autenticación y autorización
Fixo MCP usa OAuth 2.1 (flujo Authorization Code con PKCE S256) para una autorización segura y sin contraseñas. No se necesitan claves API: los clientes se registran automáticamente mediante el registro dinámico de clientes RFC 7591.
| Parámetro | Valor |
|---|---|
| Flujo | OAuth 2.1 Authorization Code + PKCE (S256) |
| Scopes | repair:read (comprobación de estado, estado) · repair:write (subida, reparación) |
| Registro de cliente | RFC 7591 — POST https://repair.easeus.com/fixo-mcp/v1/oauth/register |
| Metadatos del servidor | RFC 8414 — /.well-known/oauth-authorization-server |
| Metadatos del recurso | RFC 9728 — /.well-known/oauth-protected-resource |
| Respuesta no autorizada | HTTP 401 con un encabezado WWW-Authenticate |
| TTL del access token | 12 horas |
| TTL del refresh token | 30 días |
Flujo de primera conexión
- La llamada INITIALIZE devuelve HTTP 401 con un encabezado
WWW-Authenticateque apunta a los metadatos del recurso protegido - Tu cliente descubre el servidor de autorización y se registra mediante el registro dinámico de clientes RFC 7591
- La página de autorización se abre en el navegador: inicia sesión con tu cuenta de EaseUS y aprueba la solicitud
- El cliente intercambia el authorization code (PKCE S256) por tokens y reintenta la llamada de la herramienta automáticamente
5. Catálogo de herramientas — 4 herramientas MCP
Todas las herramientas siguen el método JSON-RPC tools/call de MCP con JSON Schema tipado para entradas y salidas.
check_file_health
Comprueba si un archivo está en buen estado y es apto para reparación. Es el primer paso recomendado antes de cualquier reparación: sugiéreselo al usuario y ejecútalo solo con su consentimiento. Comprobaciones locales previas: rechazar archivos de 0 bytes, rechazar archivos donde todos los bytes tengan el mismo valor y verificar que los bytes de cabecera y pie coincidan con la extensión.
Input: file_name (obligatorio, incl. extensión), file_url (obligatorio — download_url de query_upload_url)
Output: health_status (Intact | Unknown | Damaged), message
Scope: repair:read
query_upload_url
Obtiene la URL de carga de S3 y los campos del formulario necesarios para subir un archivo local (máx. 100 MB). Sube el archivo con un POST multipart/form-data a upload_url que incluya cada par clave-valor de fields más el propio archivo (preferiblemente con curl usando una opción -F por cada entrada de fields). Cuando la carga se complete, pasa download_url como file_url a las demás herramientas.
Input: file_name (obligatorio, incl. extensión)
Output: upload_url, download_url, fields, message (instrucciones de subida)
Scope: repair:write
repair
Crea e inicia una tarea de reparación para un archivo ya subido. Si get_repair_status devuelve NeedPwd o PwdErr, pide al usuario la contraseña del archivo y vuelve a llamar con el mismo file_name y file_url más password.
Input: file_name (obligatorio), file_url (obligatorio), password (opcional — solo para archivos cifrados)
Output: task_id, error (0 en caso de éxito), message
Scope: repair:write
get_repair_status
Comprueba el estado y el progreso (0–100) de una tarea de reparación creada por repair. Mientras el estado sea Pending o Processing, espera al menos 3 segundos entre llamadas. Deja de consultar cuando llegue a Completed, Failed, NeedPwd o PwdErr. El mensaje de respuesta contiene la acción siguiente recomendada.
Input: task_id (obligatorio — devuelto por repair)
Output: status, progress (0–100), message
Scope: repair:read
Ejemplo de esquema de entrada/salida (repair)
// Entrada
{
"file_name": "birthday.mp4",
"file_url": "https://d225fhq0dla1l8.cloudfront.net/upload/birthday.mp4"
}
// Salida
{
"code": 200,
"task_id": "fixo_a1b2c3d4e5",
"error": 0,
"message": "La tarea de reparación se creó correctamente."
}6. Formatos de archivo compatibles (100+)
| Categoría | Formatos |
|---|---|
| Vídeo | 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 |
| Foto | 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 |
| Documento y archivo comprimido | 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. Tareas asíncronas y entrega de resultados
La reparación se ejecuta de forma asíncrona. Ciclo de vida de la tarea: Pending → Processing → Completed / Failed (con NeedPwd / PwdErr para archivos cifrados).
| Estado | Significado | Acción |
|---|---|---|
Pending | Tarea aceptada, esperando a un worker | Consultar get_repair_status |
Processing | Reparación en progreso | Seguir consultando; esperar al menos 3 segundos entre llamadas |
Completed | Reparación completada correctamente | Seguir las instrucciones de descarga en message |
Failed | No se pudo completar la reparación | Mostrar el mensaje de error al usuario |
NeedPwd | El archivo está protegido con contraseña | Pedir la contraseña al usuario y volver a llamar a repair con ella |
PwdErr | La contraseña proporcionada era incorrecta | Pedir la contraseña correcta y volver a llamar a repair |
Buenas prácticas de sondeo
- Espera al menos 3 segundos entre llamadas a
get_repair_status - Deja de consultar cuando llegue a
Completed,Failed,NeedPwdoPwdErr - La respuesta en
messagesiempre contiene la acción siguiente recomendada
Entrega de resultados
- Los archivos binarios nunca entran en el contexto de la IA, lo que ahorra tokens
- Cuando el estado sea
Completed, inicia sesión en repair.easeus.com/history-repair/ para descargar el archivo reparado - Sin marca de agua, calidad original completa
8. Manejo de errores
Los errores se devuelven como errores de herramienta MCP (ToolError) o como resultados estructurados con un campo code distinto de 200.
| code | Descripción | Resolución |
|---|---|---|
| 401 (HTTP) | No hay bearer token en el endpoint MCP | Completa la autorización OAuth: el encabezado WWW-Authenticate apunta a los metadatos |
| 3 | file_name no tiene extensión | Pasa el nombre original del archivo incluyendo su extensión |
| 2006 | El token OAuth ha caducado | Vuelve a autorizar y reintenta la llamada |
| 5002 | Se agotó la cuota diaria de reparaciones gratuitas | Actualiza a Pro en repair.easeus.com o usa la app de escritorio Fixo |
| ToolError | Parámetros no válidos o fallo del servicio ascendente | Lee el mensaje de error, corrige los argumentos y vuelve a intentarlo |
9. Límites de uso
| Límite | Plan gratuito | Pro / Cuenta EaseUS |
|---|---|---|
| Reparaciones por día | 1 | Ilimitado |
| Tamaño máximo de archivo | 100 MB | 100 MB |
| Consulta de estado | 1 llamada cada 3 segundos por tarea | 1 llamada cada 3 segundos por tarea |
10. Seguridad y privacidad
- Cifrado: TLS en tránsito para todo el tráfico MCP, de subida y de descarga
- OAuth 2.1: Authorization Code + PKCE garantiza una autorización segura sin exponer contraseñas al cliente de IA
- Mínimo privilegio:
repair:readcubre las comprobaciones de estado y la consulta de estado;repair:writesolo se requiere para subidas y reparaciones - Privacidad: Los archivos nunca se comparten con terceros y nunca se usan para entrenar IA
- Retención de datos: El archivo se eliminará automáticamente al cabo de 14 días
- Cumplimiento: GDPR, CCPA, SOC 2 Type II, ISO 27001
11. Preguntas frecuentes
¿Qué es Fixo MCP Server?
Fixo MCP Server es una implementación del Model Context Protocol que permite a los agentes de IA reparar archivos corruptos de vídeo, foto, documento, archivo comprimido y audio mediante 4 herramientas MCP estandarizadas.
¿Qué clientes de IA son compatibles con Fixo MCP?
Cualquier cliente compatible con MCP que admita Streamable HTTP: Claude Desktop, Claude Code, Cursor, GitHub Copilot, ChatGPT, Google Gemini, Windsurf, Trae, Continue.dev, Cline, Roo Code y más de 50 clientes adicionales.
¿Fixo MCP es gratuito?
Sí. Todos los usuarios disponen de 1 reparación gratuita al día (máximo 100 MB). Los titulares de una cuenta EaseUS Pro tienen reparaciones ilimitadas al día. Los archivos de más de 100 MB requieren el cliente de escritorio.
¿Necesito instalar algo?
No. Fixo MCP es un servicio en la nube al que se accede mediante el endpoint Streamable HTTP. Solo necesitas un cliente de IA compatible con MCP.
¿Dónde encuentro mis archivos reparados?
Cuando una tarea llegue a Completed, inicia sesión con tu cuenta en repair.easeus.com/history-repair/ para previsualizar y descargar el archivo reparado. Sin marca de agua y con la calidad original completa.
¿Cuánto tarda la reparación?
La mayoría de los archivos se reparan en 30–60 segundos. Los archivos más grandes o muy dañados pueden tardar unos minutos. La herramienta get_repair_status muestra el progreso en tiempo real (0–100).
12. Soporte y contacto
| Canal | Contacto |
|---|---|
| Portal de soporte | easeus.com/support.html |
| Correo electrónico | [email protected] |
| Página principal de MCP | repair.easeus.com/mcp/ |
| Reparación online | repair.easeus.com |
| Software de escritorio | easeus.com/repair-tools |
Fixo MCP aparece en los directorios Smithery, Glama, PulseMCP y mcp.so.
Apéndice: Ejemplo completo — Reparar un vídeo corrupto
Paso 1: Obtener la URL de carga
// Llamada
{ "name": "query_upload_url", "arguments": { "file_name": "birthday.mp4" } }
// Resultado
{
"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": "Después de recibir la URL de carga y antes de subir el archivo, comprueba si el archivo local supera los 100 MB..."
}
}Paso 2: Subir el archivo
Envía un POST multipart/form-data a upload_url con cada entrada de fields más el propio archivo:
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/Paso 3: Comprobar el estado del archivo (opcional, recomendado)
// Llamada
{ "name": "check_file_health", "arguments": { "file_name": "birthday.mp4", "file_url": "https://d225fhq0dla1l8.cloudfront.net/upload/birthday.mp4" } }
// Resultado
{
"code": 200,
"health_status": "Damaged",
"message": "El archivo está dañado. Llama a la herramienta repair con el mismo file_name y file_url para repararlo."
}Paso 4: Iniciar la reparación
// Llamada
{ "name": "repair", "arguments": { "file_name": "birthday.mp4", "file_url": "https://d225fhq0dla1l8.cloudfront.net/upload/birthday.mp4" } }
// Resultado
{
"code": 200,
"task_id": "fixo_a1b2c3d4e5",
"error": 0,
"message": "La tarea de reparación se creó correctamente."
}Paso 5: Consultar el estado hasta que termine
// Consulta, esperando al menos 3 segundos entre llamadas
{ "name": "get_repair_status", "arguments": { "task_id": "fixo_a1b2c3d4e5" } }
// Resultado final
{
"code": 200,
"task_id": "fixo_a1b2c3d4e5",
"status": "Completed",
"progress": 100,
"message": "La reparación se ha completado. Inicia sesión con tu cuenta en https://repair.easeus.com/history-repair/ y descarga el archivo reparado."
}