Fixo Logo

Fixo MCP Server — Vollständiger Integrationsleitfaden.

Schritt-für-Schritt-Referenz zum Verbinden beliebiger MCP-kompatibler KI-Agenten mit EaseUS Fixo. Behandelt Authentifizierung, Tool-Schemata, asynchrone Abläufe, Fehlerbehandlung und mehr als 60 unterstützte Dateiformate.

Version:
Aktualisiert:
Endpunkt:https://repair.easeus.com/fixo-mcp/v1

1. Überblick

EaseUS Fixo MCP Server ermöglicht es jedem MCP-kompatiblen KI-Agenten (Claude, Cursor, ChatGPT, Gemini, Windsurf, Trae, GitHub Copilot und über 50 weiteren), beschädigte Video-, Foto-, Dokument-, Archiv- und Audiodateien über eine standardisierte Model-Context-Protocol-Schnittstelle zu reparieren.

Basierend auf 20 Jahren Datenreparatur-Expertise von EaseUS (120 Mio.+ reparierte Dateien, Nutzerbewertung 4,8/5) stellt Fixo MCP vier spezialisierte Tools bereit, die den MCP-Best Practices folgen: typisiertes JSON-Schema, Unterstützung asynchroner Aufgaben und strukturierte Ergebnisbereitstellung.

ElementWert
MCP-Endpunkthttps://repair.easeus.com/fixo-mcp/v1
TransportStreamable HTTP (JSON-RPC)
Tools4 (check_file_health, query_upload_url, repair, get_repair_status)
KategorienVideo, Foto, Dokument & Archiv, Audio
Formate100+
Maximale Dateigröße100 MB pro Datei
AuthentifizierungOAuth 2.1 — Authorization Code + PKCE, dynamische Client-Registrierung nach RFC 7591
ErgebnisbereitstellungURL zur Webergebnisseite (Vorschau + Download)
DatenaufbewahrungAutomatische Löschung 14 Tage nach der Reparatur

2. Schnellstart — Verbindung mit einem Klick

Am einfachsten verbinden Sie sich über den Ein-Klick-Prompt auf der MCP-Startseite. Es ist keine manuelle Bearbeitung der JSON-Datei erforderlich.

Schritt 1: Prompt kopieren

Gehen Sie zu der MCP-Startseite und klicken Sie auf Prompt kopieren. Der Prompt enthält:

MCP-Server hinzufügen: https://repair.easeus.com/fixo-mcp/v1, OAuth 2.1 Authorization Code + PKCE (S256), kein API-Schlüssel erforderlich.
Verwenden Sie dann das Fixo-MCP-Tool, um {file path} zu reparieren.

Schritt 2: In Ihren KI-Agenten einfügen

Öffnen Sie Ihren KI-Assistenten (Claude, Cursor, ChatGPT usw.) und fügen Sie den Prompt in eine neue Unterhaltung ein.

Schritt 3: KI konfiguriert automatisch

Die KI liest diesen Leitfaden und konfiguriert die Verbindung zum Fixo MCP Server automatisch mit der korrekten Endpunkt-URL.

Schritt 4: Dateien reparieren

Bitten Sie Ihre KI, eine beschädigte Datei zu reparieren. Sie verwendet die vier MCP-Tools von Fixo, um den Zustand zu prüfen, hochzuladen, die Reparatur zu starten, den Fortschritt zu überwachen und eine URL zur Ergebnisseite zurückzugeben.

3. Manuelle Konfiguration

Wenn Sie die manuelle Einrichtung bevorzugen, konfigurieren Sie Ihren MCP-Client mit dem Endpunkt: https://repair.easeus.com/fixo-mcp/v1

3.1 Claude Desktop

Bearbeiten Sie ~/.claude.json (macOS/Linux) oder %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "fixo": {
      "type": "http",
      "url": "https://repair.easeus.com/fixo-mcp/v1"
    }
  }
}

Starten Sie Claude Desktop neu. Der INITIALIZE-Aufruf löst den OAuth-Autorisierungsablauf aus.

3.2 Cursor

  1. Öffnen Sie Cursor → Settings → MCP
  2. Klicken Sie auf Add New MCP Server
  3. Wählen Sie den Typ URL
  4. Geben Sie Folgendes ein: https://repair.easeus.com/fixo-mcp/v1
  5. Klicken Sie auf Add

3.3 ChatGPT

ChatGPT unterstützt entfernte MCP-Server über Connectoren:

  1. Aktivieren Sie den Entwicklermodus unter Settings → Connectors → Advanced
  2. Erstellen Sie einen neuen Connector und geben Sie die MCP-Server-URL ein: https://repair.easeus.com/fixo-mcp/v1
  3. Schließen Sie die OAuth-Autorisierung im Browser ab
  4. Die Fixo-Tools stehen nun in Ihrer Unterhaltung zur Verfügung

3.4 Weitere MCP-Clients

Jeder MCP-kompatible Client mit Unterstützung für Streamable HTTP kann eine Verbindung herstellen: Windsurf, Trae, GitHub Copilot, Continue.dev, Cline, Roo Code usw. Alle verwenden denselben Endpunkt: https://repair.easeus.com/fixo-mcp/v1

4. Authentifizierung & Autorisierung

Fixo MCP verwendet OAuth 2.1 (Authorization-Code-Flow mit PKCE S256) für eine sichere, passwortlose Autorisierung. Es werden keine API-Schlüssel benötigt — Clients registrieren sich spontan über die dynamische Client-Registrierung nach RFC 7591.

ParameterWert
FlowOAuth 2.1 Authorization Code + PKCE (S256)
Scopesrepair:read (Zustandsprüfung, Status) · repair:write (Upload, Reparatur)
Client-RegistrierungRFC 7591 — POST https://repair.easeus.com/fixo-mcp/v1/oauth/register
Server-MetadatenRFC 8414 — /.well-known/oauth-authorization-server
Ressourcen-MetadatenRFC 9728 — /.well-known/oauth-protected-resource
Nicht autorisierte AntwortHTTP 401 mit einem WWW-Authenticate-Header
Access-Token-TTL12 Stunden
Refresh-Token-TTL30 Tage

Ablauf bei der ersten Verbindung

  1. Der INITIALIZE-Aufruf liefert HTTP 401 mit einem WWW-Authenticate-Header, der auf die Protected-Resource-Metadaten verweist
  2. Ihr Client entdeckt den Autorisierungsserver und registriert sich selbst über die dynamische Client-Registrierung nach RFC 7591
  3. Die Autorisierungsseite wird im Browser geöffnet — melden Sie sich mit Ihrem EaseUS-Konto an und genehmigen Sie die Anfrage
  4. Der Client tauscht den Authorization Code (PKCE S256) gegen Tokens aus und versucht den Tool-Aufruf automatisch erneut
Hinweis: Für die Autorisierung ist ein kostenloses EaseUS-Konto erforderlich. Sie können sich während des Auth-Ablaufs registrieren.

5. Tool-Katalog — 4 MCP-Tools

Alle Tools verwenden die JSON-RPC-Methode tools/call von MCP mit typisiertem JSON-Schema für Ein- und Ausgaben.

check_file_health

Prüfen Sie, ob eine Datei intakt und für die Reparatur geeignet ist. Empfohlener erster Schritt vor jeder Reparatur — schlagen Sie dies dem Benutzer vor und führen Sie es nur mit Zustimmung des Benutzers aus. Lokale Vorprüfungen: 0-Byte-Dateien ablehnen, Dateien ablehnen, bei denen jedes Byte denselben Wert hat, und prüfen, ob Header-/Footer-Bytes zur Erweiterung passen.

Input: file_name (erforderlich, inkl. Erweiterung), file_url (erforderlich — download_url von query_upload_url)

Output: health_status (Intact | Unknown | Damaged), message

Scope: repair:read

query_upload_url

Ruft die S3-Upload-URL und die Formularfelder ab, die zum Hochladen einer lokalen Datei benötigt werden (max. 100 MB). Laden Sie mit einem multipart/form-data-POST auf upload_url hoch, der jedes Schlüssel-Wert-Paar aus fields plus die Datei selbst enthält (vorzugsweise curl mit einer -F-Option pro fields-Eintrag). Nach erfolgreichem Upload übergeben Sie download_url als file_url an die anderen Tools.

Input: file_name (erforderlich, inkl. Erweiterung)

Output: upload_url, download_url, fields, message (Upload-Anweisungen)

Scope: repair:write

repair

Erstellt und startet eine Reparaturaufgabe für eine hochgeladene Datei. Falls get_repair_status NeedPwd oder PwdErr zurückgibt, fragen Sie den Benutzer nach dem Dateipasswort und rufen Sie das Tool dann mit demselben file_name und file_url plus password erneut auf.

Input: file_name (erforderlich), file_url (erforderlich), password (optional — nur für verschlüsselte Dateien)

Output: task_id, error (0 bei Erfolg), message

Scope: repair:write

get_repair_status

Prüfen Sie den Status und den Fortschritt (0–100) einer von repair erstellten Reparaturaufgabe. Solange der Status Pending oder Processing ist, warten Sie mindestens 3 Sekunden zwischen den Aufrufen. Beenden Sie das Polling bei Completed, Failed, NeedPwd oder PwdErr. Die Antwortnachricht enthält die empfohlene nächste Aktion.

Input: task_id (erforderlich — von repair zurückgegeben)

Output: status, progress (0–100), message

Scope: repair:read

Beispiel für Ein-/Ausgabeschema (repair)

// Eingabe
{
  "file_name": "birthday.mp4",
  "file_url": "https://d225fhq0dla1l8.cloudfront.net/upload/birthday.mp4"
}

// Ausgabe
{
  "code": 200,
  "task_id": "fixo_a1b2c3d4e5",
  "error": 0,
  "message": "Reparaturaufgabe erfolgreich erstellt."
}

6. Unterstützte Dateiformate (100+)

KategorieFormate
VideoMP4, 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
Dokument & ArchivDOC, 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. Asynchrone Aufgaben & Ergebnisbereitstellung

Reparaturen laufen asynchron. Aufgabenlebenszyklus: Pending → Processing → Completed / Failed (mit NeedPwd / PwdErr für verschlüsselte Dateien).

StatusBedeutungAktion
PendingAufgabe angenommen, wartet auf Workerget_repair_status abfragen
ProcessingReparatur läuftWeiter pollen — zwischen den Aufrufen mindestens 3 Sekunden warten
CompletedReparatur erfolgreich abgeschlossenDownload-Anweisungen in message befolgen
FailedReparatur konnte nicht abgeschlossen werdenFehlermeldung dem Benutzer anzeigen
NeedPwdDie Datei ist passwortgeschütztBenutzer nach dem Passwort fragen und repair erneut damit aufrufen
PwdErrDas angegebene Passwort war falschNach dem korrekten Passwort fragen und repair erneut aufrufen

Bewährte Vorgehensweisen für Polling

  • Warten Sie mindestens 3 Sekunden zwischen den Aufrufen von get_repair_status
  • Beenden Sie das Polling bei Completed, Failed, NeedPwd oder PwdErr
  • Die Antwort message enthält immer die empfohlene nächste Aktion

Ergebnisbereitstellung

  • Binärdateien gelangen nie in den KI-Kontext — das spart Tokens
  • Bei Completed melden Sie sich unter repair.easeus.com/history-repair/ an, um die reparierte Datei herunterzuladen
  • Kein Wasserzeichen, volle Originalqualität

8. Fehlerbehandlung

Fehler werden entweder als MCP-Tool-Fehler (ToolError) oder als strukturierte Ergebnisse mit einem code-Feld ungleich 200 zurückgegeben.

codeBeschreibungLösung
401 (HTTP)Kein Bearer-Token am MCP-EndpunktOAuth-Autorisierung abschließen — der WWW-Authenticate-Header verweist auf die Metadaten
3file_name hat keine ErweiterungDen ursprünglichen Dateinamen einschließlich Erweiterung übergeben
2006OAuth-Token abgelaufenErneut autorisieren und den Aufruf wiederholen
5002Tägliches Kontingent kostenloser Reparaturen ausgeschöpftAuf Pro unter repair.easeus.com upgraden oder die Fixo-Desktop-App verwenden
ToolErrorUngültige Parameter oder Fehler im Upstream-DienstFehlermeldung lesen, Argumente korrigieren und erneut versuchen

9. Ratenlimits

LimitKostenlose StufePro / EaseUS-Konto
Reparaturen pro Tag1Unbegrenzt
Maximale Dateigröße100 MB100 MB
Status-Polling1 Aufruf pro 3 Sekunden pro Aufgabe1 Aufruf pro 3 Sekunden pro Aufgabe
Hinweis: Dateien über 100 MB erfordern den EaseUS Fixo Desktop-Client, der Dateien bis zu mehreren GB unterstützt.

10. Sicherheit & Datenschutz

  • Verschlüsselung: TLS während der Übertragung für den gesamten MCP-, Upload- und Download-Verkehr
  • OAuth 2.1: Authorization Code + PKCE sorgt für sichere Autorisierung, ohne Passwörter dem KI-Client offenzulegen
  • Minimale Rechte: repair:read deckt Zustandsprüfungen und Status-Polling ab; repair:write wird nur für Uploads und Reparaturen benötigt
  • Datenschutz: Dateien werden nie mit Dritten geteilt und nie für KI-Training verwendet
  • Datenaufbewahrung: Die Datei wird nach 14 Tagen automatisch gelöscht
  • Compliance: GDPR, CCPA, SOC 2 Type II, ISO 27001

11. FAQ

Was ist der Fixo MCP Server?

Der Fixo MCP Server ist eine Implementierung des Model Context Protocol, die es KI-Agenten ermöglicht, beschädigte Video-, Foto-, Dokument-, Archiv- und Audiodateien über 4 standardisierte MCP-Tools zu reparieren.

Welche KI-Clients unterstützen Fixo MCP?

Jeder MCP-kompatible Client mit Unterstützung für Streamable HTTP: Claude Desktop, Claude Code, Cursor, GitHub Copilot, ChatGPT, Google Gemini, Windsurf, Trae, Continue.dev, Cline, Roo Code und über 50 weitere.

Ist Fixo MCP kostenlos nutzbar?

Ja. Alle Nutzer erhalten 1 kostenlose Reparatur pro Tag (max. 100 MB). Inhaber eines EaseUS Pro-Kontos erhalten unbegrenzte Reparaturen pro Tag. Dateien über 100 MB erfordern den Desktop-Client.

Muss ich etwas installieren?

Nein. Fixo MCP ist ein Cloud-Dienst, der über den Streamable-HTTP-Endpunkt aufgerufen wird. Sie benötigen lediglich einen MCP-kompatiblen KI-Client.

Wo finde ich meine reparierten Dateien?

Sobald eine Aufgabe den Status Completed erreicht, melden Sie sich mit Ihrem Konto unter repair.easeus.com/history-repair/ an, um eine Vorschau der reparierten Datei anzuzeigen und sie herunterzuladen. Kein Wasserzeichen, volle Originalqualität.

Wie lange dauert eine Reparatur?

Die meisten Dateien werden innerhalb von 30–60 Sekunden repariert. Größere oder stark beschädigte Dateien können einige Minuten dauern. Das Tool get_repair_status zeigt den Fortschritt in Echtzeit an (0–100).

12. Support & Kontakt

KanalKontakt
Support-Portaleaseus.com/support.html
E-Mail[email protected]
MCP-Startseiterepair.easeus.com/mcp/
Online-Reparaturrepair.easeus.com
Desktop-Softwareeaseus.com/repair-tools

Fixo MCP ist in den Verzeichnissen Smithery, Glama, PulseMCP und mcp.so gelistet.

Anhang: Vollständiges Beispiel — Reparatur eines beschädigten Videos

Schritt 1: Upload-URL abrufen

// Aufruf
{ "name": "query_upload_url", "arguments": { "file_name": "birthday.mp4" } }

// Ergebnis
{
  "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": "Prüfen Sie nach Erhalt der Upload-URL und vor dem Hochladen, ob die lokale Datei größer als 100 MB ist..."
  }
}

Schritt 2: Datei hochladen

Senden Sie einen multipart/form-data-POST an upload_url, der jeden Eintrag aus fields sowie die Datei selbst enthält:

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/

Schritt 3: Dateizustand prüfen (optional, empfohlen)

// Aufruf
{ "name": "check_file_health", "arguments": { "file_name": "birthday.mp4", "file_url": "https://d225fhq0dla1l8.cloudfront.net/upload/birthday.mp4" } }

// Ergebnis
{
  "code": 200,
  "health_status": "Damaged",
  "message": "Die Datei ist beschädigt. Rufen Sie das Reparatur-Tool mit demselben file_name und file_url auf, um sie zu reparieren."
}

Schritt 4: Reparatur starten

// Aufruf
{ "name": "repair", "arguments": { "file_name": "birthday.mp4", "file_url": "https://d225fhq0dla1l8.cloudfront.net/upload/birthday.mp4" } }

// Ergebnis
{
  "code": 200,
  "task_id": "fixo_a1b2c3d4e5",
  "error": 0,
  "message": "Reparaturaufgabe erfolgreich erstellt."
}

Schritt 5: Status abfragen, bis die Reparatur abgeschlossen ist

// Abfragen, mit mindestens 3 Sekunden Wartezeit zwischen den Aufrufen
{ "name": "get_repair_status", "arguments": { "task_id": "fixo_a1b2c3d4e5" } }

// Endergebnis
{
  "code": 200,
  "task_id": "fixo_a1b2c3d4e5",
  "status": "Completed",
  "progress": 100,
  "message": "Reparatur abgeschlossen. Melden Sie sich mit Ihrem Konto unter https://repair.easeus.com/history-repair/ an und laden Sie dann die reparierte Datei herunter."
}
Ihr Video wurde erfolgreich repariert! - Datei: birthday_repaired.mp4 - Melden Sie sich unter repair.easeus.com/history-repair/ an, um eine Vorschau anzuzeigen und die Datei herunterzuladen - Kein Wasserzeichen, volle Originalqualität