Bitscale Ai

BitScale MCP 服务

通过 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 契约——调用 get_grid_curl 并传入网格 ID，以获取所需的确切输入字段、格式化的请求正文以及可直接复制粘贴的 curl 命令。建议通过此方式了解运行网格所需的内容。
3. 运行网格——调用 run_grid 并传入网格 ID，以及由值组成的 inputs 映射，其中键为易读标签（由 get_grid_curl 返回）。在同步模式（默认）下，结果会在 120 秒内直接返回。在异步模式下，你会获得一个 request_id，用于查询运行状态。
4. 按需查询状态——如果运行仍在处理中，每隔 2-5 秒调用一次 get_run_status 并传入 request_id，直到状态变为 completed。

输入标签与输出列 UUID

使用 run_grid 时，需要区分以下内容：

• inputs——使用 "company_name"、"website"、"email" 等易读标签。这些标签源自网格 BitScale API 数据源中配置的源列。它们不是列 UUID。你可以在 BitScale 应用中点击“数据源”列 → BitScale API source，找到确切的标签。

  "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