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.
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.
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.
Règles de validité
- Chaque attribution de crédits, à l’inscription comme à la recharge, fixe une date d’expiration à 90 jours.
- Une recharge remet le compteur à 90 jours à 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 |
quote_company_file | Calculer le prix d’un fichier | Gratuit |
purchase_company_file | Générer le fichier et recevoir son lien | 1 crédit par entreprise, + 1 par e-mail, + 1 par téléphone |
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
Trois packs sont disponibles. Une ligne d’entreprise coûte 1 crédit ; une ligne complète, avec e-mail et téléphone, en coûte 3.
| Pack | Prix HT | Crédits | Validité | Lignes entreprise | Ou lignes complètes |
|---|---|---|---|---|---|
| Discover | 14,99 € | 300 | 1 mois | 300 | 100 |
| Business | 59 € | 1 500 | 3 mois | 1 500 | 500 |
| Data | 249 € | 7 500 | 6 mois | 7 500 | 2 500 |
4 Connecter votre IA
Ajoutez le serveur distant dans votre client, avec le nom Markethings et l’adresse ci-dessous :
https://mcp.markethings.io/mcp
- Ouvrez Claude, puis Paramètres et Connecteurs.
- Ajoutez un connecteur nommé Markethings avec 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, crédits.
- 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’adressehttps://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/mcpet 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
/mcppour vérifier : le serveur doit apparaître en CONNECTED, suivi de la liste des outils.
L’application Gemini sur le web ne permet pas encore d’ajouter un serveur
MCP de votre choix hors des États-Unis : 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.
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.
Cibler plus finement
Le moteur comprend aussi le dirigeant, les filières, les mouvements de capital et la disponibilité des contacts. Exprimez-les simplement dans la phrase.
Via Markethings, combien de PME de la filière défense en Île-de-France ?
Combien de garages en Gironde dont le dirigeant a plus de 60 ans ?
Combien de PME industrielles du Rhône ont changé de dirigeant depuis un an ?
Combien de start-up parisiennes ont augmenté leur capital cette année ?
Combien d’agences de communication à Nantes disposent d’un e-mail ?
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 Obtenir un fichier
Une fois la cible arrêtée, demandez un fichier : l’assistant calcule d’abord son prix, gratuitement, puis le génère seulement après votre confirmation. Vous recevez un lien de téléchargement vers un fichier Excel.
- Demandez le fichier : « Via Markethings, je veux le fichier de ces entreprises ».
- Répondez aux deux questions de l’assistant : ciblage NAF ou sémantique, puis contacts souhaités (e-mail, téléphone fixe, mobile, LinkedIn), obligatoires ou seulement quand ils sont disponibles.
- L’assistant affiche le prix en crédits. Confirmez par « oui » : le fichier est généré et son lien s’affiche.
Combien coûte un fichier ?
1 crédit par entreprise, plus 1 crédit par e-mail et 1 par téléphone fournis. Exemple : 1 000 entreprises, dont 400 avec e-mail et 300 avec téléphone, coûtent 1 000 + 400 + 300 = 1 700 crédits.
- Contacts facultatifs — toutes les entreprises de la cible sont livrées ; les contacts s’ajoutent quand ils sont connus.
- Contacts obligatoires — seules les entreprises pour lesquelles le contact demandé est connu sont livrées, et facturées.
Aucun débit sans fichier. Le calcul du prix est gratuit, et si la génération échoue, les crédits sont rendus.
7 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é :
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 |
8 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.
9 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.
Mes crédits sont à zéro ou expirés
Rechargez sur la page d’achat, pour une validité de 90 jours. Vous pouvez aussi demander « mes crédits Markethings » à votre assistant pour voir le solde 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.
Combien de lignes puis-je obtenir avec mes crédits ?
Une ligne d’entreprise coûte 1 crédit, une ligne avec e-mail et téléphone en coûte 3 : les 30 crédits offerts donnent 30 lignes d’entreprise ou 10 lignes complètes. Demandez le prix du fichier à l’assistant avant de confirmer, c’est gratuit.
Où trouver de l’aide ?
Contactez-nous via markethings.io/contact.