Conectar NBB MCP con Gemini CLI

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → NBB Central Balance Sheet Office, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

NBB Central Balance Sheet Office + Gemini

Cuentas anuales belgas de la Central de Balances del Banco Nacional de Bélgica (servicio web de datos auténticos): lista todas las cuentas anuales que una empresa ha depositado por número de empresa, lee los datos de referencia de un depósito y obtiene sus datos contables en JSON-XBRL o XBRL o el PDF publicado. Solo lectura.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

NBB_CBSO_SUBSCRIPTION_KEY

Paso 1 — Obtener credenciales

La configuración lleva unos minutos una vez que el NBB ha aprobado tus suscripciones. Necesitas una suscripción a los servicios web de la NBB CBSO y una cuenta en el portal para desarrolladores de la CBSO con una suscripción aprobada al producto NBB CBSO Web Services - Authentic Data.

1. Suscríbete a los servicios web de la CBSO con el formulario de suscripción de nbb.be (Central Balance Sheet Office, productos). El NBB te envía un CLIENT_ID para tu usuario técnico; el conector solo necesita la subscription key de los pasos siguientes.
2. Regístrate en el portal para desarrolladores developer.cbso.nbb.be, abre Products y suscríbete a NBB CBSO Web Services - Authentic Data. El NBB aprueba la solicitud.
3. Abre tu Profile en el portal y copia la primary key de la suscripción Authentic Data en NBB_CBSO_SUBSCRIPTION_KEY (la secondary key también sirve; solo letras y dígitos). El conector la envía en la cabecera NBB-CBSO-Subscription-Key.
4. Instala el conector y comprueba la conexión con nbb_cbso_list_annual_accounts para el número de empresa 0203201340, que es el propio NBB.

Cloud y self-hosted funcionan igual: el conector solo necesita la subscription key; no hay nada más que configurar.

Números de empresa y de referencia: el número de empresa es el número de 10 dígitos del Banco-Cruce de Empresas (KBO/BCE), sin puntos ni el prefijo BE: 0203201340 para BE 0203.201.340. Cada depósito tiene su propio número de referencia, como 2023-00123456, en el campo ReferenceNumber de la lista. year es el año en que termina el ejercicio y no puede ser posterior al año en curso.

Las correcciones sustituyen al depósito inicial: un ejercicio puede tener un depósito inicial y una corrección (DepositType). Usa el depósito más reciente de cada ejercicio y comprueba qué fechas de ejercicio cubren las cifras.

Cifras solo para cuentas normalizadas: nbb_cbso_get_annual_account_data devuelve JSON-XBRL por defecto, o XBRL, con los códigos de rúbrica del esquema belga: por ejemplo 10/15 patrimonio neto, 70 cifra de negocios, 9904 resultado del ejercicio y 9087 número medio de trabajadores en equivalentes a tiempo completo. Las cuentas no normalizadas solo existen en PDF; nbb_cbso_get_annual_account_pdf sirve para ambas.

Archivos adjuntos: JSON-XBRL y XBRL pueden llegar como archivo adjunto en lugar de texto; el PDF llega siempre así. Los depósitos grandes pueden superar el límite de 10 MB para adjuntos.

Ids de solicitud: cada llamada lleva un X-Request-Id, un UUID de versión 4 para la trazabilidad. Las herramientas ponen uno; con request_id puedes pasar el tuyo.

Errores frecuentes: el NBB responde con un problem JSON (title, status, violations). 400 significa un número de empresa o de referencia mal formado o un año futuro, 401 una subscription key ausente o incorrecta, 403 una key cuya suscripción no cubre el producto Authentic Data o aún no está aprobada, 404 que no se ha encontrado nada y 429 demasiadas llamadas.

No incluido: el archivo histórico, los extractos (lotes diarios en zip) y los productos de datos mejorados (improved data) del NBB requieren suscripciones aparte y no están disponibles aquí. Las empresas exentas de publicación no tienen documentos públicos.

Qué lee: las cuentas anuales que las empresas y asociaciones belgas depositaron en la Central de Balances y que el NBB aceptó. De cada depósito: fecha de depósito, fechas de inicio y fin del ejercicio, modelo (completo, abreviado, micro o un modelo de asociación), tipo de depósito, idioma y moneda, además del nombre, la dirección, la forma jurídica, la situación jurídica, el código de actividad y la fecha de la junta general de la empresa. También los datos contables (balance, cuenta de resultados, memoria y balance social) en JSON-XBRL o XBRL y la cuenta anual publicada en PDF.

Solo lectura: las cuatro herramientas solo leen. No se deposita, corrige ni modifica nada en el NBB.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de NBB Central Balance Sheet Office.

Herramientas disponibles

Ejemplos de prompts

• "Lista todas las cuentas anuales que ha depositado la empresa 0203.201.340, con las fechas del ejercicio, la fecha de depósito y el modelo."
• "¿Cuánto eran el patrimonio neto, la cifra de negocios y el resultado del ejercicio en la última cuenta anual de la empresa 0203201340, y qué ejercicio cubren?"
• "¿Qué forma jurídica, dirección y código de actividad figuran en el último depósito, y cuándo se celebró la junta general?"
• "¿Cómo ha evolucionado el número medio de trabajadores en equivalentes a tiempo completo en las tres últimas cuentas anuales de esta empresa?"
• "Descárgame el PDF publicado de la cuenta anual más reciente de la empresa."

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude