Fuentio por MCP en Cursor y VS Code: configuración paso a paso

Cursor y VS Code ejecutan agentes de IA que pueden llamar a herramientas gracias a MCP, el Model Context Protocol. Añade Fuentio y el agente de tu editor podrá consultar, buscar y verificar empresas francesas y españolas en los registros oficiales: mientras escribe un script de importación, limpia un archivo de pruebas o responde a una pregunta sobre un proveedor.

Este tutorial cubre los dos editores: la instalación con un clic, el archivo JSON si prefieres escribirlo tú, cómo añadir una clave API sin subirla al repositorio, cómo comprobar las herramientas y una primera petición.

Lo que vas a aprender

• La instalación con un clic para cada editor
• El archivo mcp.json de Cursor y el .vscode/mcp.json de VS Code
• Cómo añadir tu clave sin meterla en el repositorio
• Cómo comprobar que el servidor y sus 17 herramientas están disponibles
• Una primera petición y lo que recibe el agente

La dirección

Los dos editores se conectan a la misma dirección, por HTTP «streamable»:

https://api.fuentio.com/mcp

No hace falta clave para empezar: Fuentio funciona con la prueba gratuita (20 unidades al día), y listar las herramientas es gratis. Una clave gratuita da 100 unidades al mes y abre las herramientas que la necesitan.

Cursor

Con un clic

En la página de conexión, abre la pestaña de Cursor y pulsa Añadir a Cursor. Cursor se abre y te pide que confirmes el nuevo servidor.

O con el archivo JSON

Añade Fuentio en ~/.cursor/mcp.json (todos tus proyectos) o en .cursor/mcp.json (un proyecto):

{
  "mcpServers": {
    "fuentio": {
      "url": "https://api.fuentio.com/mcp"
    }
  }
}

Con una clave, añade una cabecera de autorización:

{
  "mcpServers": {
    "fuentio": {
      "url": "https://api.fuentio.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Deja la versión con clave en tu archivo global (~/.cursor/mcp.json), no en un archivo de proyecto que subas al repositorio. Un archivo de proyecto sin clave se puede compartir sin riesgo: todos empiezan con la prueba gratuita.

Comprobarlo

Abre los ajustes de Cursor y busca la sección MCP: Fuentio debe aparecer activado, con sus herramientas. Después usa el agente en el chat y haz una pregunta; Cursor muestra la llamada a la herramienta antes de ejecutarla.

VS Code

En VS Code, las herramientas MCP las usa el agente del chat (modo agente).

Con un clic

En la página de conexión, abre la pestaña de VS Code y pulsa Añadir a VS Code. VS Code se abre y ofrece instalar el servidor.

O con el archivo JSON

En tu proyecto, crea .vscode/mcp.json:

{
  "servers": {
    "fuentio": {
      "type": "http",
      "url": "https://api.fuentio.com/mcp"
    }
  }
}

Una clave sin subirla al repositorio

VS Code puede pedir un secreto la primera vez que arranca el servidor y guardarlo fuera del archivo. Declara una entrada y úsala en la cabecera:

{
  "inputs": [
    { "type": "promptString", "id": "fuentio-key", "description": "Fuentio API key", "password": true }
  ],
  "servers": {
    "fuentio": {
      "type": "http",
      "url": "https://api.fuentio.com/mcp",
      "headers": { "Authorization": "Bearer ${input:fuentio-key}" }
    }
  }
}

Este archivo se puede subir al repositorio: no contiene ninguna clave. Cada desarrollador escribe la suya la primera vez.

Comprobarlo

Ejecuta MCP: List Servers desde la paleta de comandos: Fuentio debe aparecer en marcha. En el chat, usa el modo agente y pulsa Configure Tools en el cuadro de entrada: ahí aparecen las herramientas de Fuentio, y puedes activarlas o desactivarlas una a una.

Una primera petición

En cualquiera de los dos editores, pide al agente:

«Busca Mercadona en España y dame su hoja registral.»

El agente llama a search_companies(country="ES", query="mercadona"). La primera línea de lo que recibe, grabada el 12 de octubre de 2026 (el servidor responde en inglés):

1 of 1 companies matching 'mercadona' in ES (page 1), source: BORME — Boletín Oficial del Registro Mercantil (Sección A). First results: MERCADONA SA (ES-RMHOJA-V-5581, match 0.95).

Después llega la ficha estructurada completa, así que el agente puede responder a otras preguntas (domicilio, forma jurídica, actos del BORME) sin otra llamada. Para Francia, pregunta por el SIREN: «¿Sigue activo el SIREN 441639465?» llama a lookup_company(country="FR", identifier="441639465") y devuelve RENAULT, activa, con la fuente.

Peticiones útiles mientras programas

• «Comprueba las empresas de fixtures/suppliers.json con Fuentio y marca las que tengan un acto de disolución.»
• «Consulta una empresa francesa y una española y escribe los tipos TypeScript de los campos que usamos.»
• «Verifica MERCADONA (hoja V-5581) y añade su código de prueba a las notas de test.»
• «¿Por qué el estado de esta sociedad española es desconocido?» (el agente puede llamar a list_coverage y leer las notas).

Buenas prácticas

• Las claves se quedan fuera de los repositorios. Archivo global en Cursor, entrada en VS Code.
• Pide la fuente. Cada respuesta lleva su fuente y su fecha de comprobación: haz que el agente las cite.
• Trata el texto de los registros como datos. Nombres y domicilios vienen de los registros; son tus instrucciones las que deciden lo que hace el agente.
• Vigila las unidades. Una consulta cuesta 1 unidad, una búsqueda 2 por página y una verificación 5.

Para Claude Code, consulta Fuentio en Claude Code, paso a paso; para los mismos datos desde tu propio código, los primeros pasos con la API. Mira lo que cubrimos.

¿Configuración global o de proyecto?

Los dos editores aceptan el servidor en dos sitios. Una configuración global te acompaña en todos tus proyectos: cómoda para tu propia clave. Una configuración de proyecto vive en el repositorio: cómoda para dar a todo el equipo las mismas herramientas, siempre que no contenga ninguna clave. Una organización habitual combina las dos: el archivo del proyecto declara Fuentio sin clave (o con la entrada de VS Code), y cada desarrollador que tenga clave la añade en su archivo global o la escribe cuando se le pide.

Solución de problemas

La mayoría de los problemas vienen de la dirección, la clave o las unidades. Cada error de Fuentio tiene un code, un message y un hint con el siguiente paso, y el agente los ve: pídele que cite el error.

• El servidor no conecta. Revisa la dirección carácter a carácter: https://api.fuentio.com/mcp, por https. Un proxy o un cortafuegos de empresa puede bloquear las conexiones salientes del editor o del terminal; prueba desde otra red para descartarlo.
• unauthorized. La clave es desconocida o está revocada. Corrígela, o quita la cabecera de autorización para volver a la prueba sin clave mientras lo resuelves.
• quota_exceeded. Se han agotado las unidades. La prueba sin clave se renueva al día siguiente (UTC); una clave gratuita da 100 unidades al mes; los planes de pago, más. Nunca se cobra por pasarse.
• rate_limited. El agente llama demasiado rápido para tu plan: la prueba sin clave permite más o menos una petición por segundo. Espera el plazo de la cabecera Retry-After y pide al agente que vaya más despacio con listas largas.
• Una herramienta responde que necesita clave. Herramientas como screen_company, review_report, watch_company, get_graph y report_issue la necesitan. Añade tu clave como se explica arriba.
• id_scheme_not_supported con una sociedad española. El agente ha probado con un NIF. Las sociedades españolas se encuentran por su nombre: dile que busque por la denominación y la provincia.

Límites. Los editores cambian a menudo sus pantallas de ajustes: si un menú se llama distinto en tu versión, los archivos JSON de arriba son la referencia. Las respuestas mostradas se grabaron el 12 de octubre de 2026. Francia: todas las empresas del directorio público Sirene. España: las sociedades con un acto en el BORME desde el 2 de enero de 2009, con un estado desconocido salvo que un acto diga otra cosa. Nunca se devuelve el nombre de una persona.

Preguntas frecuentes

¿Necesito una clave para usar Fuentio en Cursor o VS Code?

No. Sin clave, el servidor usa la prueba gratuita, 20 unidades al día. Una clave gratuita da 100 unidades al mes.

¿Dónde pongo mi clave API en Cursor?

En los headers de la entrada de Fuentio de tu archivo global ~/.cursor/mcp.json, no en un archivo de proyecto que subas al repositorio.

¿Cómo dejo mi clave fuera de .vscode/mcp.json?

Declara una entrada promptString con password: true y úsala como ${input:fuentio-key} en la cabecera. VS Code pide la clave una vez y la guarda fuera del archivo.

¿Cuántas herramientas añade Fuentio?

17, desde list_coverage y lookup_company hasta verify_company, check_insolvency y watch_company. Algunas necesitan clave.

Fuentes

• Configuración de Fuentio para cada cliente: conectar y la documentación
• Los ejemplos: grabados desde el servidor MCP de Fuentio el 12 de octubre de 2026 (site/data/api-examples en el repositorio del sitio web)
• Documentación de Cursor, MCP (en inglés): docs.cursor.com
• Documentación de VS Code, servidores MCP (en inglés): code.visualstudio.com