MCP 経由で Databricks を Gemini に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Databricks をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Databricks + Gemini

AI に Databricks ワークスペースを操作させます。SQL ウェアハウスでの SQL 実行、Unity Catalog のカタログ、スキーマ、テーブルの探索、クラスター、ウェアハウス、ジョブ、実行履歴の確認、ノートブックの読み取りができ、確認のうえでコンピュートの起動や停止、ジョブの実行も行います。個人用アクセストークンで接続します。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

DATABRICKS_HOST, DATABRICKS_TOKEN

ステップ 1 — 認証情報を取得

1. Databricks ワークスペースを開き、アドレスバーのホスト名を https:// を付けずに DATABRICKS_HOST にコピーします。例: dbc-a1b2c3d4-e5f6.cloud.databricks.com（AWS）、adb-1234567890123456.7.azuredatabricks.net（Azure）、1234567890123456.7.gcp.databricks.com（Google Cloud）。
2. 右上のユーザー名をクリックし、Settings → Developer → Access tokens → Manage → Generate new token を開きます。コメントと有効期間を付けてトークンを作成し、DATABRICKS_TOKEN にコピーします。Databricks はトークンを 1 回しか表示しません。ワークスペース管理者が個人用アクセストークンを許可している必要があります。
3. 権限を最小限にするには、AI に必要な権限だけを持つ サービスプリンシパル 用にトークンを作成します。データに対する USE CATALOG、USE SCHEMA、SELECT と、1 つの SQL ウェアハウスに対する CAN USE です。コネクタはトークンのユーザーの権限で動作します。
4. コネクタをインストールし、databricks_get_current_user を実行して、AI がどのユーザーとして動作するかを確認します。

コンピュートは有料なので、AI は先に確認します: Databricks はコンピュートを DBU で課金します。停止中の SQL ウェアハウスにクエリを送ると自動的に起動し、稼働中のウェアハウスやクラスターは自動停止するまで費用がかかります。AI は SQL を実行する前に databricks_list_warehouses でウェアハウスを確認し、稼働していなければ、クエリで起動することとそのサイズを伝え、あなたの同意を待ちます。サーバーレスウェアハウスなら数秒で起動します。

ウェアハウスでの SQL: databricks_execute_sql は 1 つのステートメントを実行し、既定で最大 200 行（上限 10,000 行）を返します。データ、テーブル、権限を変更するもの（INSERT、UPDATE、DELETE、MERGE、CREATE、ALTER、DROP、GRANT）は、AI が正確なステートメントを示し、明確な同意を待ちます。そもそも何が許可されるかは、トークンの Unity Catalog 権限で決まります。長いステートメントはバックグラウンドで実行が続き、databricks_get_statement で進捗を追い、databricks_get_statement_chunk で続きの行を取得します。

Unity Catalog: databricks_list_catalogs、databricks_list_schemas、databricks_list_tables、databricks_get_table で、カタログ、スキーマ、テーブル、ビューとその列を確認できるので、AI は正しい名前で SQL を書けます。

その他の変更もすべて先に確認します: databricks_start_cluster、databricks_terminate_cluster、databricks_start_warehouse、databricks_stop_warehouse、databricks_run_job、databricks_cancel_job_run、databricks_cancel_statement。クラスターを終了したりウェアハウスを停止したりすると、その上で動いているクエリやノートブックも終了します。このコネクタは何も削除しません。

ジョブ: databricks_list_jobs と databricks_get_job でジョブ、スケジュール、パラメーター、タスクを確認し、databricks_run_job で今すぐ実行します。databricks_list_job_runs、databricks_get_job_run、databricks_get_run_output は実行履歴、タスクの状態、エラー、ノートブックの出力（60 日間保存）を表示します。

ノートブックとファイル: databricks_list_workspace でフォルダーとノートブックを参照し、databricks_export_notebook で小さなノートブックのソースコードを取得します。databricks_list_volume_files は Unity Catalog のボリュームを、databricks_list_dbfs は従来の DBFS パスを一覧します。クラスターの Spark 設定、環境変数、init スクリプトはシークレットを含む可能性があるため除外しています。

よくあるエラー: 401、または 403 Invalid access token: トークンが間違っている、期限切れ、取り消し済み、または DATABRICKS_HOST が別のワークスペースを指しています。403 PERMISSION_DENIED: ユーザーに USE CATALOG、SELECT、ウェアハウスの CAN USE、ジョブの CAN MANAGE RUN などの権限がありません。404 RESOURCE_DOES_NOT_EXIST: ID や名前が間違っているか、ワークスペースで Unity Catalog が有効になっていません。429: リクエストが多すぎます。少し待ってから再試行してください。

このコネクタは、クラスター、ウェアハウス、ジョブ、テーブル、ファイルの作成、編集、削除、ファイルのアップロード、Delta Live Tables パイプライン、MLflow、Model Serving、Genie、Vector Search には対応していません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Gemini にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう。Gemini CLI が Databricks のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「どんな SQL ウェアハウスがあって、今動いているのはどれですか？」
• 「main.sales のテーブルと、orders テーブルの列を見せてください。」
• 「先月の国別売上はいくらでしたか？サーバーレスウェアハウスを使い、起動が必要なら先に教えてください。」
• 「昨夜の nightly_etl ジョブは成功しましたか？失敗したタスクがあればエラーを見せてください。」
• 「weekly_report ジョブが何をするか、どのクラスターを使うかを説明してから、今すぐ実行してください。」

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続