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.
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.
| Element | Wert |
|---|---|
| MCP-Endpunkt | https://repair.easeus.com/fixo-mcp/v1 |
| Transport | Streamable HTTP (JSON-RPC) |
| Tools | 4 (check_file_health, query_upload_url, repair, get_repair_status) |
| Kategorien | Video, Foto, Dokument & Archiv, Audio |
| Formate | 100+ |
| Maximale Dateigröße | 100 MB pro Datei |
| Authentifizierung | OAuth 2.1 — Authorization Code + PKCE, dynamische Client-Registrierung nach RFC 7591 |
| Ergebnisbereitstellung | URL zur Webergebnisseite (Vorschau + Download) |
| Datenaufbewahrung | Automatische 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
- Öffnen Sie Cursor → Settings → MCP
- Klicken Sie auf Add New MCP Server
- Wählen Sie den Typ URL
- Geben Sie Folgendes ein:
https://repair.easeus.com/fixo-mcp/v1 - Klicken Sie auf Add
3.3 ChatGPT
ChatGPT unterstützt entfernte MCP-Server über Connectoren:
- Aktivieren Sie den Entwicklermodus unter Settings → Connectors → Advanced
- Erstellen Sie einen neuen Connector und geben Sie die MCP-Server-URL ein:
https://repair.easeus.com/fixo-mcp/v1 - Schließen Sie die OAuth-Autorisierung im Browser ab
- 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.
| Parameter | Wert |
|---|---|
| Flow | OAuth 2.1 Authorization Code + PKCE (S256) |
| Scopes | repair:read (Zustandsprüfung, Status) · repair:write (Upload, Reparatur) |
| Client-Registrierung | RFC 7591 — POST https://repair.easeus.com/fixo-mcp/v1/oauth/register |
| Server-Metadaten | RFC 8414 — /.well-known/oauth-authorization-server |
| Ressourcen-Metadaten | RFC 9728 — /.well-known/oauth-protected-resource |
| Nicht autorisierte Antwort | HTTP 401 mit einem WWW-Authenticate-Header |
| Access-Token-TTL | 12 Stunden |
| Refresh-Token-TTL | 30 Tage |
Ablauf bei der ersten Verbindung
- Der INITIALIZE-Aufruf liefert HTTP 401 mit einem
WWW-Authenticate-Header, der auf die Protected-Resource-Metadaten verweist - Ihr Client entdeckt den Autorisierungsserver und registriert sich selbst über die dynamische Client-Registrierung nach RFC 7591
- Die Autorisierungsseite wird im Browser geöffnet — melden Sie sich mit Ihrem EaseUS-Konto an und genehmigen Sie die Anfrage
- Der Client tauscht den Authorization Code (PKCE S256) gegen Tokens aus und versucht den Tool-Aufruf automatisch erneut
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+)
| Kategorie | Formate |
|---|---|
| Video | 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 |
| Dokument & Archiv | 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. Asynchrone Aufgaben & Ergebnisbereitstellung
Reparaturen laufen asynchron. Aufgabenlebenszyklus: Pending → Processing → Completed / Failed (mit NeedPwd / PwdErr für verschlüsselte Dateien).
| Status | Bedeutung | Aktion |
|---|---|---|
Pending | Aufgabe angenommen, wartet auf Worker | get_repair_status abfragen |
Processing | Reparatur läuft | Weiter pollen — zwischen den Aufrufen mindestens 3 Sekunden warten |
Completed | Reparatur erfolgreich abgeschlossen | Download-Anweisungen in message befolgen |
Failed | Reparatur konnte nicht abgeschlossen werden | Fehlermeldung dem Benutzer anzeigen |
NeedPwd | Die Datei ist passwortgeschützt | Benutzer nach dem Passwort fragen und repair erneut damit aufrufen |
PwdErr | Das angegebene Passwort war falsch | Nach 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,NeedPwdoderPwdErr - Die Antwort
messageenthält immer die empfohlene nächste Aktion
Ergebnisbereitstellung
- Binärdateien gelangen nie in den KI-Kontext — das spart Tokens
- Bei
Completedmelden 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.
| code | Beschreibung | Lösung |
|---|---|---|
| 401 (HTTP) | Kein Bearer-Token am MCP-Endpunkt | OAuth-Autorisierung abschließen — der WWW-Authenticate-Header verweist auf die Metadaten |
| 3 | file_name hat keine Erweiterung | Den ursprünglichen Dateinamen einschließlich Erweiterung übergeben |
| 2006 | OAuth-Token abgelaufen | Erneut autorisieren und den Aufruf wiederholen |
| 5002 | Tägliches Kontingent kostenloser Reparaturen ausgeschöpft | Auf Pro unter repair.easeus.com upgraden oder die Fixo-Desktop-App verwenden |
| ToolError | Ungültige Parameter oder Fehler im Upstream-Dienst | Fehlermeldung lesen, Argumente korrigieren und erneut versuchen |
9. Ratenlimits
| Limit | Kostenlose Stufe | Pro / EaseUS-Konto |
|---|---|---|
| Reparaturen pro Tag | 1 | Unbegrenzt |
| Maximale Dateigröße | 100 MB | 100 MB |
| Status-Polling | 1 Aufruf pro 3 Sekunden pro Aufgabe | 1 Aufruf pro 3 Sekunden pro Aufgabe |
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:readdeckt Zustandsprüfungen und Status-Polling ab;repair:writewird 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
| Kanal | Kontakt |
|---|---|
| Support-Portal | easeus.com/support.html |
| [email protected] | |
| MCP-Startseite | repair.easeus.com/mcp/ |
| Online-Reparatur | repair.easeus.com |
| Desktop-Software | easeus.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."
}