Fixo MCP Server — 完全統合ガイド。
あらゆる MCP 対応 AI エージェントを EaseUS Fixo に接続するための手順付き技術リファレンスです。認証、ツールスキーマ、非同期ワークフロー、エラーハンドリング、60 以上の対応ファイル形式を網羅しています。
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_health、query_upload_url、repair、get_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
- Cursor を開く → Settings → MCP
- Add New MCP Server をクリック
- 種類として URL を選択
- 次を入力:
https://repair.easeus.com/fixo-mcp/v1 - Add をクリック
3.3 ChatGPT
ChatGPT はコネクタ経由でリモート MCP Server に対応しています:
- Settings → Connectors → Advanced で開発者モードを有効にする
- 新しいコネクタを作成し、MCP Server URL として
https://repair.easeus.com/fixo-mcp/v1を入力する - ブラウザで OAuth 認可を完了する
- これで 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) |
| Scopes | repair: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 TTL | 12 時間 |
| Refresh Token TTL | 30 日 |
初回接続フロー
- INITIALIZE 呼び出しは、保護リソースのメタデータを指す
WWW-Authenticateヘッダー付きの HTTP 401 を返します - クライアントは認可サーバーを検出し、RFC 7591 の動的クライアント登録によって自身を登録します
- 認可ページがブラウザで開くので、EaseUS アカウントでログインしてリクエストを承認します
- クライアントは authorization code(PKCE S256)をトークンに交換し、ツール呼び出しを自動で再試行します
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_url を file_url として他のツールに渡します。
Input: file_name(必須、拡張子を含む)
Output: upload_url, download_url, fields, message(アップロード手順)
Scope: repair:write
repair
アップロード済みファイルの修復タスクを作成して開始します。get_repair_status が NeedPwd または PwdErr を返した場合は、ユーザーにファイルのパスワードを尋ね、同じ file_name と file_url に password を追加して再度呼び出してください。
Input: file_name(必須), file_url(必須), password(任意 — 暗号化ファイルのみ)
Output: task_id, error(成功時は 0), message
Scope: repair:write
get_repair_status
repair によって作成された修復タスクのステータスと進行状況(0–100)を確認します。ステータスが Pending または Processing の間は、呼び出しの間隔を少なくとも 3 秒空けてください。Completed、Failed、NeedPwd、PwdErr になったらポーリングを停止します。レスポンスメッセージには、推奨される次のアクションが含まれます。
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 秒空けるCompleted、Failed、NeedPwd、PwdErrでポーリングを停止する- レスポンスの
messageには常に推奨される次のアクションが含まれる
結果の受け取り
- バイナリファイルは AI コンテキストに入らないため、トークンを節約できます
Completedになったら、repair.easeus.com/history-repair/ にサインインして修復済みファイルをダウンロードします- 透かしなし、元の品質のまま
8. エラーハンドリング
エラーは、MCP ツールエラー(ToolError)または code フィールドが 200 以外の構造化結果として返されます。
| code | 説明 | 対処方法 |
|---|---|---|
| 401 (HTTP) | MCP エンドポイントに bearer token がない | OAuth 認可を完了してください — WWW-Authenticate ヘッダーがメタデータを指します |
| 3 | file_name に拡張子がない | 拡張子を含む元のファイル名を渡してください |
| 2006 | OAuth token の有効期限切れ | 再認可して呼び出しを再試行してください |
| 5002 | 1 日の無料修復枠を使い切った | repair.easeus.com で Pro にアップグレードするか、Fixo デスクトップアプリを利用してください |
| ToolError | 無効なパラメータまたは上流サービスの障害 | エラーメッセージを確認し、引数を修正して再試行してください |
9. レート制限
| 制限 | 無料プラン | Pro / EaseUS アカウント |
|---|---|---|
| 1 日あたりの修復回数 | 1 | 無制限 |
| 最大ファイルサイズ | 100 MB | 100 MB |
| ステータスポーリング | 1 タスクあたり 3 秒ごとに 1 回 | 1 タスクあたり 3 秒ごとに 1 回 |
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/ にアカウントでサインインして、修復済みファイルをダウンロードしてください。"
}