Bitscale AI

Orquestación GTM B2B y Enriquecimiento de Datos

GitHub

Prueba este MCPPatrocinado

Documentación

Servidor MCP de BitScale

Conecta tu espacio de trabajo de BitScale a Claude mediante el Model Context Protocol (MCP).

Configuración

1. Instalar `uv` (una sola 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. Añadir a la configuración de Claude Desktop

Abre ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows) y añade:

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

3. Reiniciar Claude Desktop

Eso es todo. Sin clonar, sin pip install — uvx descarga y ejecuta el paquete automáticamente.

Herramientas

Herramienta	Descripción
`get_workspace_details`	Obtén el plan del espacio de trabajo, saldos de créditos, límites de búsqueda y recuentos de miembros
`list_grids`	Lista todas las cuadrículas con búsqueda y paginación opcionales, devuelve definiciones de columnas
`get_grid_details`	Obtén el esquema completo de una cuadrícula: columnas, configuraciones y fuentes de datos
`get_grid_curl`	Obtén un comando curl listo para usar y el contrato de API para ejecutar una cuadrícula: llama a esto primero para descubrir las entradas requeridas
`run_grid`	Ejecuta una cuadrícula proporcionando valores de entrada, admite modos síncrono y asíncrono
`get_run_status`	Consulta el estado de una ejecución de cuadrícula asíncrona o con tiempo agotado mediante request_id
`rotate_api_key`	Rota la clave de API del espacio de trabajo (irreversible, invalida la clave actual)

Ejemplos de uso

"Lista todas mis cuadrículas de BitScale"

"Muéstrame los detalles de la cuadrícula de enriquecimiento de leads"

"Obtén el comando curl para la cuadrícula de enriquecimiento de leads"

"Ejecuta la cuadrícula de enriquecimiento de leads con company_name 'Acme Corp' y website 'acme.com'"

"Encuentra números de teléfono de personas en Stripe usando mi cuadrícula de BitScale"

"Comprueba el estado de la ejecución 550e8400-e29b-41d4-a716-446655440000"

Cómo funcionan las ejecuciones de cuadrículas

Descubre cuadrículas — llama a list_grids para encontrar cuadrículas disponibles y sus IDs.
Obtén el contrato de API — llama a get_grid_curl con el ID de la cuadrícula para obtener los campos de entrada exactos requeridos, un cuerpo de solicitud con forma y un comando curl para copiar y pegar. Esta es la forma recomendada de entender qué necesita una cuadrícula antes de ejecutarla.
Ejecuta la cuadrícula — llama a run_grid con el ID de la cuadrícula y un mapa inputs de etiquetas legibles por humanos a valores (tal como las devuelve get_grid_curl). En modo síncrono (por defecto), los resultados se devuelven directamente en 120 segundos. En modo asíncrono, obtienes un request_id para consultar.
Consulta si es necesario — si la ejecución aún está procesándose, llama a get_run_status con el request_id cada 2-5 segundos hasta que el estado sea completed.

Etiquetas de entrada vs UUIDs de columnas de salida

Esta es una distinción importante al usar run_grid:

inputs — usa etiquetas legibles por humanos como "company_name", "website", "email". Estas etiquetas se derivan de las columnas de origen configuradas en la fuente de datos de la API de BitScale de la cuadrícula. No son UUIDs de columnas. Puedes encontrar las etiquetas exactas en la aplicación de BitScale haciendo clic en la columna Fuente de datos → fuente de API de BitScale.
```
"inputs": {
  "company_name": "Acme Corp",
  "website": "acme.com"
}
```
output_columns — usa UUIDs de columnas de get_grid_details para filtrar qué columnas enriquecidas aparecen en la respuesta.
```
"output_columns": [
  "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
  "6ba7b811-9dad-11d1-80b4-00c04fd430c8"
]
```

outputs de respuesta — clave por UUIDs de columnas, cada una contiene {value, name} donde name es el nombre de visualización legible 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

Referencia de API

Las solicitudes llegan a https://api.bitscale.ai/api/v1, autenticadas mediante el encabezado X-API-KEY. Límite de velocidad por defecto: 5 req/s por espacio de trabajo.

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

Rotación de clave de API

Llamar a rotate_api_key invalida inmediatamente la clave actual y devuelve una nueva. Actualiza BITSCALE_API_KEY en tu configuración y reinicia Claude Desktop después de rotar.

Licencia

MIT