Bitscale Ai

BitScale MCP Server

Model Context Protocol（MCP）経由で、BitScale のワークスペースを Claude に接続します。

セットアップ

1. uv をインストールする（一度のみ）

macOS / Linux

curl -LsSf https://astral.sh/uv/install.sh | sh
OR 
brew install uv

Windows

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

2. Claude Desktop の設定に追加する

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を開き、以下を追加します。

{
  "mcpServers": {
    "bitscale": {
      "command": "uvx",
      "args": ["bitscale-mcp"],
      "env": {
        "BITSCALE_API_KEY": "your_api_key_here"
      }
    }
  }
}

3. Claude Desktop を再起動する

これで完了です。クローンも pip install も不要です。uvx がパッケージを自動的に取得して実行します。

---

ツール

ツール	説明
get_workspace_details	ワークスペースのプラン、クレジット残高、検索上限、メンバー数を取得します
list_grids	オプションの検索とページネーションを指定して、すべてのグリッドを一覧表示し、列の定義を返します
get_grid_details	グリッドの完全なスキーマ（列、設定、データソース）を取得します
get_grid_curl	グリッドを実行するためのすぐに使える curl コマンドと API コントラクトを取得します。必要な入力を確認するため、最初に呼び出してください
run_grid	入力値を指定してグリッドを実行します。同期モードと非同期モードに対応しています
get_run_status	request_id を指定して、非同期またはタイムアウトしたグリッド実行のステータスを確認します
rotate_api_key	ワークスペースの API キーをローテーションします（取り消し不可。現在のキーは無効になります）

---

使用例

「BitScale のグリッドをすべて一覧表示して」

「Lead Enrichment グリッドの詳細を表示して」

「Lead Enrichment グリッドの curl コマンドを取得して」

「company_name に 'Acme Corp'、website に 'acme.com' を指定して Lead Enrichment グリッドを実行して」

「BitScale のグリッドを使って、Stripe の従業員の電話番号を探して」

「実行 550e8400-e29b-41d4-a716-446655440000 のステータスを確認して」

---

グリッド実行の仕組み

1. グリッドを確認する — list_grids を呼び出して、利用可能なグリッドとその ID を確認します。
2. API コントラクトを取得する — グリッド ID を指定して get_grid_curl を呼び出すと、必要な入力フィールド、整形済みのリクエスト本文、コピーして使える curl コマンドが取得できます。グリッドの実行前に必要な内容を把握するために、この方法を推奨します。
3. グリッドを実行する — グリッド ID と、値に対応する人が読めるラベルの inputs マップを指定して run_grid を呼び出します（get_grid_curl が返すラベルを使用します）。同期モード（デフォルト）では、120 秒以内に結果が直接返されます。非同期モードでは、確認に使用する request_id が返されます。
4. 必要に応じてステータスを確認する — 実行がまだ処理中の場合は、ステータスが completed になるまで、2～5 秒ごとに request_id を指定して get_run_status を呼び出します。

入力ラベルと出力列 UUID の違い

run_grid を使うときは、この違いが重要です。

• inputs — "company_name"、"website"、"email" のような人が読めるラベルを使用します。これらのラベルは、グリッドの BitScale API データソースに設定されているソース列から取得されます。列 UUID ではありません。BitScale アプリで「Data Source」列をクリックし、BitScale API ソースを選択すると、正確なラベルを確認できます。

  "inputs": {
    "company_name": "Acme Corp",
    "website": "acme.com"
  }
  

• output_columns — get_grid_details の列 UUID を使用して、レスポンスに含めるエンリッチ済み列を絞り込みます。

  "output_columns": [
    "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
    "6ba7b811-9dad-11d1-80b4-00c04fd430c8"
  ]
  

• レスポンスの outputs — 列 UUID をキーとし、それぞれが {value, name} を含みます。name は人が読める表示名です。

  "outputs": {
    "6ba7b810-9dad-11d1-80b4-00c04fd430c8": {
      "value": "AI-powered data enrichment platform",
      "name": "Company Description"
    }
  }
  

---

Claude Code

claude mcp add bitscale \
  --command uvx \
  --args bitscale-mcp \
  --env BITSCALE_API_KEY=your_api_key_here

---

API リファレンス

リクエストは https://api.bitscale.ai/api/v1 に送信され、X-API-KEY ヘッダーで認証されます。デフォルトのレート制限は、ワークスペースあたり 5 req/s です。

エンドポイント	メソッド	ツール
/workspace	GET	get_workspace_details
/grids	GET	list_grids
/grids/:gridId	GET	get_grid_details
/grids/:gridId/curl	GET	get_grid_curl
/grids/:gridId/run	POST	run_grid
/run/status/:requestId	GET	get_run_status
/api-key/rotate	POST	rotate_api_key

---

API キーのローテーション

rotate_api_key を呼び出すと、現在のキーは直ちに無効になり、新しいキーが返されます。ローテーション後は、設定内の BITSCALE_API_KEY を更新して、Claude Desktop を再起動してください。

---

ライセンス

MIT