MCP filings.es : le Registre du commerce espagnol dans votre assistant

1. 1

   Téléchargez le fichier d'installation

   filings-es.mcpb3 Mo
2. 2

   Double-cliquez sur le fichier

   Claude Desktop s'ouvre et affiche la fenêtre d'installation. Si rien ne se passe, passez par Settings → Extensions → Install Extension, ou faites glisser le fichier sur la fenêtre des réglages.
3. 3

   Collez votre clé quand Claude la demande

   Elle reste sur votre machine : elle ne transite jamais par cette page.
4. 4

   Vérifiez

   Dans une conversation, demandez « ¿Quién administra la empresa B54226691? ». Claude doit répondre SOLER BULILLA SL.

1. 1

   Ouvrez Customize, puis Connectors

   Le plan gratuit permet un connecteur ; les plans payants n'ont pas de limite. Sur Team et Enterprise, seul un propriétaire peut en ajouter.
2. 2

   Cliquez sur « + », puis « Add custom connector »

   Laissez les réglages avancés vides : ce serveur n'utilise pas OAuth.
3. 3

   Collez cette adresse, puis « Add »

   https://api.filings.es/mcp?apikey=VOTRE_CLE Copier
4. 4

   Activez-le dans la conversation

   C'est l'étape qu'on oublie : un connecteur ajouté n'est actif dans aucune conversation. Cliquez sur le « + » en bas à gauche de la zone de saisie, puis sur « Connectors », et activez filings-es.

1. 1

   Ouvrez un terminal

   N'importe où : « --scope user » ci-dessous enregistre le serveur pour tous vos projets. Sans cette option, il ne serait ajouté qu'au dossier courant.
2. 2

   Lancez cette commande

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

   Vérifiez

   claude mcp get filings-es Copier

   Le serveur doit s'afficher comme connecté. La commande /mcp, dans une session, liste les 19 outils.

1. 1

   Activez le mode développeur

   Settings → Connectors → Advanced → Developer Mode. Tant qu'il est éteint, aucune option de connecteur personnalisé n'apparaît — c'est la cause n°1 des installations qui échouent.
2. 2

   Cliquez sur « Create »

   Nommez-le filings-es, et collez l'adresse ci-dessous comme URL du serveur.

   https://api.filings.es/mcp?apikey=VOTRE_CLE Copier
3. 3

   Cochez « I trust this provider », puis « Create »

   La case est obligatoire, le bouton reste inactif sans elle.
4. 4

   Activez-le dans chaque conversation

   Cliquez sur « + » dans la zone de saisie, puis « More », puis « Developer Mode », et sélectionnez filings-es. À refaire à chaque nouvelle conversation.

Pour intégrer le registre dans votre propre produit. Aucune interface, aucun mode développeur : le serveur se déclare comme un outil, et le modèle décide seul quand l'appeler.

1. 1

   Installez la bibliothèque

   pip install openai Copier
2. 2

   Déclarez le serveur et posez votre question

   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": "VOTRE_CLE"}, "require_approval": "never", }], input="¿Quién administra la empresa con NIF B54226691?", ) print(resp.output_text) Copier
3. 3

   Ce que vous devez obtenir

   Une réponse en clair citant SOLER BULILLA SL. Pour valider chaque appel avant qu'il parte, remplacez « never » par « always ». Pour restreindre le modèle à certains outils, ajoutez « allowed_tools ».

1. 1

   Ouvrez la page Connectors

   Ajouter un connecteur est réservé à l'administrateur. Sur les plans Free, Pro et Student, c'est le titulaire du compte.
2. 2

   « + Add Connector », onglet « Custom MCP Connector »

   Comme nom, écrivez filings-es sans espace ni accent : le champ les refuse.
3. 3

   Collez l'adresse NUE, sans clé

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

   Le Chat détecte l'authentification lui-même : cliquez sur « Connect », choisissez le jeton Bearer et collez votre clé dans le formulaire. C'est plus propre qu'une clé dans l'URL.

4. 4

   Sélectionnez-le et testez

   Le connecteur apparaît dans le menu des outils. Demandez « ¿Quién administra la empresa B54226691? » : la réponse doit citer SOLER BULILLA SL.

1. 1

   Ouvrez le bon fichier

   ~/.cursor/mcp.json pour tous vos projets, ou .cursor/mcp.json à la racine d'un projet pour ce projet seul. Les autres éditeurs lisent le même format.
2. 2

   Collez cette configuration

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

   Redémarrez l'éditeur

   La plupart ne relisent leur configuration qu'au démarrage. Dans Cursor, le serveur s'active ensuite depuis Customize, dans la barre latérale.