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

Run on Bloqueボタン

MCPサーバーを管理している場合、READMEに Run on Bloque ボタンを追加できます。訪問者はこのボタンをクリックするだけで、自分のBloque Hubにそのサーバーを数クリックで追加できます。

動作の仕組み​

ボタンをクリックした訪問者は、bloque.run/add の公開プレビューページに移動します。何が追加されるかを確認した後、サインインまたはサインアップし、Hubを選択して、追加サーバーダイアログで自分の認証情報を入力します。保存するまでは何も追加されません。

このボタンは管理者承認やアローリストを経由しません — すでにHubにサーバーを追加できる人であれば、手動でサーバーを追加する場合と同様に、誰でも使用できます。

リンク形式​

https://bloque.run/add?name=<name>&config=<base64 JSON>

name はサーバーの表示名です。config はサーバーを記述するbase64エンコードされたJSONです — これはCursorの「Add to Cursor」インストールリンクと同じペイロード形式なので、既存のCursor設定をそのまま使用できます。

ローカル（stdio）サーバー：

フィールド備考
commandnpx、uvx、uv、pipx のいずれか
args少なくとも1つの引数が必須
env変数名のみ — 下記参照

リモートサーバー：

フィールド備考
url公開されている https:// URL
typehttp（デフォルト）または sse
headersヘッダー名のみ、http トランスポートのみ — 下記参照

Dockerや別のローカルインストールが必要なサーバーはサポートされていません — MCPサーバーを追加する § MCPサーバーの種類を理解する を参照してください。

Bloqueが値をどう扱うか​

Bloqueはリンク経由で認証情報を取り込むことはありません。

  • env と header の値は常に破棄されます。 引き継がれるのは変数名またはヘッダー名だけです。訪問者はサインイン後、自分で実際の値を入力します。
  • URL内の認証情報は削除されます — これにはuserinfo（user:pass@host）や、api_key、token、secret、password のような認証情報らしきクエリパラメータが含まれます。
  • args はそのまま使用されます。 args にシークレットを入れないでください — 代わりに環境変数を使用してください。

リンクを作成する​

最も簡単なのは、サーバーのJSON設定を Run on Bloqueボタンジェネレーター に貼り付ける方法です。サーバー定義そのもの、またはサーバーを1つ含む mcpServers オブジェクトを入力できます。リンクを作成する前に、環境変数とヘッダーの値、およびURL内の認証情報は取り除かれます。

スクリプトで作成する場合、config の値はbase64エンコードされたJSONです。次のワンライナーを使用できます：

node -e 'const c={command:"npx",args:["-y","@acme/mcp-server"],env:{ACME_API_TOKEN:""}};console.log("https://bloque.run/add?name=acme&config="+encodeURIComponent(Buffer.from(JSON.stringify(c)).toString("base64")))'

base64値をURLエンコードすることを推奨しますが、必須ではありません。

ボタンを追加する​

https://bloque.run/run-on-bloque.svg（160×32）で配信されているバッジを使用します。

ボタンジェネレーター では、コピーして使えるMarkdownとHTMLのコードも生成できます。

Markdown：

[![Run on Bloque](https://bloque.run/run-on-bloque.svg)](https://bloque.run/add?name=acme&config=…)

HTML：

<a href="https://bloque.run/add?name=acme&config=…"><img src="https://bloque.run/run-on-bloque.svg" alt="Run on Bloque" width="160" height="32"></a>

知っておくと良いこと​

メールでサインアップした新規訪問者は、追加しようとしていたサーバーに戻るために、確認リンクを同じブラウザで開く必要があります。