Fixo Logo

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.

Versión:
Actualizado:
Endpoint:https://repair.easeus.com/fixo-mcp/v1

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.

ElementoValor
Endpoint MCPhttps://repair.easeus.com/fixo-mcp/v1
TransporteStreamable HTTP (JSON-RPC)
Herramientas4 (check_file_health, query_upload_url, repair, get_repair_status)
CategoríasVídeo, Foto, Documento y archivo comprimido, Audio
Formatos100+
Tamaño máximo de archivo100 MB por archivo
AutenticaciónOAuth 2.1 — Authorization Code + PKCE, registro dinámico de clientes RFC 7591
Entrega de resultadosURL de la página web de resultados (vista previa + descarga)
Retención de datosEliminació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

  1. Abre Cursor → Settings → MCP
  2. Haz clic en Add New MCP Server
  3. Selecciona el tipo URL
  4. Introduce: https://repair.easeus.com/fixo-mcp/v1
  5. Haz clic en Add

3.3 ChatGPT

ChatGPT admite servidores MCP remotos mediante conectores:

  1. Activa el modo desarrollador en Settings → Connectors → Advanced
  2. Crea un nuevo conector e introduce la URL del servidor MCP: https://repair.easeus.com/fixo-mcp/v1
  3. Completa la autorización OAuth en el navegador
  4. 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ámetroValor
FlujoOAuth 2.1 Authorization Code + PKCE (S256)
Scopesrepair:read (comprobación de estado, estado) · repair:write (subida, reparación)
Registro de clienteRFC 7591 — POST https://repair.easeus.com/fixo-mcp/v1/oauth/register
Metadatos del servidorRFC 8414 — /.well-known/oauth-authorization-server
Metadatos del recursoRFC 9728 — /.well-known/oauth-protected-resource
Respuesta no autorizadaHTTP 401 con un encabezado WWW-Authenticate
TTL del access token12 horas
TTL del refresh token30 días

Flujo de primera conexión

  1. La llamada INITIALIZE devuelve HTTP 401 con un encabezado WWW-Authenticate que apunta a los metadatos del recurso protegido
  2. Tu cliente descubre el servidor de autorización y se registra mediante el registro dinámico de clientes RFC 7591
  3. La página de autorización se abre en el navegador: inicia sesión con tu cuenta de EaseUS y aprueba la solicitud
  4. El cliente intercambia el authorization code (PKCE S256) por tokens y reintenta la llamada de la herramienta automáticamente
Nota: Se requiere una cuenta gratuita de EaseUS para autorizar. Puedes registrarte durante el flujo de autenticación.

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íaFormatos
VídeoMP4, 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
FotoJFIF, 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 comprimidoDOC, 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
AudioMP3, 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).

EstadoSignificadoAcción
PendingTarea aceptada, esperando a un workerConsultar get_repair_status
ProcessingReparación en progresoSeguir consultando; esperar al menos 3 segundos entre llamadas
CompletedReparación completada correctamenteSeguir las instrucciones de descarga en message
FailedNo se pudo completar la reparaciónMostrar el mensaje de error al usuario
NeedPwdEl archivo está protegido con contraseñaPedir la contraseña al usuario y volver a llamar a repair con ella
PwdErrLa contraseña proporcionada era incorrectaPedir 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, NeedPwd o PwdErr
  • La respuesta en message siempre 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.

codeDescripciónResolución
401 (HTTP)No hay bearer token en el endpoint MCPCompleta la autorización OAuth: el encabezado WWW-Authenticate apunta a los metadatos
3file_name no tiene extensiónPasa el nombre original del archivo incluyendo su extensión
2006El token OAuth ha caducadoVuelve a autorizar y reintenta la llamada
5002Se agotó la cuota diaria de reparaciones gratuitasActualiza a Pro en repair.easeus.com o usa la app de escritorio Fixo
ToolErrorParámetros no válidos o fallo del servicio ascendenteLee el mensaje de error, corrige los argumentos y vuelve a intentarlo

9. Límites de uso

LímitePlan gratuitoPro / Cuenta EaseUS
Reparaciones por día1Ilimitado
Tamaño máximo de archivo100 MB100 MB
Consulta de estado1 llamada cada 3 segundos por tarea1 llamada cada 3 segundos por tarea
Nota: Los archivos de más de 100 MB requieren el cliente de escritorio EaseUS Fixo, que admite archivos de hasta varios GB.

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:read cubre las comprobaciones de estado y la consulta de estado; repair:write solo 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

CanalContacto
Portal de soporteeaseus.com/support.html
Correo electrónico[email protected]
Página principal de MCPrepair.easeus.com/mcp/
Reparación onlinerepair.easeus.com
Software de escritorioeaseus.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."
}
¡Tu vídeo se ha reparado correctamente! - Archivo: birthday_repaired.mp4 - Inicia sesión en repair.easeus.com/history-repair/ para previsualizarlo y descargarlo - Sin marca de agua, calidad original completa