Fixo MCP Server — Guida completa all'integrazione.

1. Panoramica

EaseUS Fixo MCP Server consente a qualsiasi agente IA compatibile con MCP (Claude, Cursor, ChatGPT, Gemini, Windsurf, Trae, GitHub Copilot e oltre 50 altri) di riparare file corrotti di video, foto, documenti, archivi e audio tramite un'interfaccia Model Context Protocol standardizzata.

Basato sui 20 anni di esperienza di EaseUS nella riparazione dei dati (oltre 120 milioni di file riparati, valutazione utenti 4,8/5), Fixo MCP espone 4 strumenti specializzati che seguono le best practice MCP: JSON Schema tipizzato, supporto per attività asincrone e consegna strutturata dei risultati.

2. Avvio rapido — Connessione con un clic

Il modo più semplice per connettersi è usare il prompt con un clic dalla pagina principale MCP. Non è richiesta alcuna modifica manuale del JSON.

Passaggio 1: Copia il prompt

Vai alla pagina principale MCP e fai clic su Copia prompt. Il prompt contiene:

Aggiungi il server MCP: https://repair.easeus.com/fixo-mcp/v1, OAuth 2.1 Authorization Code + PKCE (S256), nessuna chiave API richiesta.
Quindi usa lo strumento MCP fixo per riparare {file path}.

Passaggio 2: Incollalo nel tuo agente IA

Apri il tuo assistente IA (Claude, Cursor, ChatGPT, ecc.) e incolla il prompt in una nuova conversazione.

Passaggio 3: L'IA si configura automaticamente

L'IA legge questo documento guida e configura automaticamente la connessione al server Fixo MCP con l'URL corretto dell'endpoint.

Passaggio 4: Inizia a riparare i file

Chiedi alla tua IA di riparare un file corrotto. Userà i 4 strumenti MCP di Fixo per controllare lo stato, caricare il file, avviare la riparazione, monitorare l'avanzamento e restituire un URL della pagina del risultato.

3. Configurazione manuale

Se preferisci la configurazione manuale, configura il tuo client MCP con l'endpoint: https://repair.easeus.com/fixo-mcp/v1

3.1 Claude Desktop

Modifica ~/.claude.json (macOS/Linux) oppure %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Riavvia Claude Desktop. La chiamata INITIALIZE attiverà il flusso di autorizzazione OAuth.

3.2 Cursor

1. Apri Cursor → Settings → MCP
2. Fai clic su Add New MCP Server
3. Seleziona il tipo URL
4. Inserisci: https://repair.easeus.com/fixo-mcp/v1
5. Fai clic su Add

3.3 ChatGPT

ChatGPT supporta server MCP remoti tramite connettori:

1. Abilita la modalità sviluppatore in Settings → Connectors → Advanced
2. Crea un nuovo connettore e inserisci l'URL del server MCP: https://repair.easeus.com/fixo-mcp/v1
3. Completa l'autorizzazione OAuth nel browser
4. Gli strumenti Fixo sono ora disponibili nella tua conversazione

3.4 Altri client MCP

Qualsiasi client compatibile con MCP che supporti Streamable HTTP può connettersi: Windsurf, Trae, GitHub Copilot, Continue.dev, Cline, Roo Code, ecc. Tutti usano lo stesso endpoint: https://repair.easeus.com/fixo-mcp/v1

4. Autenticazione e autorizzazione

Fixo MCP usa OAuth 2.1 (flusso Authorization Code con PKCE S256) per un'autorizzazione sicura e senza password. Non servono chiavi API: i client si registrano al volo tramite la registrazione dinamica del client RFC 7591.

Flusso della prima connessione

1. La chiamata INITIALIZE restituisce HTTP 401 con un header WWW-Authenticate che punta ai metadati della risorsa protetta
2. Il tuo client individua il server di autorizzazione e si registra tramite la registrazione dinamica del client RFC 7591
3. La pagina di autorizzazione si apre nel browser: accedi con il tuo account EaseUS e approva la richiesta
4. Il client scambia l'authorization code (PKCE S256) con i token e ritenta automaticamente la chiamata dello strumento

5. Catalogo strumenti — 4 strumenti MCP

Tutti gli strumenti seguono il metodo JSON-RPC MCP tools/call con JSON Schema tipizzato per input e output.

Esempio di schema input/output (repair)

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

// Output
{
  "code": 200,
  "task_id": "fixo_a1b2c3d4e5",
  "error": 0,
  "message": "Attività di riparazione creata con successo."
}

6. Formati di file supportati (100+)

7. Attività asincrone e consegna dei risultati

La riparazione viene eseguita in modo asincrono. Ciclo di vita dell'attività: Pending → Processing → Completed / Failed (con NeedPwd / PwdErr per i file cifrati).

Best practice per il polling

• Attendi almeno 3 secondi tra le chiamate a get_repair_status
• Interrompi il polling a Completed, Failed, NeedPwd o PwdErr
• La risposta message contiene sempre l'azione successiva consigliata

Consegna del risultato

• I file binari non entrano mai nel contesto dell'IA, con conseguente risparmio di token
• Quando lo stato è Completed, accedi a repair.easeus.com/history-repair/ per scaricare il file riparato
• Nessuna filigrana, qualità originale completa

8. Gestione degli errori

Gli errori vengono restituiti come errori dello strumento MCP (ToolError) oppure come risultati strutturati con un campo code diverso da 200.

9. Limiti di utilizzo

10. Sicurezza e privacy

• Crittografia: TLS in transito per tutto il traffico MCP, di upload e di download
• OAuth 2.1: Authorization Code + PKCE garantisce un'autorizzazione sicura senza esporre le password al client IA
• Privilegio minimo: repair:read copre i controlli di stato e il polling dello stato; repair:write è richiesto solo per upload e riparazioni
• Privacy: I file non vengono mai condivisi con terze parti e non vengono mai usati per l'addestramento dell'IA
• Conservazione dei dati: Il file verrà eliminato automaticamente dopo 14 giorni
• Conformità: GDPR, CCPA, SOC 2 Type II, ISO 27001

11. FAQ

Che cos'è Fixo MCP Server?

Fixo MCP Server è un'implementazione del Model Context Protocol che consente agli agenti IA di riparare file corrotti di video, foto, documenti, archivi e audio tramite 4 strumenti MCP standardizzati.

Quali client IA supportano Fixo MCP?

Qualsiasi client compatibile con MCP che supporti Streamable HTTP: Claude Desktop, Claude Code, Cursor, GitHub Copilot, ChatGPT, Google Gemini, Windsurf, Trae, Continue.dev, Cline, Roo Code e oltre 50 altri.

Fixo MCP è gratuito?

Sì. Tutti gli utenti dispongono di 1 riparazione gratuita al giorno (massimo 100 MB). I titolari di un account EaseUS Pro hanno riparazioni illimitate al giorno. I file superiori a 100 MB richiedono il client desktop.

Devo installare qualcosa?

No. Fixo MCP è un servizio cloud accessibile tramite l'endpoint Streamable HTTP. Ti serve solo un client IA compatibile con MCP.

Dove trovo i miei file riparati?

Quando un'attività raggiunge lo stato Completed, accedi con il tuo account su repair.easeus.com/history-repair/ per visualizzare l'anteprima e scaricare il file riparato. Senza filigrana, con la qualità originale completa.

Quanto tempo richiede la riparazione?

La maggior parte dei file viene riparata in 30–60 secondi. I file più grandi o gravemente corrotti possono richiedere alcuni minuti. Lo strumento get_repair_status mostra l'avanzamento in tempo reale (0–100).

12. Supporto e contatti

Fixo MCP è presente nelle directory Smithery, Glama, PulseMCP e mcp.so.

Appendice: Esempio completo — Riparare un video corrotto

Passaggio 1: Ottenere l'URL di upload

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

// Risultato
{
  "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": "Dopo aver ricevuto l'URL di upload e prima di caricare il file, verifica se il file locale supera i 100 MB..."
  }
}

Passaggio 2: Caricare il file

Invia una POST multipart/form-data a upload_url con ogni voce di fields più il file stesso:

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/

Passaggio 3: Controllare lo stato del file (facoltativo, consigliato)

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

// Risultato
{
  "code": 200,
  "health_status": "Damaged",
  "message": "Il file è danneggiato. Chiama lo strumento repair con lo stesso file_name e file_url per ripararlo."
}

Passaggio 4: Avviare la riparazione

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

// Risultato
{
  "code": 200,
  "task_id": "fixo_a1b2c3d4e5",
  "error": 0,
  "message": "Attività di riparazione creata con successo."
}

Passaggio 5: Eseguire il polling dello stato fino al completamento

// Polling, attendendo almeno 3 secondi tra le chiamate
{ "name": "get_repair_status", "arguments": { "task_id": "fixo_a1b2c3d4e5" } }

// Risultato finale
{
  "code": 200,
  "task_id": "fixo_a1b2c3d4e5",
  "status": "Completed",
  "progress": 100,
  "message": "Riparazione completata. Accedi con il tuo account su https://repair.easeus.com/history-repair/ e quindi scarica il file riparato."
}