クライアント設定

すべてのMCPクライアントがBloqueに接続するために必要な2つの値：

フィールド	値
URL	`https://mcp.bloque.run/mcp`
Authorization	`Bearer <あなたのAPIキー>`

Claude Code

Claude Codeはリモートエンドポイントに直接HTTP接続します。プロジェクトスコープの .mcp.json ファイルまたは claude mcp add コマンドで設定できます。

オプション1: `.mcp.json`

プロジェクトに .mcp.json を作成または更新します：

{
  "mcpServers": {
    "bloque": {
      "type": "http",
      "url": "https://mcp.bloque.run/mcp",
      "headers": {
        "Authorization": "Bearer ${BLOQUE_API_KEY}"
      }
    }
  }
}

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

オプション2: `claude mcp add`

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

claude mcp add --transport http --scope project bloque https://mcp.bloque.run/mcp \
  --header 'Authorization: Bearer ${BLOQUE_API_KEY}'

claude mcp list で確認します — bloque が表示されるはずです。

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

Codex

Codex CLIとIDEエクステンションは同じMCP設定を共有します。config.toml または codex mcp add コマンドでBloqueを設定できます。

オプション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ドキュメントを参照してください。

環境変数

Claude Code、Codex、およびその他のMCPクライアントは、クライアントを起動するプロセスから環境変数を読み取ります。.env ファイルを自動的には読み込まないことが多いため、クライアントを起動する前に BLOQUE_API_KEY が利用可能であることを確認してください。

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

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

export BLOQUE_API_KEY="あなたのBloqueのAPIキー"

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

オプション2: 小さな `.env` ラッパーを使用する

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

BLOQUE_API_KEY="あなたのBloqueのAPIキー"

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

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

set -a
source .env
set +a

exec codex "$@"

Claude Codeにも同じパターンを使用します：

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

set -a
source .env
set +a

exec claude "$@"

これは .env がシンプルなシェル互換の KEY=value 行を含む場合に最も効果的です。

オプション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 "$@"

ラッパーがClaude Code用の場合は exec claude "$@" に変更してください。

Visual Studio Code

VS CodeはHTTPによるネイティブリモートMCPサーバーをサポートしています。ブリッジは不要です。

グローバルまたはワークスペースの mcp.json を編集します（コマンドパレットから MCP: サーバーを追加 を実行するか、直接ファイルを編集します）：

{
  "servers": {
    "bloque": {
      "type": "http",
      "url": "https://mcp.bloque.run/mcp",
      "headers": {
        "Authorization": "Bearer ${input:bloque-api-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "bloque-api-key",
      "description": "Bloque APIキー"
    }
  ]
}

Cursor

Cursor → Integrations → MCP を開く。
Edit mcp.json を選択する。
bloque エントリを追加またはマージする：

{
  "mcpServers": {
    "bloque": {
      "type": "http",
      "url": "https://mcp.bloque.run/mcp",
      "headers": {
        "Authorization": "Bearer <あなたのAPIキー>"
      }
    }
  }
}

LM Studio

LM Studio → Integrations → MCP を開き、Edit mcp.json を選択する。
mcpServers オブジェクト内に bloque エントリを追加する：

{
  "mcpServers": {
    "bloque": {
      "type": "http",
      "url": "https://mcp.bloque.run/mcp",
      "headers": {
        "Authorization": "Bearer <あなたのAPIキー>"
      }
    }
  }
}

ファイルを保存するとLM StudioのMCPサーバーが自動的に再読み込みされます。

ChatGPT

ChatGPTはカスタムMCPコネクターをサポートしています。Pro、Team、Enterprise、またはEdu プランで開発者モードを有効にする必要があります。

ChatGPT 設定 → コネクター → 詳細設定 を開き、開発者モード を有効にする。
コネクター に戻り、作成をクリックする。
MCPサーバーURLとして https://mcp.bloque.run/mcp、BearerトークンとしてBloqueのAPIキーを使ってカスタムコネクターを追加する。

Team、Enterprise、Eduワークスペースではユーザーがカスタムコネクターを追加する前に、管理者が開発者モードを有効にするか、カスタムコネクターを承認する必要がある場合があります。

Claude Desktop

Claude Desktopは現在リモートMCPコネクターをサポートしていません。代わりに mcp-remote ブリッジを使用し、claude_desktop_config.json に以下を追加します：

{
  "mcpServers": {
    "bloque": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.bloque.run/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <あなたのAPIキー>"
      }
    }
  }
}

設定ファイルの場所：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Claude Code​

オプション1: .mcp.json​

オプション2: claude mcp add​

Codex​

オプション1: config.toml​

オプション2: codex mcp add​

環境変数​

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

オプション2: 小さな .env ラッパーを使用する​

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

Visual Studio Code​

Cursor​

LM Studio​

ChatGPT​

Claude Desktop​