Fixo MCP Server — 전체 통합 가이드.

1. 개요

EaseUS Fixo MCP Server를 사용하면 모든 MCP 호환 AI 에이전트(Claude, Cursor, ChatGPT, Gemini, Windsurf, Trae, GitHub Copilot 등 50개 이상)가 표준화된 Model Context Protocol 인터페이스를 통해 손상된 비디오, 사진, 문서, 압축 파일, 오디오 파일을 복구할 수 있습니다.

EaseUS의 20년 데이터 복구 전문성(1억 2천만 개 이상의 파일 복구, 사용자 평점 4.8/5)을 바탕으로, Fixo MCP는 MCP 모범 사례를 따르는 4가지 전문 도구를 제공합니다. 여기에는 타입 지정 JSON Schema, 비동기 작업 지원, 구조화된 결과 전달이 포함됩니다.

2. 빠른 시작 — 원클릭 연결

가장 쉬운 연결 방법은 MCP 랜딩 페이지의 원클릭 프롬프트를 사용하는 것입니다. JSON을 수동으로 편집할 필요가 없습니다.

1단계: 프롬프트 복사

MCP 랜딩 페이지로 이동해 Copy Prompt를 클릭하세요. 프롬프트 내용은 다음과 같습니다.

MCP 서버 추가: https://repair.easeus.com/fixo-mcp/v1, OAuth 2.1 Authorization Code + PKCE (S256), API 키 불필요.
그런 다음 fixo MCP 도구를 사용하여 {file path}을 복구하세요.

2단계: AI 에이전트에 붙여넣기

AI 어시스턴트(Claude, Cursor, ChatGPT 등)를 열고 새 대화에 프롬프트를 붙여넣으세요.

3단계: AI 자동 설정

AI가 이 가이드 문서를 읽고 올바른 엔드포인트 URL로 Fixo MCP Server 연결을 자동으로 설정합니다.

4단계: 파일 복구 시작

AI에게 손상된 파일 복구를 요청하세요. Fixo의 4가지 MCP 도구를 사용해 상태 확인, 업로드, 복구 실행, 진행 상황 모니터링, 결과 페이지 URL 반환까지 수행합니다.

3. 수동 설정

수동 설정을 선호한다면, 다음 엔드포인트로 MCP 클라이언트를 구성하세요: https://repair.easeus.com/fixo-mcp/v1

3.1 Claude Desktop

~/.claude.json(macOS/Linux) 또는 %APPDATA%\Claude\claude_desktop_config.json(Windows)을 편집하세요:

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

Claude Desktop을 다시 시작하세요. INITIALIZE 호출이 OAuth 인증 흐름을 트리거합니다.

3.2 Cursor

1. Cursor 열기 → Settings → MCP
2. Add New MCP Server 클릭
3. URL 유형 선택
4. 다음 입력: https://repair.easeus.com/fixo-mcp/v1
5. Add 클릭

3.3 ChatGPT

ChatGPT는 커넥터를 통해 원격 MCP Server를 지원합니다:

1. Settings → Connectors → Advanced에서 개발자 모드를 활성화하세요
2. 새 커넥터를 만들고 MCP Server URL로 https://repair.easeus.com/fixo-mcp/v1를 입력하세요
3. 브라우저에서 OAuth 인증을 완료하세요
4. 이제 대화에서 Fixo 도구를 사용할 수 있습니다

3.4 기타 MCP 클라이언트

Streamable HTTP를 지원하는 모든 MCP 호환 클라이언트는 연결할 수 있습니다: Windsurf, Trae, GitHub Copilot, Continue.dev, Cline, Roo Code 등. 모두 동일한 엔드포인트를 사용합니다: https://repair.easeus.com/fixo-mcp/v1

4. 인증 및 권한 부여

Fixo MCP는 안전하고 비밀번호가 필요 없는 권한 부여를 위해 OAuth 2.1(PKCE S256이 포함된 Authorization Code 흐름)을 사용합니다. API 키는 필요하지 않으며, 클라이언트는 RFC 7591 동적 클라이언트 등록을 통해 즉시 등록됩니다.

최초 연결 흐름

1. INITIALIZE 호출은 보호된 리소스 메타데이터를 가리키는 WWW-Authenticate 헤더와 함께 HTTP 401을 반환합니다
2. 클라이언트가 인증 서버를 발견하고 RFC 7591 동적 클라이언트 등록을 통해 스스로를 등록합니다
3. 브라우저에서 인증 페이지가 열리면 EaseUS 계정으로 로그인하고 요청을 승인하세요
4. 클라이언트가 authorization code(PKCE S256)를 토큰으로 교환한 뒤 도구 호출을 자동으로 다시 시도합니다

5. 도구 카탈로그 — 4가지 MCP 도구

모든 도구는 입력과 출력에 타입 지정 JSON Schema를 사용하는 MCP의 tools/call JSON-RPC 메서드를 따릅니다.

입력/출력 스키마 예시(repair)

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

// 출력
{
  "code": 200,
  "task_id": "fixo_a1b2c3d4e5",
  "error": 0,
  "message": "복구 작업이 성공적으로 생성되었습니다."
}

6. 지원 파일 형식(100+)

7. 비동기 작업 및 결과 전달

복구는 비동기적으로 실행됩니다. 작업 수명 주기: Pending → Processing → Completed / Failed(암호화된 파일의 경우 NeedPwd / PwdErr 포함).

폴링 모범 사례

• get_repair_status 호출 간 최소 3초를 기다리세요
• Completed, Failed, NeedPwd, PwdErr 상태에서 폴링을 중지하세요
• 응답의 message에는 항상 권장되는 다음 작업이 포함됩니다

결과 전달

• 바이너리 파일은 AI 컨텍스트에 들어가지 않으므로 토큰을 절약할 수 있습니다
• Completed가 되면 repair.easeus.com/history-repair/에 로그인해 복구된 파일을 다운로드하세요
• 워터마크 없음, 원본 품질 그대로

8. 오류 처리

오류는 MCP 도구 오류(ToolError) 또는 200이 아닌 code 필드가 포함된 구조화된 결과로 반환됩니다.

9. 속도 제한

10. 보안 및 개인정보 보호

• 암호화: 모든 MCP, 업로드 및 다운로드 트래픽은 전송 중 TLS로 보호됩니다
• OAuth 2.1: Authorization Code + PKCE는 AI 클라이언트에 비밀번호를 노출하지 않고 안전한 권한 부여를 보장합니다
• 최소 권한: repair:read는 상태 점검과 상태 폴링을 포함하며, repair:write는 업로드와 복구에만 필요합니다
• 개인정보 보호: 파일은 제3자와 공유되지 않으며 AI 학습에도 사용되지 않습니다
• 데이터 보존: 파일은 14일 후 자동 삭제됩니다
• 규정 준수: GDPR, CCPA, SOC 2 Type II, ISO 27001

11. FAQ

Fixo MCP Server란 무엇인가요?

Fixo MCP Server는 AI 에이전트가 4개의 표준화된 MCP 도구를 통해 손상된 비디오, 사진, 문서, 압축 파일 및 오디오 파일을 복구할 수 있도록 하는 Model Context Protocol 구현입니다.

어떤 AI 클라이언트가 Fixo MCP를 지원하나요?

Streamable HTTP를 지원하는 모든 MCP 호환 클라이언트에서 사용할 수 있습니다: Claude Desktop, Claude Code, Cursor, GitHub Copilot, ChatGPT, Google Gemini, Windsurf, Trae, Continue.dev, Cline, Roo Code 등 50개 이상의 클라이언트를 지원합니다.

Fixo MCP는 무료로 사용할 수 있나요?

네. 모든 사용자는 하루에 1회 무료 복구를 이용할 수 있습니다(최대 100 MB). EaseUS Pro 계정 보유자는 하루에 무제한으로 복구할 수 있습니다. 100 MB를 초과하는 파일은 데스크톱 클라이언트가 필요합니다.

무언가를 설치해야 하나요?

아니요. Fixo MCP는 Streamable HTTP 엔드포인트를 통해 접속하는 클라우드 서비스입니다. MCP 호환 AI 클라이언트만 있으면 됩니다.

복구된 파일은 어디에서 찾을 수 있나요?

작업이 Completed 상태에 도달하면 repair.easeus.com/history-repair/에서 계정으로 로그인하여 복구된 파일을 미리 보고 다운로드할 수 있습니다. 워터마크 없이 원본 품질 그대로 제공됩니다.

복구하는 데 얼마나 걸리나요?

대부분의 파일은 30~60초 이내에 복구됩니다. 크기가 크거나 심하게 손상된 파일은 몇 분 정도 걸릴 수 있습니다. get_repair_status 도구로 진행률(0~100)을 실시간으로 확인할 수 있습니다.

12. 지원 및 문의

Fixo MCP는 Smithery, Glama, PulseMCP, mcp.so 디렉터리에 등록되어 있습니다.

부록: 전체 예시 — 손상된 비디오 복구

1단계: 업로드 URL 가져오기

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

// 결과
{
  "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": "업로드 URL을 받은 뒤 업로드하기 전에 로컬 파일이 100 MB를 초과하는지 확인하세요..."
  }
}

2단계: 파일 업로드

fields의 각 항목과 파일 자체를 포함해 multipart/form-data POST를 upload_url로 전송하세요:

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/

3단계: 파일 상태 확인(선택 사항, 권장)

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

// 결과
{
  "code": 200,
  "health_status": "Damaged",
  "message": "파일이 손상되었습니다. 동일한 file_name과 file_url로 repair 도구를 호출해 복구하세요."
}

4단계: 복구 실행

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

// 결과
{
  "code": 200,
  "task_id": "fixo_a1b2c3d4e5",
  "error": 0,
  "message": "복구 작업이 성공적으로 생성되었습니다."
}

5단계: 완료될 때까지 상태 폴링

// 최소 3초 간격으로 폴링
{ "name": "get_repair_status", "arguments": { "task_id": "fixo_a1b2c3d4e5" } }

// 최종 결과
{
  "code": 200,
  "task_id": "fixo_a1b2c3d4e5",
  "status": "Completed",
  "progress": 100,
  "message": "복구가 완료되었습니다. https://repair.easeus.com/history-repair/ 에 계정으로 로그인한 뒤 복구된 파일을 다운로드하세요."
}