Connectez votre IA à Markethings en quelques minutes

Utilisez Claude, Mistral, ChatGPT, Gemini ou un autre agent compatible MCP pour interroger les données d’entreprises françaises en langage naturel. Ce guide couvre la création du compte, les crédits et l’installation sur vos outils.

30 crédits offerts à l’inscription Claude · Mistral · ChatGPT · Gemini Recherche en langage naturel Acheter des crédits

1 Créer un compte Markethings

Avant de connecter un modèle de langage, créez votre compte sur le site Markethings. Vous recevrez une clé API personnelle et des crédits de bienvenue.

Ouvrez la page Créer votre compte MCP.
Renseignez votre adresse e-mail, votre identité et les informations de votre entreprise (SIREN).
Validez : le compte est créé et les crédits de bienvenue sont attribués.

Créer mon compte

2 Récupérer votre clé API

À la création du compte, Markethings affiche une clé API du type mk_…. Elle sert uniquement à vous authentifier auprès du serveur MCP, sur l’écran de connexion.

Important. La clé n’est montrée qu’une seule fois. Copiez-la et conservez-la en lieu sûr. Ne la partagez jamais dans une conversation publique ni dans un dépôt Git.

Elle remplace un mot de passe pour Claude, Mistral, ChatGPT, Gemini et les autres agents MCP.
Le modèle n’a pas besoin de votre adresse e-mail : votre identité vient de la clé.
Si vous perdez la clé, contactez Markethings pour en obtenir une nouvelle. L’ancienne est alors révoquée.

3 Comprendre les crédits

Les outils de recherche d’entreprises consomment des crédits. Les outils d’état, comme la consultation du solde, restent gratuits.

30crédits offerts à l’inscription

Selon le packvalidité des crédits

1crédit par comptage

2crédits par aperçu

2crédits par répartition

Règles de validité

Chaque attribution de crédits fixe une date d’expiration qui dépend du pack choisi. La durée de chacun est indiquée dans la grille ci-dessous.
Une recharge repart de sa propre durée, comptée à partir de la date d’achat.
Passé ce délai, le solde peut rester affiché mais les outils payants sont bloqués jusqu’à une nouvelle recharge.

Coût des outils

Outil	Usage	Coût
`count_companies`	Compter les entreprises	1 crédit
`preview_companies`	Voir un échantillon d’entreprises	2 crédits
`companies_distribution`	Répartir la cible par département, effectif, secteur…	2 crédits
`get_my_credits`	Consulter le solde et l’expiration	Gratuit
`ping`	Vérifier l’état du serveur	Gratuit

Le débit n’intervient qu’en cas de succès. Une requête rejetée ou en erreur technique ne consomme aucun crédit. Si le solde est insuffisant, le serveur renvoie le lien d’achat.

Recharger

Le nombre de crédits et la durée de validité vont de pair : plus le pack est fourni, plus vous avez de temps pour le consommer.

Pack	Contenu	Prix HT	Prix TTC
Pack Discover	300 crédits — validité 1 mois 100 lignes complètes, e-mail et téléphone ou 300 lignes entreprise sans contact	14,99 €	17,99 €
Pack Business	1 500 crédits — validité 3 mois 500 lignes complètes, e-mail et téléphone ou 1 500 lignes entreprise sans contact	59,00 €	70,80 €
Pack Data	7 500 crédits — validité 6 mois 2 500 lignes complètes, e-mail et téléphone ou 7 500 lignes entreprise sans contact	249,00 €	298,80 €

Les tarifs en vigueur sont ceux de la page d’achat.

Acheter des crédits

4 Connecter votre IA

Ajoutez le serveur distant dans votre client, avec le nom Markethings et l’adresse ci-dessous :

URL du serveur https://mcp.markethings.io/mcp

Vérifiez d’abord votre abonnement. La possibilité de connecter un serveur MCP de votre choix dépend du niveau tarifaire de votre assistant, et non de Markethings : plusieurs éditeurs la réservent à leurs offres payantes, et les comptes gratuits n’y ont pas accès. Les conditions propres à chaque client sont rappelées sous l’onglet correspondant. En entreprise, l’ajout d’un connecteur demande en général l’accord d’un administrateur de l’espace de travail.

Ouvrez Claude, puis Personnaliser → Connecteurs.
Cliquez sur + Ajouter, puis sur Ajouter un connecteur personnalisé. Nommez-le Markethings et saisissez l’adresse https://mcp.markethings.io/mcp.
Lancez l’autorisation : une page Markethings s’ouvre pour y coller votre clé API mk_….
Revenez dans Claude : les outils Markethings apparaissent — comptage, aperçu, répartition, crédits.

Les connecteurs personnalisés fonctionnent sur tous les plans, y compris gratuit — celui-ci étant limité à un seul connecteur personnalisé. En Team et en Enterprise, c’est un propriétaire de l’organisation qui ajoute le connecteur depuis les paramètres d’organisation ; les autres membres n’ont ensuite qu’à cliquer sur Connecter dans Personnaliser → Connecteurs.

Ouvrez chat.mistral.ai et basculez sur l’onglet Work, dans le sélecteur en haut de la barre latérale. Les connecteurs n’existent pas en mode Chat.
Ouvrez la page Connectors, cliquez sur + Add Connector, puis sur l’onglet Custom MCP Connector.
Renseignez le nom markethings — sans espace ni accent — et l’adresse https://mcp.markethings.io/mcp, puis cliquez sur Connect. Le Chat détecte l’authentification et ouvre la page Markethings où coller votre clé mk_….
Dans une nouvelle discussion en mode Work, cliquez sur + ou tapez /, ouvrez Tools et activez Markethings.

L’ajout d’un connecteur demande les droits d’administrateur de l’espace. Sur les offres Free, Pro et Student, le propriétaire du compte les a d’office ; en Team et Enterprise, demandez-le à votre administrateur. Dans Connectors → My Connectors, l’onglet Functions permet de passer les outils de lecture en Always Allow pour ne plus confirmer chaque appel.

Activez le mode développeur : Paramètres → Connecteurs → Avancé → Mode développeur.
Toujours dans Connecteurs, cliquez sur Créer. Nommez-le Markethings, saisissez l’adresse https://mcp.markethings.io/mcp et choisissez l’authentification OAuth.
Enregistrez, puis cliquez sur Connecter : la page Markethings s’ouvre pour y coller votre clé mk_….
Dans une nouvelle conversation, ouvrez le menu +, choisissez Mode développeur et cochez Markethings. La sélection se fait conversation par conversation.

Le mode développeur est réservé aux offres Plus, Pro, Business, Enterprise et Education, sur la version web. Sur un espace Business ou Enterprise, un propriétaire doit l’autoriser au préalable. OpenAI renomme et déplace souvent ces réglages — Apps, Plugins, Connecteurs : si l’intitulé diffère, cherchez « MCP » dans les paramètres.

Installez Gemini CLI, si ce n’est pas déjà fait : npm install -g @google/gemini-cli
Déclarez le serveur, pour votre compte et non pour un seul dossier : gemini mcp add -s user --transport http markethings https://mcp.markethings.io/mcp
Lancez gemini, puis tapez /mcp auth markethings : votre navigateur s’ouvre sur la page Markethings où coller votre clé mk_….
Tapez /mcp pour vérifier : le serveur doit apparaître en CONNECTED, suivi de la liste des outils.

Gemini CLI n’exige aucun abonnement payant : un compte Google suffit. L’application Gemini sur le web, elle, ne permet pas encore d’ajouter un serveur MCP de votre choix hors des États-Unis, et le fait dépendre d’un abonnement AI Pro ou Ultra : la ligne de commande est pour l’instant la seule voie depuis la France. Si vous préférez éditer le fichier à la main, la même déclaration s’écrit ainsi dans ~/.gemini/settings.json :

{
  "mcpServers": {
    "markethings": {
      "httpUrl": "https://mcp.markethings.io/mcp",
      "timeout": 60000
    }
  }
}

5 Premiers usages

Commencez une nouvelle discussion. Ouvrez un nouveau chat et débutez par une phrase du type « via Markethings, … ». L’assistant conserve ensuite le contexte au fil de la conversation — critères déjà posés, résultats précédents — sans que vous ayez à tout reformuler.

Vérifier vos crédits

Avant une recherche, demandez simplement votre solde. L’outil est gratuit.

Via Markethings, combien me reste-t-il de crédits ?

Via Markethings, montre mon solde et la date d’expiration des crédits.

Exemples de recherches

Via Markethings, combien de cabinets comptables à Bordeaux de plus de 20 salariés ?

Combien de boulangeries artisanales dans le 69 ?

Montre-moi quelques PME de la chimie en Rhône-Alpes avec un chiffre d’affaires supérieur à 2 M€.

Comptage — les mots « combien » ou « nombre » — coûte 1 crédit et renvoie deux ensembles de résultats.
Aperçu — les mots « montre », « liste » ou « exemples » — coûte 2 crédits. Le choix entre NAF et sémantique ne se fait qu’à ce moment.
Répartition — les mots « répartition », « ventilation » ou « par … » — coûte 2 crédits et ventile la cible selon la dimension demandée.

Obtenir une répartition

Une fois la cible connue, vous pouvez la faire ventiler plutôt que de la compter : savoir où se concentrent les entreprises, à quelles tailles elles correspondent, sous quelles formes juridiques elles se répartissent.

Via Markethings, répartition des cabinets comptables de plus de 20 salariés par département.

Et maintenant par tranche d’effectif.

Ventile les boulangeries artisanales du 69 par année de création.

Neuf dimensions sont disponibles : département, région, secteur, code NAF, tranche d’effectif, année de création, forme juridique, tranche de chiffre d’affaires et tranche d’âge du dirigeant.

Précisez toujours par quoi répartir. Une demande de répartition sans dimension n’est pas facturée : l’assistant vous demande simplement laquelle choisir. Et comme pour les autres outils, les 2 crédits ne sont débités qu’en cas de succès.

Affiner une recherche

Une fois la requête posée, vous pouvez la modifier au fil de l’eau : l’assistant reconstruit la demande complète à partir du contexte, puis vous la confirme avant de relancer.

Via Markethings, combien de cabinets comptables à Bordeaux avec plus de 20 salariés ?

Plutôt avec un chiffre d’affaires supérieur à 2 M€.

D’accord pour le comptage.

Autres précisions courantes : « plutôt en Île-de-France », « sans les ESN », « moins de 30 salariés », « avec un capital supérieur à 1 M€ ».

6 Comptage : NAF ou sémantique

Chaque comptage renvoie deux ensembles distincts. Ils correspondent à deux façons de chercher une activité, et produisent donc des résultats différents.

Ensemble	Principe
NAF et critères	Codes NAF retenus et critères structurés : lieu, effectif, dates, chiffre d’affaires, capital.
Sémantique	Recherche par proximité de sens avec l’activité formulée, combinée aux mêmes critères.

L’ensemble NAF est exhaustif sur les codes d’activité sélectionnés, mais un même code peut couvrir de nombreux métiers. L’ensemble sémantique cherche les entreprises les plus proches du métier exprimé. Lors d’un comptage, vous ne choisissez rien : les deux nombres sont affichés.

Exemple : le conseil en cybersécurité

Via Markethings, combien de sociétés font du conseil en cybersécurité en France avec plus de 10 salariés ?

Markethings a retenu le code 6202A — Conseil en systèmes et logiciels informatiques. Le comptage a renvoyé :

3 096NAF et critères

56sémantique

Cet écart est normal : le code 6202A couvre tout le conseil en systèmes et logiciels informatiques, et pas seulement la cybersécurité.

Choisir l’ensemble lors d’un aperçu

Si vous demandez ensuite un échantillon, l’assistant rappelle les deux résultats puis vous demande lequel utiliser. Répondez « NAF » ou « sémantique » : un aperçu porte toujours sur un seul ensemble.

Échantillon NAF et critères

Entreprise	Ville	NAF	Effectif
Siemens Industry Software SAS	Châtillon	6202A	500 à 999
Commify France	Lyon	6202A	10 à 19
Whitelab Genomics	Évry-Courcouronnes	6202A	20 à 49

Ces entreprises relèvent bien du code 6202A, mais leur activité réelle n’est pas nécessairement centrée sur la cybersécurité.

Échantillon sémantique

Entreprise	Ville	NAF	Effectif
XMCO	Paris	6202A	100 à 199
Fidens	Maisons-Laffitte	6202A	20 à 49
Squad	Paris	6202A	500 à 999

Cet échantillon est plus proche du métier recherché. Le mode sémantique permet de cibler une spécialité que le seul code NAF ne sait pas isoler.

Et si aucune activité n’est mentionnée ?

Si la demande ne contient ni métier ni secteur, le moteur sémantique n’a rien à chercher : seul l’ensemble NAF et critères est alors pertinent.

Requête	NAF et critères	Sémantique
Sociétés à Lyon avec plus de 50 salariés	825	0
PME en Île-de-France avec un capital supérieur à 1 M€	6 859	0

7 Les critères disponibles

Tous se combinent librement, à une exception près : une seule activité par recherche.

Activité — Un métier ou un secteur par recherche, exprimé librement (« boulangeries artisanales ») ou par code NAF. La recherche sémantique élargit aux entreprises dont l’activité réelle correspond, au-delà du code déclaré.
Localisation — Commune, code postal, département ou région.
Taille — Tranche d’effectif. Les tranches sont celles de l’INSEE ; un seuil demandé est ramené à la tranche inférieure la plus proche.
Finances — Chiffre d’affaires, résultat net et rentabilité, en minimum, en maximum ou entre deux bornes, sur l’exercice le plus récent.
Forme juridique — Catégorie juridique et capital social.
Ancienneté — Date de création de l’entreprise.
Dirigeant — Âge du dirigeant (« dirigeant de plus de 60 ans », « proche de la retraite ») et changement récent de dirigeant (« depuis un an »).
Filière — B2B, e-commerce, SaaS, nucléaire ou défense. La filière est aussi reconnue à partir de l’activité : « e-commerçants à Bordeaux ».
Capital — Augmentation ou modification de capital au cours des 12 derniers mois (« start-up qui ont levé des fonds »).
Contacts — E-mail, téléphone ou mobile, au choix. Exigés, ils restreignent la sélection aux entreprises pour lesquelles le contact est connu ; facultatifs, ils enrichissent les lignes qui en disposent. Ils peuvent aussi servir de critère de comptage : « disposant d’un e-mail ».

Une seule activité par recherche. Pour en comparer plusieurs, lancez-les l’une après l’autre.

8 Questions fréquentes

Le connecteur demande une clé : laquelle ?

La clé mk_… affichée à la création du compte, et non le mot de passe de votre messagerie.

Le client MCP demande un identifiant ou un secret client OAuth

Laissez ces champs vides : ils ne sont pas nécessaires pour Markethings.

Quelle est la différence avec le moteur de recherche en page d’accueil et la plateforme Markethings ?

Les trois interrogent la même base d’entreprises françaises, mais ne répondent pas au même besoin.

Le moteur de recherche en page d’accueil est ouvert à tous, sans compte : vous décrivez une cible, il affiche le nombre d’entreprises correspondantes et le prix du fichier. C’est la voie la plus courte pour un achat ponctuel.

Le serveur MCP, celui que décrit ce guide, amène ces données dans votre assistant. Vous enchaînez les questions en langage naturel, vous affinez la cible au fil de la conversation, et le résultat reste à portée pour la suite de votre travail — une note, un courriel, un tableau. Il fonctionne aux crédits, et donne accès au comptage, à l’aperçu et à la répartition sans passer par un achat de fichier.

La plateforme Markethings est l’espace où vous suivez votre compte : vos crédits et leur validité, vos commandes et vos factures, et la livraison de vos fichiers de prospection et de vos analyses concurrentielles.

Mes crédits sont à zéro ou expirés

Rechargez sur la page d’achat : la nouvelle validité court à partir de la date d’achat, pour la durée du pack retenu. Vous pouvez aussi demander « mes crédits Markethings » à votre assistant pour voir le solde, sa date d’expiration et le lien de recharge.

L’outil ne répond plus après une mise à jour

Déconnectez puis reconnectez le connecteur MCP une fois, et réessayez.

Où trouver de l’aide ?

Contactez-nous via markethings.io/contact.