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

Claude Codeを接続する

Claude CodeからチームのMCPサーバーにBloque経由で接続します。サーバーごとのローカル設定を、1つのHTTPエンドポイントに置き換えられます。

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

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

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

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

3. APIキーを生成する​

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

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

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

export BLOQUE_API_KEY="your Bloque API key"

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

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

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

BLOQUE_API_KEY="your Bloque API key"

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

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

set -a
source .env
set +a

exec claude "$@"

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

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

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

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

4. 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​

プロジェクトディレクトリで次を実行します。

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

これにより、コミット可能な .mcp.json が作成されます。チームメイトは同じ設定を使え、各自の BLOQUE_API_KEY だけを用意すれば済みます。

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

確認します。

claude mcp list

bloque が接続済みとして表示されます。

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

5. 試す​

claude を起動して /mcp を実行すると、Bloqueの状態とツールを確認できます。または次のように質問します。

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

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

次のステップ​