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

Codexを接続する

Codex（CLIとIDE拡張は同じ設定を共有します）からチームのMCPサーバーにBloque経由で接続します。

1. Bloqueアカウントを作成する​

bloque.run にアクセスし、GitHubまたはメールアドレスでサインアップします。Hubは自動的に作成されます。

2. MCPサーバーを追加する​

MCP Servers → Add Server に移動し、レジストリからサーバーを選ぶか、GitHub URLまたはnpmパッケージ名を貼り付けるか、接続情報を手動で入力します。詳しくは MCPサーバーを追加する を参照してください。

3. APIキーを生成する​

サイドバーの API Keys を開いてキーを作成します。Codexは、起動元のプロセスから環境変数を読み取ります。BLOQUE_API_KEY を利用可能にするには、主に3つの方法があります。

オプション1: シェルでキーをエクスポートする​

~/.zshrc または ~/.bashrc などのシェルプロファイルに追加します。

export BLOQUE_API_KEY="your Bloque API key"

新しいターミナルを開いて、そのターミナルからCodexを起動します。

オプション2: .env ラッパーを使う​

キーをプロジェクトの .env ファイルに保存している場合:

BLOQUE_API_KEY="your Bloque API key"

bin/codex-with-env などのラッパースクリプトを作成します。

#!/usr/bin/env bash
set -euo pipefail

set -a
source .env
set +a

exec codex "$@"

オプション3: OSのシークレットストアからキーを読み取る​

キーをOSの管理するキーチェーンに保存し、起動時に読み取ります。たとえば cross-keychain を使う場合:

#!/usr/bin/env bash
set -euo pipefail

export BLOQUE_API_KEY="$(cross-keychain get bloque BLOQUE_API_KEY)"
exec codex "$@"

4. Codexを接続する​

Codex CLIとIDE拡張は同じMCP設定を共有します。Bloqueは config.toml、または codex mcp add コマンドで設定できます。

オプション1: config.toml​

~/.codex/config.toml、または信頼済みプロジェクト内の .codex/config.toml に追加します。

[mcp_servers.bloque]
url = "https://mcp.bloque.run/mcp"
bearer_token_env_var = "BLOQUE_API_KEY"

BLOQUE_API_KEY が設定されているシェルからCodexを起動します。

オプション2: codex mcp add​

CLIから同じサーバーを追加します。

codex mcp add bloque --url https://mcp.bloque.run/mcp --bearer-token-env-var BLOQUE_API_KEY

確認します。

codex mcp list

bloque が表示されます。

詳細は Codex MCPドキュメント を参照してください。

5. 試す​

BLOQUE_API_KEY が設定されているシェルから codex を起動し、次のように質問します。

Bloqueで利用できるツールを教えてください。

Codexがステップ2で追加したサーバーのツールを一覧表示すれば成功です。

次のステップ​