Bitscale AI

Orquestração GTM B2B e Enriquecimento de Dados

GitHub

Experimente este MCPPatrocinado

Documentação

Servidor MCP BitScale

Conecte seu workspace BitScale ao Claude via o Model Context Protocol (MCP).

Configuração

1. Instale `uv` (uma vez)

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. Adicione à configuração do Claude Desktop

Abra ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows) e adicione:

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

3. Reinicie o Claude Desktop

É isso. Sem clonagem, sem pip install — uvx baixa e executa o pacote automaticamente.

Ferramentas

Ferramenta	Descrição
`get_workspace_details`	Obtenha o plano do workspace, saldos de créditos, limites de pesquisa e contagens de membros
`list_grids`	Liste todos os grids com pesquisa e paginação opcionais, retorna definições de colunas
`get_grid_details`	Obtenha o esquema completo de um grid — colunas, configurações e fontes de dados
`get_grid_curl`	Obtenha um comando curl pronto para uso e o contrato de API para executar um grid — chame isso primeiro para descobrir as entradas necessárias
`run_grid`	Execute um grid fornecendo valores de entrada, suporta modos síncrono e assíncrono
`get_run_status`	Consulte o status de uma execução de grid assíncrona ou com tempo esgotado pelo request_id
`rotate_api_key`	Gire a chave de API do workspace (irreversível, invalida a chave atual)

Exemplos de Uso

"Liste todos os meus grids do BitScale"

"Mostre-me os detalhes do grid Lead Enrichment"

"Obtenha o comando curl para o grid Lead Enrichment"

"Execute o grid Lead Enrichment com company_name 'Acme Corp' e website 'acme.com'"

"Encontre números de telefone para pessoas na Stripe usando meu grid do BitScale"

"Verifique o status da execução 550e8400-e29b-41d4-a716-446655440000"

Como Funcionam as Execuções de Grid

Descubra grids — chame list_grids para encontrar grids disponíveis e seus IDs.
Obtenha o contrato de API — chame get_grid_curl com o ID do grid para obter os campos de entrada exatos necessários, um corpo de requisição formatado e um comando curl para copiar e colar. Esta é a maneira recomendada de entender o que um grid precisa antes de executá-lo.
Execute o grid — chame run_grid com o ID do grid e um mapa inputs de rótulos legíveis por humanos para valores (conforme retornado por get_grid_curl). No modo síncrono (padrão), os resultados retornam diretamente em até 120 segundos. No modo assíncrono, você obtém um request_id para consultar.
Consulte se necessário — se a execução ainda estiver processando, chame get_run_status com o request_id a cada 2-5 segundos até que o status seja completed.

Rótulos de Entrada vs UUIDs de Colunas de Saída

Esta é uma distinção importante ao usar run_grid:

inputs — usa rótulos legíveis por humanos como "company_name", "website", "email". Esses rótulos são derivados das colunas de origem configuradas na fonte de dados da API BitScale do grid. Eles não são UUIDs de colunas. Você pode encontrar os rótulos exatos no aplicativo BitScale clicando na coluna Data Source → fonte da API BitScale.
```
"inputs": {
  "company_name": "Acme Corp",
  "website": "acme.com"
}
```
output_columns — usa UUIDs de colunas de get_grid_details para filtrar quais colunas enriquecidas aparecem na resposta.
```
"output_columns": [
  "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
  "6ba7b811-9dad-11d1-80b4-00c04fd430c8"
]
```

Resposta outputs — chaveada por UUIDs de colunas, cada um contendo {value, name} onde name é o nome de exibição legível por humanos.

"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

Referência da API

As requisições atingem https://api.bitscale.ai/api/v1, autenticadas via cabeçalho X-API-KEY. Limite de taxa padrão: 5 req/s por workspace.

Endpoint	Método	Ferramenta
`/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`

Rotação da Chave de API

Chamar rotate_api_key invalida imediatamente a chave atual e retorna uma nova. Atualize BITSCALE_API_KEY na sua configuração e reinicie o Claude Desktop após a rotação.

Licença

MIT