Fixo MCP Server — Guia completo de integração.

1. Visão geral

O EaseUS Fixo MCP Server permite que qualquer agente de IA compatível com MCP (Claude, Cursor, ChatGPT, Gemini, Windsurf, Trae, GitHub Copilot e mais de 50 outros) repare arquivos corrompidos de vídeo, foto, documento, arquivo compactado e áudio por meio de uma interface padronizada do Model Context Protocol.

Impulsionado pelos 20 anos de experiência da EaseUS em reparo de dados (mais de 120 milhões de arquivos reparados, avaliação dos usuários de 4,8/5), o Fixo MCP expõe 4 ferramentas especializadas que seguem as melhores práticas de MCP: JSON Schema tipado, suporte a tarefas assíncronas e entrega estruturada de resultados.

2. Início rápido — Conexão com um clique

A maneira mais fácil de se conectar é usando o prompt de um clique na página inicial do MCP. Não é necessária edição manual de JSON.

Etapa 1: Copie o prompt

Acesse a página inicial do MCP e clique em Copiar prompt. O prompt contém:

Adicione o servidor MCP: https://repair.easeus.com/fixo-mcp/v1, OAuth 2.1 Authorization Code + PKCE (S256), sem necessidade de chave de API.
Em seguida, use a ferramenta MCP fixo para reparar {file path}.

Etapa 2: Cole no seu agente de IA

Abra o seu assistente de IA (Claude, Cursor, ChatGPT etc.) e cole o prompt em uma nova conversa.

Etapa 3: A IA configura automaticamente

A IA lê este documento guia e configura automaticamente a conexão com o Fixo MCP Server usando a URL correta do endpoint.

Etapa 4: Comece a reparar arquivos

Peça à sua IA para reparar um arquivo corrompido. Ela usará as 4 ferramentas MCP do Fixo para verificar a integridade, fazer upload, iniciar o reparo, monitorar o progresso e retornar a URL da página de resultados.

3. Configuração manual

Se você preferir a configuração manual, configure o seu cliente MCP com o endpoint: https://repair.easeus.com/fixo-mcp/v1

3.1 Claude Desktop

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

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

Reinicie o Claude Desktop. A chamada INITIALIZE acionará o fluxo de autorização OAuth.

3.2 Cursor

1. Abra o Cursor → Settings → MCP
2. Clique em Add New MCP Server
3. Selecione o tipo URL
4. Digite: https://repair.easeus.com/fixo-mcp/v1
5. Clique em Add

3.3 ChatGPT

O ChatGPT oferece suporte a servidores MCP remotos por meio de conectores:

1. Ative o modo desenvolvedor em Settings → Connectors → Advanced
2. Crie um novo conector e informe a URL do servidor MCP: https://repair.easeus.com/fixo-mcp/v1
3. Conclua a autorização OAuth no navegador
4. As ferramentas do Fixo agora estarão disponíveis na sua conversa

3.4 Outros clientes MCP

Qualquer cliente compatível com MCP que ofereça suporte a Streamable HTTP pode se conectar: Windsurf, Trae, GitHub Copilot, Continue.dev, Cline, Roo Code etc. Todos usam o mesmo endpoint: https://repair.easeus.com/fixo-mcp/v1

4. Autenticação e autorização

O Fixo MCP usa OAuth 2.1 (fluxo Authorization Code com PKCE S256) para autorização segura e sem senha. Nenhuma chave de API é necessária — os clientes se registram dinamicamente por meio do registro dinâmico de cliente RFC 7591.

Fluxo da primeira conexão

1. A chamada INITIALIZE retorna HTTP 401 com um cabeçalho WWW-Authenticate apontando para os metadados do recurso protegido
2. Seu cliente descobre o servidor de autorização e se registra por meio do registro dinâmico de cliente RFC 7591
3. A página de autorização é aberta no navegador — faça login com sua conta EaseUS e aprove a solicitação
4. O cliente troca o authorization code (PKCE S256) por tokens e tenta novamente a chamada da ferramenta automaticamente

5. Catálogo de ferramentas — 4 ferramentas MCP

Todas as ferramentas seguem o método JSON-RPC tools/call do MCP com JSON Schema tipado para entradas e saídas.

Exemplo de esquema de entrada/saída (repair)

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

// Saída
{
  "code": 200,
  "task_id": "fixo_a1b2c3d4e5",
  "error": 0,
  "message": "Tarefa de reparo criada com sucesso."
}

6. Formatos de arquivo compatíveis (100+)

7. Tarefas assíncronas e entrega de resultados

O reparo é executado de forma assíncrona. Ciclo de vida da tarefa: Pending → Processing → Completed / Failed (com NeedPwd / PwdErr para arquivos criptografados).

Boas práticas de polling

• Aguarde pelo menos 3 segundos entre chamadas para get_repair_status
• Pare de consultar em Completed, Failed, NeedPwd ou PwdErr
• A resposta em message sempre contém a próxima ação recomendada

Entrega de resultados

• Arquivos binários nunca entram no contexto da IA — economizando tokens
• Quando o status for Completed, faça login em repair.easeus.com/history-repair/ para baixar o arquivo reparado
• Sem marca d'água, qualidade original completa

8. Tratamento de erros

Os erros são retornados como erros de ferramenta MCP (ToolError) ou como resultados estruturados com um campo code diferente de 200.

9. Limites de taxa

10. Segurança e privacidade

• Criptografia: TLS em trânsito para todo o tráfego MCP, de upload e de download
• OAuth 2.1: Authorization Code + PKCE garante autorização segura sem expor senhas ao cliente de IA
• Privilégio mínimo: repair:read cobre verificações de integridade e polling de status; repair:write só é necessário para uploads e reparos
• Privacidade: Os arquivos nunca são compartilhados com terceiros e nunca são usados para treinar IA
• Retenção de dados: O arquivo será excluído automaticamente após 14 dias
• Conformidade: GDPR, CCPA, SOC 2 Type II, ISO 27001

11. FAQ

O que é o Fixo MCP Server?

O Fixo MCP Server é uma implementação do Model Context Protocol que permite que agentes de IA reparem arquivos corrompidos de vídeo, foto, documento, arquivo compactado e áudio por meio de 4 ferramentas MCP padronizadas.

Quais clientes de IA são compatíveis com o Fixo MCP?

Qualquer cliente compatível com MCP que ofereça suporte a Streamable HTTP: Claude Desktop, Claude Code, Cursor, GitHub Copilot, ChatGPT, Google Gemini, Windsurf, Trae, Continue.dev, Cline, Roo Code e mais de 50 outros.

O Fixo MCP é gratuito?

Sim. Todos os usuários têm direito a 1 reparo gratuito por dia (máximo de 100 MB). Os titulares de conta EaseUS Pro têm reparos ilimitados por dia. Arquivos com mais de 100 MB exigem o cliente de desktop.

Preciso instalar algo?

Não. O Fixo MCP é um serviço em nuvem acessado pelo endpoint Streamable HTTP. Você só precisa de um cliente de IA compatível com MCP.

Onde encontro meus arquivos reparados?

Quando uma tarefa atingir o status Completed, faça login com sua conta em repair.easeus.com/history-repair/ para visualizar e baixar o arquivo reparado. Sem marca d'água, com a qualidade original completa.

Quanto tempo leva o reparo?

A maioria dos arquivos é reparada em 30 a 60 segundos. Arquivos maiores ou gravemente corrompidos podem levar alguns minutos. A ferramenta get_repair_status mostra o progresso em tempo real (0–100).

12. Suporte e contato

O Fixo MCP está listado nos diretórios Smithery, Glama, PulseMCP e mcp.so.

Apêndice: Exemplo completo — Reparar um vídeo corrompido

Etapa 1: Obter a URL de upload

// Chamada
{ "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": "Depois de receber a URL de upload e antes de enviar o arquivo, verifique se o arquivo local excede 100 MB..."
  }
}

Etapa 2: Fazer upload do arquivo

Envie um POST multipart/form-data para upload_url com cada entrada de fields mais o próprio arquivo:

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/

Etapa 3: Verificar a integridade do arquivo (opcional, recomendado)

// Chamada
{ "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": "O arquivo está danificado. Chame a ferramenta de reparo com o mesmo file_name e file_url para repará-lo."
}

Etapa 4: Iniciar o reparo

// Chamada
{ "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": "Tarefa de reparo criada com sucesso."
}

Etapa 5: Consultar o status até concluir

// Consulte, aguardando pelo menos 3 segundos entre as chamadas
{ "name": "get_repair_status", "arguments": { "task_id": "fixo_a1b2c3d4e5" } }

// Resultado final
{
  "code": 200,
  "task_id": "fixo_a1b2c3d4e5",
  "status": "Completed",
  "progress": 100,
  "message": "Reparo concluído. Faça login com sua conta em https://repair.easeus.com/history-repair/ e depois baixe o arquivo reparado."
}