Connectez votre IA à Markethings en quelques minutes

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.

1. Ouvrez la page Créer votre compte MCP.
2. Renseignez votre adresse e-mail, votre identité et les informations de votre entreprise (SIREN).
3. 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.

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

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.

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 :

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.

{
  "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.

Exemples de recherches

• 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.

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.

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.

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é

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

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

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.

7 Les critères disponibles

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

8 Questions fréquentes