Conectar NBB MCP con ChatGPT

💡 ¿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 + ChatGPT

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 ChatGPT

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.

ChatGPT añade servidores MCP como plugins desde su página Plugins, en la web y en los planes de pago. Ya no hace falta el modo desarrollador. En un espacio Business solo pueden hacerlo los administradores y propietarios; en Enterprise y Edu un administrador puede conceder el permiso Create plugins with MCPs.

1. Ve a chatgpt.com/plugins, pulsa Add y luego Add custom MCP server.
2. Escribe un nombre, por ejemplo Name: NBB Central Balance Sheet Office.
3. En Connection, introduce como Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID y deja Authentication en OAuth.
4. Selecciona I understand and want to continue y después Create as a plugin. Cuando ChatGPT lo pida, inicia sesión en AnythingMCP y permite el acceso.
5. Instala el nuevo plugin desde tus plugins personales; luego escribe @ en un chat y elígelo.

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

¿Funciona el plan gratuito de ChatGPT con servidores MCP personalizados? OpenAI documenta los servidores MCP personalizados solo para los planes de pago; el plan Free no aparece en su lista.

Siguientes pasos

• Página del conector
• Conectar a Claude