Fuentio en Claude Code: configurar el servidor MCP paso a paso y comprobar tus primeras empresas

Claude Code puede llamar a herramientas externas gracias a MCP, el Model Context Protocol. Conecta Fuentio y podrá consultar, buscar y verificar empresas francesas y españolas en los registros oficiales mientras trabaja: revisar una lista de proveedores que estás importando, escribir una integración a partir de respuestas reales o responder a «¿sigue activa esta empresa?» sin salir del terminal.

Este tutorial cubre la configuración con un comando, cómo añadir una clave, cómo compartir el servidor con tu equipo sin exponer la clave, cómo comprobar que funciona y unas primeras peticiones con las respuestas que obtendrás.

Lo que vas a aprender

• Cómo añadir Fuentio a Claude Code, con o sin clave API
• Cómo compartir la configuración con tu equipo de forma segura
• Cómo comprobar que el servidor y sus herramientas están disponibles
• Las primeras peticiones y lo que recibe Claude Code
• Usos prácticos mientras programas

Paso 1: añade el servidor

Un solo comando, sin clave para empezar:

claude mcp add --transport http fuentio https://api.fuentio.com/mcp

Eso es todo. Sin clave, Fuentio funciona con la prueba gratuita: 20 unidades al día, suficiente para probar. Listar las herramientas es gratis.

Paso 2: añade tu clave (opcional)

Una clave gratuita da 100 unidades al mes y abre las herramientas que la necesitan (cribado de sanciones, informe de revisión, vigilancias, grupo de empresas). Consíguela en la página de precios y añade el servidor con una cabecera de autorización:

claude mcp add --transport http fuentio https://api.fuentio.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Si ya lo habías añadido sin clave, quítalo primero con claude mcp remove fuentio y vuelve a añadirlo.

Paso 3: compártelo con tu equipo (sin la clave)

Por defecto, un servidor se añade para ti, en el proyecto actual. Para compartirlo con todo el equipo que trabaja en el repositorio, añádelo con el ámbito de proyecto: Claude Code lo escribe en un archivo .mcp.json en la raíz del proyecto, que puedes subir al repositorio.

claude mcp add --transport http fuentio https://api.fuentio.com/mcp --scope project

Nunca subas una clave en ese archivo. Deja la clave fuera (todos empiezan con la prueba gratuita), o haz que cada desarrollador use su propia clave mediante una variable de entorno, por ejemplo FUENTIO_API_KEY, que Claude Code sustituye en .mcp.json.

Paso 4: comprueba que funciona

Desde tu terminal:

claude mcp list

Fuentio debe aparecer conectado. Dentro de Claude Code, escribe /mcp para ver el servidor y sus herramientas. Deberías ver 17 herramientas, entre ellas list_coverage, search_companies, lookup_company, verify_company, check_insolvency, check_address y check_vat.

La primera vez que Claude Code quiera llamar a una herramienta de Fuentio, te pedirá permiso. Concédelo para la sesión, o de forma permanente para herramientas de lectura como lookup_company.

Paso 5: primeras peticiones

Pregunta con naturalidad; Claude Code elige la herramienta.

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

Claude Code llama a search_companies(country="ES", query="mercadona"). La primera línea de la respuesta 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 (domicilio, forma jurídica, actos del BORME, procedencia), así que Claude Code puede responder a otras preguntas sin una nueva llamada.

«¿Sigue activo el SIREN 441639465? Cita la fuente.»

Claude Code llama a lookup_company(country="FR", identifier="441639465"):

RENAULT (FR, SIREN 441639465) is active as of 2025-12-06, source: Annuaire des Entreprises (API Recherche d'entreprises).

«Verifica DANONE, SIREN 552032534, y dame el código de prueba.»

Claude Code llama a verify_company(country="FR", identifier="552032534"):

DANONE (FR, SIREN 552032534): verified, active per Annuaire des Entreprises (API Recherche d'entreprises), checked 2026-10-12. Proof FUE-FR-20261012-ABAT38.

Cualquiera puede comprobar ese código en la página de pruebas, sin clave.

Usos prácticos mientras programas

• Limpiar un archivo de proveedores. «Lee suppliers.csv, busca cada empresa con Fuentio y añade el estado, el domicilio y la fuente en una columna nueva.» Claude Code hace las consultas y escribe el archivo. Vigila tus unidades: 1 por consulta, 2 por página de búsqueda.
• Escribir una integración con respuestas reales. «Consulta una empresa francesa y una española con Fuentio y escribe un cliente tipado para los campos que usamos.» La estructura real es mejor que una adivinada.
• Entender una respuesta sorprendente. «¿Por qué el estado de esta sociedad española es desconocido?» Claude Code puede llamar a list_coverage y leer las notas de cobertura: el BORME publica actos, no un estado actualizado.
• Preparar datos de prueba. Pide una verificación y guarda la respuesta como dato de prueba, con su código.

Para la parte REST de los mismos datos, consulta los primeros pasos con la API; para un agente que compruebe proveedores por sí solo, consulta crear un agente de comprobación de proveedores. Los demás clientes están en Fuentio por MCP en Cursor y VS Code, y todas las líneas de configuración en /connect/.

Buenas prácticas

• Trata el texto de los registros como datos. Los nombres y domicilios se copian de los registros. Son tus peticiones, no los datos, las que deciden lo que hace Claude Code.
• Pide la fuente. Cada respuesta de Fuentio lleva su fuente y su fecha de comprobación; pedir a Claude Code que las cite hace que las respuestas sean verificables.
• Vigila las unidades. Una búsqueda cuesta 2 unidades por página y una verificación 5. Para cientos de empresas, un script contra la API REST es más fácil de controlar que una conversación larga.

Mira lo que cubrimos.

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. Las respuestas mostradas se grabaron el 12 de octubre de 2026; las respuestas en directo cambian con los registros. 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, y sin consulta por número fiscal. Nunca se devuelve el nombre de una persona. Los comandos y menús de Claude Code pueden cambiar entre versiones: ante la duda, claude mcp --help lista las opciones actuales.

Preguntas frecuentes

¿Necesito una clave API para usar Fuentio en Claude Code?

No. Sin clave, Claude Code usa la prueba gratuita, 20 unidades al día. Una clave gratuita da 100 unidades al mes y abre las herramientas que la necesitan.

¿Cómo comparto el servidor de Fuentio con mi equipo?

Añádelo con --scope project: Claude Code lo escribe en un archivo .mcp.json que puedes subir al repositorio. Mantén las claves fuera de ese archivo.

¿Cómo veo las herramientas de Fuentio en Claude Code?

Escribe /mcp dentro de Claude Code o ejecuta claude mcp list en tu terminal.

¿Puede Claude Code comprobar un archivo entero de empresas?

Sí, hace una consulta por línea. Cada consulta cuesta 1 unidad (2 por página de búsqueda): revisa tu plan para archivos grandes o usa la API REST desde un script.

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 Claude Code, MCP (en inglés): docs.anthropic.com