Box

mcp-box

Box（エンタープライズ向けクラウドストレージ）MCP パック

Pipeworx の一部です。AI エージェントを 1875 以上の稼働中のデータソースに接続する MCP ゲートウェイです。独立した非公式の連携であり、上流のプロバイダーとは提携関係になく、承認も受けておらず、公開元でもありません。

ツール

ツール	説明
box_list_folder	Box（エンタープライズ向けクラウドストレージ）フォルダー内のファイルとサブフォルダーを一覧表示します。フォルダー ID を指定するか、省略するとルートフォルダー（「0」）を一覧表示します。各項目の ID、種類（ファイルまたはフォルダー）、名前、サイズ（バイト単位）、最終更新日時を返します。ユーザーの Box ドキュメントやファイルを閲覧する際に使用します。
box_get_file	ファイル ID を指定して、Box（クラウドストレージ）内の単一ファイルのメタデータ全体を取得します。ID、名前、サイズ、説明、作成日時と更新日時、親フォルダー名、共有リンク URL、ファイル拡張子を返します。一覧表示または検索の後に、1 つのドキュメントを確認する際に使用します。
box_search	クエリ文字列に一致するファイルやフォルダーを、名前とコンテンツから検索します。ファイルのみ、またはフォルダーのみへの絞り込みもできます。一致した項目の ID、種類、名前、サイズ、最終更新日時を返します。キーワードでドキュメントを見つける際に使用します。
box_get_file_text	ファイル ID を指定して、Box（クラウドストレージ）内のファイルをダウンロードし、テキストコンテンツを返します。プレーンテキスト、Markdown、CSV などのテキストドキュメントに最適です。バイナリ形式（Office ドキュメント、PDF、画像）は読み取れないバイト列を返します。コンテンツは約 100,000 文字に制限され、切り捨てられた場合はその旨が示されます。
box_get_user	サインイン中の Box（クラウドストレージ）ユーザーのプロフィールを取得します。ID、名前、ログイン用メールアドレス、ストレージ総容量（space_amount、バイト単位）、使用済みストレージ容量（space_used、バイト単位）を返します。接続中のアカウントの確認や、ストレージ使用量の報告に使用します。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "box": {
      "url": "https://gateway.pipeworx.io/box/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/box/mcp の tools/list は、上の表にあるツールに加えて、共有 Pipeworx メタツールである ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で利用できる一連のツールを返します。そのため、表示されるツール数はこの表の数より多くなります。現在、単一パックのエンドポイントには、パック独自のツールに加えて、共有ツールがおよそ 30 個表示されます。接続の initialize 応答に正確な範囲が示されており、その日の実際の内容を確認するにはこれが基準となります。

これは意図的な仕様であり、偶然に多重化されているわけではありません。メタツールを使うことで、このパックの対象外の質問にも、カタログ全体を横断してルーティングする ask_pipeworx を通じて対応できます。そのため、MCP サーバーを 2 つ目に追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントを接続する方法はありません。追加のスキーマによるコンテキストのコストがルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、Pipeworx のフルゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も、同じゲートウェイと同じ 1875 以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。ask_pipeworx を使えば、どちらからでもすべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP 経由で呼び出す

このパックは接続済みの box アカウントを使用するため、Pipeworx キーが必要です。https://pipeworx.io/account でサインインして box を接続し、Authorization: Bearer <your Pipeworx key> を付けて POST https://gateway.pipeworx.io/v1/tools/box_list_folder を呼び出します。任意のツールの詳細を確認するには、GET https://gateway.pipeworx.io/v1/tools/box_list_folder を実行します。ツールを探すには、{"query":"..."} を付けて POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルの stdio MCP サーバーとしても実行でき、Pipeworx アカウントやゲートウェイとの往復通信は不要です。

{
  "mcpServers": {
    "box": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-box"]
    }
  }
}

または、直接実行して起動することを確認できます。

npx -y @pipeworx/mcp-box

標準入力／標準出力を介して MCP で通信し、initialize／tools/list／tools/call に対して、このパックのツールのみを使って応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使う

ツールを直接呼び出す代わりに、自然な英語で質問できます。これは上記のパックのエンドポイントでも、完全なゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Box data" })

ゲートウェイが適切なツールを選択し、引数を自動的に入力します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT