MCP de filings.es: el Registro Mercantil en tu asistente

1. 1

   Descarga el archivo de instalación

   filings-es.mcpb3 Mo
2. 2

   Haz doble clic en el archivo

   Claude Desktop se abre y muestra la ventana de instalación. Si no pasa nada, ve a Settings → Extensions → Install Extension, o arrastra el archivo sobre la ventana de ajustes.
3. 3

   Pega tu clave cuando Claude la pida

   Se queda en tu equipo: nunca pasa por esta página.
4. 4

   Comprueba

   En una conversación, pregunta «¿Quién administra la empresa B54226691?». Claude debe responder SOLER BULILLA SL.

1. 1

   Abre Customize y luego Connectors

   El plan gratis permite un conector; los de pago no tienen límite. En Team y Enterprise solo un propietario puede añadirlos.
2. 2

   Pulsa «+» y luego «Add custom connector»

   Deja los ajustes avanzados vacíos: este servidor no usa OAuth.
3. 3

   Pega esta dirección y pulsa «Add»

   https://api.filings.es/mcp?apikey=TU_CLAVE Copiar
4. 4

   Actívalo en la conversación

   Es el paso que se olvida: un conector añadido no está activo en ninguna conversación. Pulsa el «+» abajo a la izquierda del cuadro de texto, luego «Connectors», y activa filings-es.

1. 1

   Abre un terminal

   Donde sea: «--scope user» abajo guarda el servidor para todos tus proyectos. Sin esa opción, solo se añadiría a la carpeta actual.
2. 2

   Ejecuta este comando

   claude mcp add --transport http filings-es --scope user https://api.filings.es/mcp --header "X-Api-Key: TU_CLAVE" Copiar
3. 3

   Comprueba

   claude mcp get filings-es Copiar

   El servidor debe aparecer como conectado. El comando /mcp, dentro de una sesión, lista las 19 herramientas.

1. 1

   Activa el modo desarrollador

   Settings → Connectors → Advanced → Developer Mode. Mientras esté apagado, no aparece ninguna opción de conector personalizado — es la causa número uno de las instalaciones fallidas.
2. 2

   Pulsa «Create»

   Llámalo filings-es y pega la dirección de abajo como URL del servidor.

   https://api.filings.es/mcp?apikey=TU_CLAVE Copiar
3. 3

   Marca «I trust this provider» y pulsa «Create»

   La casilla es obligatoria, el botón sigue inactivo sin ella.
4. 4

   Actívalo en cada conversación

   Pulsa «+» en el cuadro de texto, luego «More», luego «Developer Mode», y selecciona filings-es. Hay que repetirlo en cada conversación nueva.

Para integrar el registro en tu propio producto. Sin interfaz, sin modo desarrollador: el servidor se declara como una herramienta y el modelo decide solo cuándo llamarla.

1. 1

   Instala la biblioteca

   pip install openai Copiar
2. 2

   Declara el servidor y haz tu pregunta

   from openai import OpenAI client = OpenAI() resp = client.responses.create( model="gpt-5", tools=[{ "type": "mcp", "server_label": "filings_es", "server_url": "https://api.filings.es/mcp", "headers": {"X-Api-Key": "TU_CLAVE"}, "require_approval": "never", }], input="¿Quién administra la empresa con NIF B54226691?", ) print(resp.output_text) Copiar
3. 3

   Lo que debes obtener

   Una respuesta en texto citando SOLER BULILLA SL. Para validar cada llamada antes de que salga, cambia «never» por «always». Para limitar el modelo a ciertas herramientas, añade «allowed_tools».

1. 1

   Abre la página Connectors

   Añadir un conector es cosa del administrador. En los planes Free, Pro y Student, es el titular de la cuenta.
2. 2

   «+ Add Connector», pestaña «Custom MCP Connector»

   Como nombre, escribe filings-es sin espacios ni acentos: el campo los rechaza.
3. 3

   Pega la dirección DESNUDA, sin clave

   https://api.filings.es/mcp Copiar

   Le Chat detecta la autenticación por sí mismo: pulsa «Connect», elige el token Bearer y pega tu clave en el formulario. Es más limpio que una clave en la URL.

4. 4

   Selecciónalo y pruébalo

   El conector aparece en el menú de herramientas. Pregunta «¿Quién administra la empresa B54226691?»: la respuesta debe citar SOLER BULILLA SL.

1. 1

   Abre el archivo correcto

   ~/.cursor/mcp.json para todos tus proyectos, o .cursor/mcp.json en la raíz de un proyecto para ese proyecto solo. Los demás editores leen el mismo formato.
2. 2

   Pega esta configuración

   { "mcpServers": { "filings-es": { "url": "https://api.filings.es/mcp", "headers": { "X-Api-Key": "TU_CLAVE" } } } } Copiar
3. 3

   Reinicia el editor

   La mayoría solo relee su configuración al arrancar. En Cursor, el servidor se activa luego desde Customize, en la barra lateral.