メインコンテンツまでスキップ

実行境界

Bloqueでのstdioサーバーの実行方法​

通常のMCPセットアップでは、stdioベースのサーバーはAIエージェントと同じマシン上の子プロセスとして実行されます。ローカルファイルの読み書き、ローカルデータベースへのアクセス、ローカルサービスへの直接呼び出しが可能です。

Bloqueでは、stdioベースのサーバーはローカルマシンではなくBloqueのMCP Proxyインフラストラクチャ内で実行されます。

これが意味すること：

  • stdioベースのMCPサーバープロセスはローカルファイルシステムにアクセスできません。
  • ツールがローカルパスを受け付けるように見えても、コンピューター上のファイルを読み取れません。
  • stdioサーバーからのネットワークアクセスは、ローカルネットワークではなくBloqueのインフラストラクチャを経由します。

リモートMCPサーバー（SSE/HTTP）は影響を受けません — そもそもリモートインフラストラクチャ上で実行されているためです。

/shared ファイルシステム​

Bloqueは /shared にある共有ファイルシステムを公開しており、あなたのHubセッションで実行されているすべてのMCPサーバープロセスからアクセスできます。これをローカルマシンとBloqueホストのstdioツール間でファイルを受け渡すブリッジとして使用できます。

Bloqueにファイルをアップロードする​

  1. bloque_get_upload_url ツールを呼び出して、事前署名済みHTTPアップロードURLを取得する。
  2. そのURLにHTTP PUT でファイルをアップロードする。
  3. ファイルはセッション内のすべてのMCPサーバーから /shared の下で利用可能になる。

Bloqueからファイルをダウンロードする​

  1. /shared 以下のパスで bloque_get_download_url を呼び出す。
  2. HTTP GET でファイルをローカルマシンにダウンロードする。

ファイルの一覧表示​

/shared 以下のファイルとディレクトリを確認するには、標準的なファイルシステムツール（例：list_directory、read_file）を使用してください。

AIエージェントへのプロンプト例​

ローカルファイルを含むタスクを開始する際は、この境界についてAIエージェントに伝えてください：

重要なコンテキスト：BloqueはMCPゲートウェイです。stdioベースのMCPサーバーは
Bloqueのインフラストラクチャ上で実行されており、あなたのマシン上ではありません。
これらのツールは /shared 以下のファイルにのみアクセスできます。
境界を越えてファイルを移動するには：
- ローカル → Bloqueへのアップロード: bloque_get_upload_url + HTTP PUT
- Bloque → ローカルへのダウンロード: bloque_get_download_url + HTTP GET
- /shared を参照: ファイルシステムツールを使用

このコンテキストを事前に提供することで、エージェントがMCPサーバープロセスから到達できないローカルパスを参照しようとするのを防げます。