putput-mcp

@putput/mcp

AI エージェント向けのファイルアップロードです。Claude Code、Cursor、Windsurf、VS Code Copilot から、登録不要でファイルをアップロード、一覧表示、管理できます。

クイックスタート

無料の API トークンを取得します（登録不要）：

curl -X POST https://putput.io/api/v1/auth/guest | jq .token

Claude Code

claude mcp add putput -- npx @putput/mcp -e PUTPUT_TOKEN=pp_your_token

Cursor

.cursor/mcp.json に追加します：

{
  "mcpServers": {
    "putput": {
      "command": "npx",
      "args": ["@putput/mcp"],
      "env": {
        "PUTPUT_TOKEN": "pp_your_token"
      }
    }
  }
}

VS Code Copilot

.vscode/mcp.json に追加します：

{
  "servers": {
    "putput": {
      "command": "npx",
      "args": ["@putput/mcp"],
      "env": {
        "PUTPUT_TOKEN": "pp_your_token"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json に追加します：

{
  "mcpServers": {
    "putput": {
      "command": "npx",
      "args": ["@putput/mcp"],
      "env": {
        "PUTPUT_TOKEN": "pp_your_token"
      }
    }
  }
}

リモート（ストリーミング可能な HTTP）

クライアントがリモート MCP サーバーに対応している場合：

https://putput.io/api/v1/mcp

トークンは Authorization ヘッダーで Bearer トークンとして渡します。

ツール

ツール	説明
upload_file	URL から PutPut にファイルをアップロードし、CDN リンクを取得します
list_files	オプションのプレフィックスフィルターとページネーションを指定して、アップロード済みファイルを一覧表示します
delete_file	ID を指定してファイルを削除します
get_file_info	ファイルの詳細、統計情報、ダウンロード URL を取得します

仕組み

1. AI エージェントが URL を指定して upload_file を呼び出します
2. PutPut がファイルを Cloudflare R2 にアップロードします
3. CDN URL が返されます。これで完了です

AWS も設定もデプロイの手順も不要です。ファイルは 300 か所以上のエッジロケーションから配信され、エグレス料金は $0 です。

料金

• ゲスト： 1 GB 無料、登録不要、有効期限は 14 日間
• 無料： 10 GB 無料、アカウントが必要です
• Pro： 50 GB で月額 $9 から、帯域幅無制限、エグレス料金 $0

リンク

• ウェブサイト： https://putput.io
• API ドキュメント： https://docs.putput.io
• SDK： npm install @putput/sdk
• CLI： npx @putput/cli upload <file>
• GitHub： https://github.com/putput-io