Fixo MCP Server — 完全統合ガイド。

あらゆる MCP 対応 AI エージェントを EaseUS Fixo に接続するための手順付き技術リファレンスです。認証、ツールスキーマ、非同期ワークフロー、エラーハンドリング、60 以上の対応ファイル形式を網羅しています。

バージョン:
更新日:
エンドポイント:https://repair.easeus.com/fixo-mcp/v1

1. 概要

EaseUS Fixo MCP Server を使うと、あらゆる MCP 対応 AI エージェント(Claude、Cursor、ChatGPT、Gemini、Windsurf、Trae、GitHub Copilot など 50 以上)が、標準化された Model Context Protocol インターフェースを通じて、破損した動画、写真、ドキュメント、アーカイブ、音声ファイルを修復できます。

EaseUS の 20 年にわたるデータ修復の専門知識(修復済みファイル 1 億 2,000 万件以上、ユーザー評価 4.8/5)を基盤として、Fixo MCP は MCP のベストプラクティスに従った 4 つの専用ツールを提供します。型付き JSON Schema、非同期タスク対応、構造化された結果提供に対応しています。

項目
MCP エンドポイントhttps://repair.easeus.com/fixo-mcp/v1
通信方式Streamable HTTP (JSON-RPC)
ツール4 つ(check_file_healthquery_upload_urlrepairget_repair_status
カテゴリ動画、写真、ドキュメント & アーカイブ、音声
形式100+
最大ファイルサイズ1 ファイルあたり 100 MB
認証OAuth 2.1 — Authorization Code + PKCE、RFC 7591 動的クライアント登録
結果の受け取りWeb 結果ページ URL(プレビュー + ダウンロード)
データ保持修復後 14 日で自動削除

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 の動的クライアント登録によってその場で登録されます。

パラメータ
フローOAuth 2.1 Authorization Code + PKCE (S256)
Scopesrepair:read(健全性確認、ステータス)· repair:write(アップロード、修復)
クライアント登録RFC 7591 — POST https://repair.easeus.com/fixo-mcp/v1/oauth/register
サーバーメタデータRFC 8414 — /.well-known/oauth-authorization-server
リソースメタデータRFC 9728 — /.well-known/oauth-protected-resource
未認可レスポンスWWW-Authenticate ヘッダー付きの HTTP 401
Access Token TTL12 時間
Refresh Token TTL30 日

初回接続フロー

  1. INITIALIZE 呼び出しは、保護リソースのメタデータを指す WWW-Authenticate ヘッダー付きの HTTP 401 を返します
  2. クライアントは認可サーバーを検出し、RFC 7591 の動的クライアント登録によって自身を登録します
  3. 認可ページがブラウザで開くので、EaseUS アカウントでログインしてリクエストを承認します
  4. クライアントは authorization code(PKCE S256)をトークンに交換し、ツール呼び出しを自動で再試行します
注:認可には無料の EaseUS アカウントが必要です。認証フロー中に登録できます。

5. ツールカタログ — 4 つの MCP ツール

すべてのツールは、入力と出力に型付き JSON Schema を使用する MCP の tools/call JSON-RPC メソッドに従います。

check_file_health

ファイルが健全で修復に適しているかを確認します。あらゆる修復の前に推奨される最初のステップです。まずユーザーに提案し、ユーザーの同意がある場合にのみ実行してください。ローカル事前チェック:0 バイトファイルを拒否、すべてのバイトが同じ値のファイルを拒否、ヘッダー/フッターのバイトが拡張子と一致するか確認します。

Input: file_name(必須、拡張子を含む), file_url(必須 — query_upload_url の download_url)

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

Scope: repair:read

query_upload_url

ローカルファイルをアップロードするために必要な S3 アップロード URL とフォームフィールドを取得します(最大 100 MB)。fields のすべてのキーと値に加えてファイル本体を含む multipart/form-data POST を upload_url に送信してください(推奨:curl で fields の各項目ごとに 1 つの -F を使用)。アップロードが成功したら、download_urlfile_url として他のツールに渡します。

Input: file_name(必須、拡張子を含む)

Output: upload_url, download_url, fields, message(アップロード手順)

Scope: repair:write

repair

アップロード済みファイルの修復タスクを作成して開始します。get_repair_statusNeedPwd または PwdErr を返した場合は、ユーザーにファイルのパスワードを尋ね、同じ file_namefile_urlpassword を追加して再度呼び出してください。

Input: file_name(必須), file_url(必須), password(任意 — 暗号化ファイルのみ)

Output: task_id, error(成功時は 0), message

Scope: repair:write

get_repair_status

repair によって作成された修復タスクのステータスと進行状況(0–100)を確認します。ステータスが Pending または Processing の間は、呼び出しの間隔を少なくとも 3 秒空けてください。CompletedFailedNeedPwdPwdErr になったらポーリングを停止します。レスポンスメッセージには、推奨される次のアクションが含まれます。

Input: task_id(必須 — repair が返す値)

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

Scope: repair:read

入出力スキーマ例(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+)

カテゴリ形式
動画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
写真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
ドキュメント & アーカイブ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
音声MP3, AAC, WAV, FLAC, M4A, WMA, AIF, AIFF, OGG, OGA, APE

7. 非同期タスクと結果の受け取り

修復は非同期で実行されます。タスクのライフサイクル:Pending → Processing → Completed / Failed(暗号化ファイルでは NeedPwd / PwdErr が返る場合があります)。

ステータス意味アクション
Pendingタスクは受理済み、ワーカー待ちget_repair_status をポーリング
Processing修復進行中ポーリングを継続 — 呼び出しの間隔を少なくとも 3 秒空ける
Completed修復が正常に完了message のダウンロード手順に従う
Failed修復を完了できなかった失敗メッセージをユーザーに提示する
NeedPwdファイルがパスワード保護されているユーザーにパスワードを尋ね、repair を再度呼び出す
PwdErr提供されたパスワードが誤っている正しいパスワードを尋ねて repair を再度呼び出す

ポーリングのベストプラクティス

  • get_repair_status の呼び出し間隔は少なくとも 3 秒空ける
  • CompletedFailedNeedPwdPwdErr でポーリングを停止する
  • レスポンスの message には常に推奨される次のアクションが含まれる

結果の受け取り

  • バイナリファイルは AI コンテキストに入らないため、トークンを節約できます
  • Completed になったら、repair.easeus.com/history-repair/ にサインインして修復済みファイルをダウンロードします
  • 透かしなし、元の品質のまま

8. エラーハンドリング

エラーは、MCP ツールエラー(ToolError)または code フィールドが 200 以外の構造化結果として返されます。

code説明対処方法
401 (HTTP)MCP エンドポイントに bearer token がないOAuth 認可を完了してください — WWW-Authenticate ヘッダーがメタデータを指します
3file_name に拡張子がない拡張子を含む元のファイル名を渡してください
2006OAuth token の有効期限切れ再認可して呼び出しを再試行してください
50021 日の無料修復枠を使い切ったrepair.easeus.com で Pro にアップグレードするか、Fixo デスクトップアプリを利用してください
ToolError無効なパラメータまたは上流サービスの障害エラーメッセージを確認し、引数を修正して再試行してください

9. レート制限

制限無料プランPro / EaseUS アカウント
1 日あたりの修復回数1無制限
最大ファイルサイズ100 MB100 MB
ステータスポーリング1 タスクあたり 3 秒ごとに 1 回1 タスクあたり 3 秒ごとに 1 回
注:100 MB を超えるファイルには EaseUS Fixo デスクトップクライアント が必要で、数 GB までのファイルをサポートします。

10. セキュリティとプライバシー

  • 暗号化:すべての MCP、アップロード、ダウンロード通信は転送中に TLS で保護されます
  • OAuth 2.1:Authorization Code + PKCE により、AI クライアントにパスワードを公開せず安全に認可できます
  • 最小権限:repair:read は健全性確認とステータスポーリングを対象とし、repair:write はアップロードと修復時にのみ必要です
  • プライバシー:ファイルが第三者と共有されることはなく、AI 学習にも使用されません
  • データ保持:ファイルは 14 日後に自動削除されます
  • コンプライアンス:GDPR、CCPA、SOC 2 Type II、ISO 27001

11. FAQ

Fixo MCP Server とは何ですか?

Fixo MCP Server は Model Context Protocol の実装であり、AI エージェントが 4 つの標準化された MCP ツールを通じて、破損した動画、写真、ドキュメント、アーカイブ、音声ファイルを修復できるようにします。

どの 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 日 1 回無料で修復できます(最大 100 MB)。EaseUS Pro アカウントの所有者は 1 日に無制限で修復できます。100 MB を超えるファイルにはデスクトップクライアントが必要です。

何かインストールする必要がありますか?

いいえ。Fixo MCP は Streamable HTTP エンドポイント経由でアクセスするクラウドサービスです。MCP 互換の AI クライアントがあれば利用できます。

修復したファイルはどこで確認できますか?

タスクが Completed に達したら、repair.easeus.com/history-repair/ でアカウントにサインインして、修復済みファイルをプレビューおよびダウンロードできます。透かしなし、元の品質のままです。

修復にはどのくらい時間がかかりますか?

ほとんどのファイルは 30~60 秒以内に修復されます。大きなファイルや破損がひどいファイルは数分かかる場合があります。get_repair_status ツールで進行状況をリアルタイム(0~100)に確認できます。

12. サポートと連絡先

チャネル連絡先
サポートポータルeaseus.com/support.html
メール[email protected]
MCP ランディングページrepair.easeus.com/mcp/
オンライン修復repair.easeus.com
デスクトップソフトウェアeaseus.com/repair-tools

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/ にアカウントでサインインして、修復済みファイルをダウンロードしてください。"
}
動画の修復が正常に完了しました! - ファイル:birthday_repaired.mp4 - repair.easeus.com/history-repair/ にサインインしてプレビューとダウンロードを行ってください - 透かしなし、元の品質のまま