🧰

WSL環境でClaude DesktopからMCP Toolbox（BigQuery）に接続する方法

に公開
WSL
Model Context Protocol
tech

はじめに

GoogleのMCP Toolboxを使ってClaude DesktopからBigQueryにアクセスしようとしたところ、WSL（Windows Subsystem for Linux）環境での設定が公式ドキュメントと少し異なったため、その手順をまとめました。

公式ドキュメント：Google Cloud BigQuery - Pre-built tools with MCP toolbox

環境

  • Windows 11
  • WSL2 (Ubuntu)
  • Claude Desktop for Windows
  • Google Cloud SDK

手順

1. WSL内でMCP Toolboxをダウンロード・設定

# WSL内で実行
cd ~
curl -O https://storage.googleapis.com/genai-toolbox/v0.14.0/linux/amd64/toolbox
chmod +x toolbox

# インストール確認
./toolbox --version

2. Google Cloud認証の設定

ここが最も重要なポイントです。WSL環境では通常のブラウザ認証が失敗するため、スコープを明示的に指定する必要があります。

# 既存の認証情報をクリア（必要に応じて）
gcloud auth revoke --all

# スコープを明示的に指定して認証
gcloud auth application-default login --scopes=https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/bigquery --no-launch-browser

認証URLが表示されるので、Windows側のブラウザでアクセスして認証を完了してください。

# quota projectを設定（警告回避のため）
gcloud auth application-default set-quota-project your-project-id

# プロジェクト設定
gcloud config set project your-project-id

3. WSL内でのテスト

# 動作確認
BIGQUERY_PROJECT='your-project-id' ./toolbox --prebuilt bigquery --stdio

エラーが出なければ成功です。

4. Claude Desktop設定

Windows側のClaude Desktop設定ファイル（C:\Users\[ユーザー名]\AppData\Roaming\Claude\claude_desktop_config.json）を編集します。

重要なポイントは、envセクションではなく、コマンド文字列内で環境変数を指定することです：

{
  "mcpServers": {
    "bigquery": {
      "command": "wsl",
      "args": [
        "-e",
        "bash",
        "-l",
        "-c",
        "BIGQUERY_PROJECT='your-project-id' /home/your-username/toolbox --prebuilt bigquery --stdio"
      ],
      "env": {}
    }
  }
}

5. Claude Desktopの再起動

設定ファイルを保存した後、Claude Desktopを完全に終了して再起動してください。

トラブルシューティング

認証エラーが発生する場合

最初に以下のエラーが発生しました：

ERROR "unable to parse prebuilt tool configuration: error parsing environment variables: environment variable not found: \"BIGQUERY_PROJECT\""

これは、Claude Desktop（Windows）からWSLに環境変数が正しく渡されていないことが原因でした。

ブラウザ認証の問題

WSLでgcloud auth application-default loginを実行すると以下のエラーが発生：

ERROR: There was a problem with web authentication. Try running again with --no-browser.

解決方法：

  1. --no-launch-browserオプションを使用
  2. スコープを明示的に指定
  3. 表示されたURLを手動でブラウザで開く

スコープエラー

以下のエラーも発生しました：

ERROR: (gcloud.auth.application-default.login) https://www.googleapis.com/auth/cloud-platform scope is required but not consented.

解決方法：

gcloud auth application-default login --scopes=https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/bigquery --no-launch-browser

動作確認

正常に接続できると、Claude DesktopでBigQueryのデータセットやテーブルを操作できるようになります：

  • データセット一覧の取得
  • テーブル構造の確認
  • SQLクエリの実行

まとめ

WSL環境でMCP Toolboxを使用する際の主なポイント：

  1. 認証はスコープを明示的に指定して--no-launch-browserオプションを使用
  2. 環境変数はコマンド文字列内で指定（envセクションではなく）
  3. WSLコマンドはbash -l -cで実行してログインシェル環境を使用

これらの設定により、Windows上のClaude DesktopからWSL内のMCP ToolboxでBigQueryにアクセスできるようになります。

参考

Discussion