# FetchPan MCP サーバー：AI アシスタントでクラウドドライブやファイル共有サイトからダウンロード

> FetchPan の MCP サーバーを使えば、AI アシスタントがリンクを確認し、クラウドドライブの共有を開いて、直接ダウンロードリンクを取得できます。追加方法は以下のとおりです。

ターミナルでこの 1 行を実行し、ブラウザで一度だけ「許可」を押します。このパソコンの Claude Code、Codex、Cursor、WorkBuddy がまとめて接続されます。

```bash
curl -fsSL https://fetchpan.com/setup.sh | sh
```

- サーバーアドレス: https://fetchpan.com/mcp
- トランスポート: Streamable HTTP（ステートレス、プレーンな JSON で応答）
- 認証: MCP ログイン (OAuth)：アプリが fetchpan.com を一度開きます。または API トークン：Authorization: Bearer fp_…（開発者ページで作成）
- ウェブページ: https://fetchpan.com/ja/mcp-server
- JSON 形式のサービス説明: https://fetchpan.com/mcp-server.json

## アプリごとの手順

### Claude Code

1. **ターミナルでこの 1 行を実行**: macOS と Linux で使えます。このパソコンの Codex、Cursor、WorkBuddy もまとめて接続されます。もう一度実行すると更新になります。

```bash
curl -fsSL https://fetchpan.com/setup.sh | sh
```

2. **ブラウザで一度だけ許可**: 許可ページが自動で開きます（開かない場合は、ターミナルに表示されたアドレスをコピーしてください）。FetchPan にログインし、確認コードを確かめて「許可」を押します。
3. **Claude Code を開き直す**: 起動中なら一度終了して開き直すと、FetchPan が使えるようになります。「FetchPan でこのリンクをダウンロードして：…」と頼んでください。

スクリプトを使わない場合（Windows など）： 下のコマンドを実行し、Claude Code で /mcp と入力して fetchpan → Authenticate を選び、ブラウザでログインして許可します。

```bash
claude mcp add --transport http --scope user fetchpan https://fetchpan.com/mcp
```

### Codex（CLI、IDE 拡張機能、アプリ）

1. **ターミナルでこの 1 行を実行**: macOS と Linux で使えます。接続を ~/.codex/config.toml に追記し、ほかの設定はそのまま残します。

```bash
curl -fsSL https://fetchpan.com/setup.sh | sh
```

2. **ブラウザで一度だけ許可**: 許可ページが自動で開きます（開かない場合は、ターミナルに表示されたアドレスをコピーしてください）。FetchPan にログインし、確認コードを確かめて「許可」を押します。
3. **Codex を開き直す**: 起動中なら一度終了して開き直します。/mcp に fetchpan が表示されれば接続完了です。

スクリプトを使わない場合（Windows など）： 開発者ページでトークンを作成し、下のブロックを ~/.codex/config.toml に追加して YOUR_TOKEN を置き換えます。

```toml
[mcp_servers.fetchpan]
url = "https://fetchpan.com/mcp"
http_headers = { Authorization = "Bearer YOUR_TOKEN" }
```

### Cursor

1. **ターミナルでこの 1 行を実行**: macOS と Linux で使えます。接続を ~/.cursor/mcp.json に追加し、ほかのサーバーはそのまま残します。

```bash
curl -fsSL https://fetchpan.com/setup.sh | sh
```

2. **ブラウザで一度だけ許可**: 許可ページが自動で開きます（開かない場合は、ターミナルに表示されたアドレスをコピーしてください）。FetchPan にログインし、確認コードを確かめて「許可」を押します。
3. **Cursor を開き直す**: 完全に終了してから開き直します。設定の MCP で fetchpan がオンになっていれば接続完了です。

スクリプトを使わない場合（Windows など）： 下のブロックを ~/.cursor/mcp.json の mcpServers に追加します。Cursor が初めて FetchPan を使うとき、fetchpan.com が開いてログインを求められます。

```json
{
  "mcpServers": {
    "fetchpan": {
      "url": "https://fetchpan.com/mcp"
    }
  }
}
```

### WorkBuddy

1. **ターミナルでこの 1 行を実行**: macOS と Linux で使えます。接続を ~/.workbuddy-ai/mcp.json に追加し、ほかのサーバーはそのまま残します。

```bash
curl -fsSL https://fetchpan.com/setup.sh | sh
```

2. **ブラウザで一度だけ許可**: 許可ページが自動で開きます（開かない場合は、ターミナルに表示されたアドレスをコピーしてください）。FetchPan にログインし、確認コードを確かめて「許可」を押します。
3. **WorkBuddy で「信任」を押す**: MCP サービス管理を開き、fetchpan の「信任」を押して、新しい会話を始めます。まだ見えない場合は ⌘Q で WorkBuddy を完全に終了して開き直してください。

スクリプトを使わない場合（Windows など）： 開発者ページでトークンを作成し、下のブロックを ~/.workbuddy-ai/mcp.json の mcpServers に追加して（既存の項目は残す）YOUR_TOKEN を置き換え、「信任」を押します。

```json
{
  "mcpServers": {
    "fetchpan": {
      "type": "http",
      "url": "https://fetchpan.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}
```

### Claude（Web 版とデスクトップアプリ）

1. **カスタムコネクタを追加**: Claude で「設定 (Settings)」→「コネクタ (Connectors)」を開き、「カスタムコネクタを追加 (Add custom connector)」を押します。
2. **アドレスを入力**: 名前は FetchPan、URL に下のアドレスを入れて「追加」を押します。

```bash
https://fetchpan.com/mcp
```

3. **ログインして許可**: 「接続 (Connect)」を押すと fetchpan.com が開きます。ログインして「許可」を押してください。そのあと会話のツールメニューで FetchPan をオンにします。

メニュー名はプランやバージョンによって少し異なる場合があります。

### ChatGPT

1. **開発者モードをオン**: 「設定」→「アプリとコネクター (Apps & Connectors)」→「詳細設定 (Advanced settings)」で、開発者モード (Developer mode) をオンにします。
2. **コネクターを作成**: 「作成 (Create)」を押し、名前は FetchPan、URL に下のアドレスを入れ、認証方式は OAuth を選びます。

```bash
https://fetchpan.com/mcp
```

3. **ログインして許可**: 「接続 (Connect)」を押すと fetchpan.com が開きます。ログインして「許可」を押してください。会話では「+」メニューから FetchPan を追加します。

開発者モードとメニュー名は、ChatGPT のプランやバージョンによって異なります。

### VS Code

1. **サーバーを追加**: 下のブロックをプロジェクトの .vscode/mcp.json に追加するか、コマンドパレットで MCP: Add Server を実行して HTTP を選び、アドレスを入力します。

```json
{
  "servers": {
    "fetchpan": {
      "type": "http",
      "url": "https://fetchpan.com/mcp"
    }
  }
}
```

2. **ログインして許可**: 初めて FetchPan を使うとき、VS Code がログインを求めます。ブラウザで fetchpan.com が開くので、ログインして「許可」を押します。
3. **Copilot チャットで使う**: Agent モードに切り替えて「FetchPan でこのリンクをダウンロードして：…」と頼みます。

### その他のアプリ

1. **リモート MCP サーバーを追加**: アプリでリモート MCP サーバー（Streamable HTTP）を追加し、アドレスに下のものを入れます。

```bash
URL:     https://fetchpan.com/mcp
Type:    Streamable HTTP (remote MCP)
Auth:    sign in when the app asks (OAuth), or Authorization: Bearer YOUR_TOKEN
```

2. **ログイン、またはトークン**: MCP ログイン（OAuth）に対応したアプリは fetchpan.com を開くので、ログインして「許可」を押します。対応していない場合は、開発者ページでトークンを作成し、Authorization: Bearer YOUR_TOKEN ヘッダーで送ります。

## 接続できたら、話しかけるだけ

次の文を AI に送り、続けてリンクを貼り付けてください。

- FetchPan でこのリンクをダウンロードして：
- この共有にどんなファイルがあるか見て、動画を FetchPan でダウンロードして：
- FetchPan アカウントの通信量と無料ファイルはあとどれくらい？

## できること

MCP (Model Context Protocol) は、AI アシスタントが外部ツールを使うための標準的な仕組みです。FetchPan を追加すれば、AI に「この Baidu のリンクをダウンロードして」と頼むだけで済みます。

AI はまず、そのサイトに対応しているかを確認します。共有にフォルダがある場合はファイルの一覧を表示して選べるようにし、そのうえで当サービスのサーバーにファイルを準備させて、直接ダウンロードリンクを渡します。

FetchPan アカウントで動作します。初回はアプリが fetchpan.com を開くので、ログインして許可してください。1 日 3 ファイルまで無料で、通信量があれば高速ダウンロードも使えます。

SNS の投稿にも対応：X・Douyin・小紅書・Instagram の投稿リンクを AI に渡すだけで、動画や写真を自分で取得し、視聴・文字起こし・分析に使えます。SNS 投稿は無料枠が別で、1 日 20 件です。

## ツール

ツールは 11 個です。通常、エージェントに必要なのは download だけです。どのツールも FetchPan アカウントで動くため、最初にアプリでログインします（またはアプリがトークンを送ります）。

| ツール | 機能 | 消費 |
| --- | --- | --- |
| `download` | リンクを渡すと、ファイルの準備ができるまで待ってダウンロード URL を返します。時間内に準備できなかった場合は、続きに使うジョブ ID を返します。複数のファイルを含む共有では、ファイルの一覧を返すので、そこから 1 つ選びます。 | 無料ファイル 1 件、または通信量（高速） |
| `download_social` | X・Douyin・小紅書・Instagram の投稿を渡すと、その投稿の動画と写真の直接ダウンロード URL を返します。ファイルが小さく、AI がそのまま取得して分析できます。 | 1 日 20 件の無料投稿のうち 1 件 |
| `check_link` | このサイトに対応しているか、今使えるかを確認します。 | なし |
| `list_supported_sites` | 対応しているすべてのサイトと、そのリアルタイムのステータス。 | なし |
| `list_files` | Quark や PikPak の共有内のフォルダを開いて、目的のファイルを探します（見つけたら share_id と file_id でダウンロードします）。 | なし |
| `start_download` | 待たずにジョブを開始し、ジョブ ID を返します。 | なし |
| `get_job` | ジョブのステータスと、無料または高速でダウンロードした場合の消費量。 | なし |
| `get_download_link` | 完了したジョブの URL（無料または高速）。 | 無料ファイル 1 件、または通信量（高速） |
| `get_account` | メールアドレス、通信量の残高、1 日の無料ファイル数、最近のダウンロード。 | なし |
| `list_packages` | 購入できる通信量パック。 | なし |
| `create_payment_link` | パックの支払いページ（ユーザーに渡すためのもの）。支払いは人間にしかできません。 | なし |

## うまくいかないとき

**ブラウザが自動で開かない**

ターミナルに表示されたアドレスをコピーして、ブラウザで開いてください。10 分間有効です。期限が切れたらコマンドをもう一度実行します。

**インストールしたのに AI に FetchPan が出てこない**

アプリを完全に終了して開き直してください（ウィンドウを閉じるだけでは不十分です）。Claude Code では /mcp に fetchpan が表示されます。WorkBuddy は MCP サービス管理で「信任」も必要です。

**Windows ではどうする？**

このコマンドは macOS か Linux のターミナルで動きます（Windows なら WSL が使えます）。各アプリの「スクリプトを使わない場合」の手順で手動でも追加できます。

**このコマンドは何をする？**

fetchpan.com を開いてこのパソコンを許可してもらい、同じトークンを Claude Code、Codex、Cursor、WorkBuddy の設定に書き込みます。トークンは ~/.config/fetchpan/mcp-token に保存され、本人しか読めません。先に中身を見たい場合は https://fetchpan.com/setup.sh を開いてください。

**Codex で config.toml に fetchpan の設定がすでにあると言われる**

以前に手動で追加した設定です。~/.codex/config.toml の [mcp_servers.fetchpan] の部分を削除して、もう一度コマンドを実行してください。

**接続を解除するには？更新するには？**

解除：開発者ページでこのパソコンのトークン（パソコン名と setup.sh の名前）を削除すると、すべてのアプリがすぐに切断されます。更新：この 1 行をもう一度実行します。接続済みのアプリはそのまま残ります。

## トークンを使いたい場合は？

ログインに対応していないツール（Codex、WorkBuddy、自作のスクリプトなど）では、開発者ページで API トークンを作成し、Authorization: Bearer … として送信してください。 https://fetchpan.com/ja/developers
