Base de datos · MCP
Los datos de Bull Market,
en tu asistente.
Conectá Codex, Claude o Cursor para explorar tablas y consultar información con lenguaje natural. El acceso a la base es de solo lectura.
https://ai-internal.bullmarketbrokers.com/mcp
Tu credencial
Podés pegarla acá para completar los ejemplos o reemplazar TU_API_KEY manualmente. Esta página no
envía la clave a ningún servidor ni la guarda en el navegador.
Los bloques y archivos que copies contienen tu credencial. Guardalos solo en tu configuración personal; no los compartas ni los subas a Git.
La clave debe tener al menos 32 caracteres, sin espacios. Copiala completa.
Elegí dónde conectarte
Codex · aplicación, CLI y extensión
-
Abrí tu archivo personal
~/.codex/config.toml(en Windows:%USERPROFILE%\.codex\config.toml). - Agregá este bloque al final. Si ya existe
bmb-bd, reemplazá ese bloque sin duplicarlo. - Guardá y reiniciá Codex. En la CLI, ejecutá
codex mcp listy revisá/mcp.
Se usa un header estático para que funcione también al abrir la app desde el escritorio. No necesitás iniciar sesión OAuth.
Alternativa CLI: clave en variable de entorno
Definí BMB_MCP_API_KEY en la terminal desde la que iniciás Codex. En macOS/Linux:
export BMB_MCP_API_KEY='TU_API_KEY'. En PowerShell:
$env:BMB_MCP_API_KEY='TU_API_KEY'. Luego:
codex mcp add bmb-bd --url https://ai-internal.bullmarketbrokers.com/mcp --bearer-token-env-var BMB_MCP_API_KEYUsá esta alternativa en lugar del bloque con header. La variable debe estar disponible en cada inicio; una app abierta desde el escritorio puede no heredarla.
Claude Code · terminal
-
Con Claude Code instalado, ejecutá el comando siguiente. La configuración es personal (
--scope user). - Reiniciá la sesión y abrí
/mcppara comprobar la conexión.
El comando puede quedar en el historial de la terminal. Si ya existe bmb-bd, quitá esa entrada
con claude mcp remove --scope user bmb-bd antes de volver a agregarla.
Cursor · configuración personal
-
Abrí Settings → Tools & MCP y agregá un servidor, o editá
~/.cursor/mcp.json(Windows:%USERPROFILE%\.cursor\mcp.json). -
Agregá
bmb-bddentro de tu objetomcpServers. Si ya tenés otros servidores, conservá sus entradas. - Guardá, activá el servidor y abrí un chat en modo Agent.
Para usar una variable de entorno, reemplazá el valor del header por
Bearer ${env:BMB_MCP_API_KEY} e iniciá Cursor con esa variable disponible.
Claude Desktop · puente local
Esta alternativa permite usar la API key aunque tu cuenta no tenga la opción Request headers. Instalá Node.js 22.12 o superior (recomendado: 24 LTS) en tu computadora.
- En Claude Desktop, abrí Settings → Developer → Edit Config.
- Agregá esta entrada en
claude_desktop_config.json, conservando otros servidores. -
Cerrá completamente Claude y volvé a abrirlo. Habilitá
bmb-bden los conectores del chat.
El primer inicio descarga mcp-remote@0.14.3 desde npm. Si Claude no encuentra npx,
usá la ruta completa obtenida con which npx o where npx. Tu organización debe
permitir servidores locales.
El puente funciona en Claude Desktop en tu computadora. No habilita el conector en claude.ai ni en el celular.
Claude web · conector remoto
La autenticación con Request headers está en beta y disponible solo para algunas organizaciones. Si esa sección no aparece, usá Claude Desktop con el puente local o Claude Code. Este servidor no implementa OAuth.
- Abrí Customize → Connectors → Add custom connector. En Team/Enterprise, un administrador debe agregarlo desde la configuración de la organización.
- Usá el nombre
BMB Databasey la dirección del servidor que figura arriba. -
En Authentication seleccioná No sign-in y en Request headers agregá
Authorizationcomo requerido, con el valor completo de abajo. - Guardá y habilitá el conector en la conversación. Aunque la interfaz diga No sign-in, el servidor exige la API key en cada petición.
Claude se conecta desde la infraestructura de Anthropic: la dirección debe ser accesible desde allí. En un conector de organización, la credencial configurada puede ser compartida por sus miembros.
Tu primera consulta
En un chat nuevo, probá con este mensaje:
Usá el MCP bmb-bd. Buscá tablas sobre órdenes con search_schema (query: "órdenes", target: "tables", limit: 20). Si hay más resultados, continuá con nextOffset. Después mostrame las columnas de Orders con describe_table. Antes de armar una consulta, verificá los nombres y tipos reales de las columnas.search_schemaBuscar tablas y columnas por nombre o tema, con páginas de hasta 50 resultados.analyze_schemaResumen parcial del esquema por dominio.list_tablesTablas disponibles.describe_tableColumnas y tipos.suggest_queriesConsultas SQL de ejemplo.run_queryConsultas de solo lectura.database_healthEstado de la conexión.Por defecto: hasta 1.000 filas por consulta y 15 segundos de ejecución. Si el resultado alcanza el límite aplicado por el servidor, puede estar incompleto. La API key permite acceder a datos reales: compartila solo con personas autorizadas.
Si algo no conecta
401 · La API key no fue aceptada
Comprobá que copiaste toda la clave y que el header diga Authorization: Bearer TU_API_KEY. Si
el administrador rotó la clave, actualizala y reiniciá el cliente.
403 · Host, origen o permisos
Usá exactamente el dominio y la ruta indicados. Pedile al administrador que revise la lista de hosts/orígenes permitidos o los permisos de tu credencial.
404 · La sesión expiró
Reconectá el servidor o reiniciá la aplicación. Las sesiones vencen después de 30 minutos sin actividad y se reinician en cada despliegue.
503 · Sin disponibilidad
El servicio puede estar sin conexión a la base o haber alcanzado su máximo de sesiones. Volvé a intentar y avisale al administrador si continúa.
No aparecen herramientas en Claude web
Verificá si tenés la sección Request headers y si el conector está habilitado. Una configuración local de Claude Desktop no se sincroniza con Claude web.