🔌 Guide de Configuration — MCP Pappers

avril 2026 · 9 min de lecture

Connectez votre IA aux données légales françaises en moins de 5 minutes.

Sommaire

Prérequis
Obtenir votre clé API
Construire votre URL MCP
Configuration par client IA
Outils disponibles (35 tools)
Exemples de prompts
Dépannage
Limites et bonnes pratiques

Prérequis

Avant de commencer, assurez-vous d'avoir :

Un compte Pappers actif (avec accès API activé)
Un abonnement compatible avec l'accès MCP
Le client IA de votre choix installé et à jour

⚠️ Important : Le serveur MCP Pappers utilise uniquement le transport Streamable HTTP. Les transports STDIO et SSE ne sont pas supportés. Utilisez toujours le type http ou streamable-http dans vos configurations.

Obtenir votre clé API

Rendez-vous sur pappers.fr et connectez-vous
Cliquez sur votre avatar → Mon compte
Allez dans la section Mon API
Copiez votre clé API (longue suite de caractères alphanumériques)
Gardez-la confidentielle — elle sert à accéder à vos données

💡 Si vous n'avez pas encore de compte, créez-en un sur pappers.fr. Une adresse email professionnelle est recommandée (pas de Gmail).

Construire votre URL MCP

L'URL MCP suit ce format fixe :

https://mcp.pappers.fr/{votre-cle-api}

Exemple :

https://mcp.pappers.fr/abc123xyz456...

C'est cette URL que vous collez dans tous vos outils. Aucune authentification supplémentaire n'est requise — la clé est intégrée dans l'URL.

Configuration par client IA

Claude.ai (web)

La méthode la plus simple — aucune installation requise.

Allez sur claude.ai et connectez-vous
Cliquez sur votre avatar en bas à gauche → Paramètres
Allez dans Intégrations
Cliquez sur "Ajouter un connecteur personnalisé"
Renseignez :
- Nom : Pappers
- URL : https://mcp.pappers.fr/{votre-cle-api}
Cliquez sur "Ajouter"

✅ Dans toute nouvelle conversation, mentionnez via Pappers pour activer le connecteur.

Claude Desktop (macOS / Windows)

Étape 1 — Ouvrir le fichier de configuration

macOS :

~/Library/Application Support/Claude/claude_desktop_config.json

Raccourci : Claude Desktop → Paramètres → Développeur → Modifier la configuration

Windows :

%APPDATA%\Claude\claude_desktop_config.json

Étape 2 — Ajouter la configuration MCP

Ouvrez le fichier et ajoutez le bloc suivant :

{
  "mcpServers": {
    "pappers": {
      "type": "http",
      "url": "https://mcp.pappers.fr/{votre-cle-api}"
    }
  }
}

Si vous avez déjà d'autres serveurs configurés :

{
  "mcpServers": {
    "pappers": {
      "type": "http",
      "url": "https://mcp.pappers.fr/{votre-cle-api}"
    },
    "autre-serveur": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
    }
  }
}

Étape 3 — Redémarrer Claude Desktop

Quittez complètement Claude Desktop (Cmd+Q sur macOS) puis relancez-le.

Étape 4 — Vérifier la connexion

En bas d'une nouvelle conversation, une icône 🔨 (marteau) apparaît avec un chiffre indiquant les outils disponibles. Cliquez dessus pour voir la liste des tools Pappers.

Claude Code (CLI)

Via la commande `mcp add`

claude mcp add --transport http pappers https://mcp.pappers.fr/{votre-cle-api}

Via `mcp add-json` (pour les versions 2.1.1+)

claude mcp add-json pappers '{"type":"http","url":"https://mcp.pappers.fr/{votre-cle-api}"}'

Vérifier l'installation

claude mcp list
# → pappers    https://mcp.pappers.fr/...    connected

Options de scope

# Disponible uniquement dans le projet courant (défaut)
claude mcp add --scope local --transport http pappers https://mcp.pappers.fr/{votre-cle-api}

# Disponible dans tous vos projets
claude mcp add --scope user --transport http pappers https://mcp.pappers.fr/{votre-cle-api}

# Partagé avec toute l'équipe via .mcp.json
claude mcp add --scope project --transport http pappers https://mcp.pappers.fr/{votre-cle-api}

Configuration via `.mcp.json` (pour partager avec l'équipe)

Créez un fichier .mcp.json à la racine de votre projet :

{
  "mcpServers": {
    "pappers": {
      "type": "http",
      "url": "https://mcp.pappers.fr/${PAPPERS_API_KEY}"
    }
  }
}

Puis définissez la variable d'environnement :

export PAPPERS_API_KEY=votre-cle-api

💡 Cette approche évite de versionner votre clé API dans Git.

ChatGPT

⚠️ Requiert un compte Plus, Pro, Team ou Enterprise.

Allez sur chatgpt.com et connectez-vous
Allez dans Paramètres → Applications
Ouvrez Paramètres avancés et activez le Developer mode
Revenez dans Paramètres → Applications → cliquez sur "Ajouter une application"
Configurez :
- URL : https://mcp.pappers.fr/{votre-cle-api}
- Type : http ou streamable-http
Enregistrez

Le Chat (Mistral)

Disponible sur tous les plans, y compris gratuit.

Allez sur chat.mistral.ai
Dans le menu, allez dans Intelligence → Connecteurs
Cliquez sur "Add connector" → "Custom MCP Connector"
Renseignez :
- Nom : Pappers
- URL : https://mcp.pappers.fr/{votre-cle-api}
Cliquez sur "Add Server" puis "Health Check" pour vérifier
Activez le toggle pour utiliser Pappers

Open WebUI

Dans les paramètres, allez dans la section MCP / Outils
Ajoutez un nouveau serveur :
- Nom : Pappers
- URL : https://mcp.pappers.fr/{votre-cle-api}
- Type : Streamable HTTP ← important, pas SSE
Sauvegardez et vérifiez la connexion avec Health Check

Cursor / VS Code / Windsurf

Dans le fichier de configuration MCP de votre éditeur (.cursor/mcp.json, .vscode/mcp.json, etc.) :

{
  "mcpServers": {
    "pappers": {
      "type": "http",
      "url": "https://mcp.pappers.fr/{votre-cle-api}"
    }
  }
}

Outils disponibles

Le MCP Pappers expose 35 tools couvrant l'intégralité de l'écosystème Pappers. Les principaux :

Catégorie	Exemples de tools
Entreprises	Recherche par nom, détails par SIREN, dirigeants, actionnaires, filiales
Finances	Chiffre d'affaires, bilan, résultat net, historique financier
Légal / Greffe	Dépôts au greffe, annonces légales, procédures collectives
Établissements	Liste des sites, codes NAF/APE, effectifs
Immo	Données immobilières liées aux entreprises
Politique	Mandataires politiques, déclarations d'intérêts
Justice	Données judiciaires publiques

Le modèle détecte automatiquement les bons tools à invoquer selon votre question.

Exemples de prompts

Recherche et identification

Recherche des informations sur la société "Schneider Electric" via Pappers

Trouve le SIREN de "BNP Paribas" en utilisant Pappers

Analyse financière

En utilisant Pappers, donne-moi les derniers chiffres financiers de la société 
avec le SIREN 542107651

Compare le chiffre d'affaires de LVMH et Kering sur les 3 dernières années via Pappers

Due diligence / Veille

Via Pappers, qui sont les dirigeants actuels de [nom de la société] 
et depuis quand sont-ils en poste ?

Utilise Pappers pour vérifier s'il y a des procédures collectives 
en cours pour cette entreprise : [SIREN]

Analyse multi-entreprises

En utilisant Pappers, génère un tableau comparatif avec le CA, le résultat net 
et les effectifs des entreprises suivantes : [entreprise A], [entreprise B], [entreprise C]

Prospection commerciale

Via Pappers, cherche toutes les entreprises du secteur BTP (code NAF 41.20A) 
créées dans les 2 dernières années avec plus de 10 salariés

💡 Astuce : Mentionnez toujours via Pappers ou en utilisant Pappers pour forcer l'activation du connecteur. Vous pouvez aussi l'intégrer à votre prompt système pour un usage permanent.

Dépannage

Le connecteur ne répond pas

Vérifiez que l'URL MCP est copiée sans espace ni caractère en trop
Confirmez que votre abonnement Pappers inclut l'accès API
Testez l'URL directement dans votre navigateur : vous devez obtenir une réponse JSON

Claude n'utilise pas Pappers

Ajoutez explicitement via Pappers dans votre question
Ou modifiez votre prompt système : Utilise en priorité les tools Pappers pour toute requête sur les entreprises françaises

Erreur de type de transport

Vérifiez que le type est bien http ou streamable-http
STDIO et SSE ne sont pas supportés par le MCP Pappers

Quota dépassé

La clé API gratuite Pappers est limitée à 500 requêtes/mois
Consultez votre espace client pour vérifier votre consommation et upgrader si nécessaire

Limites et bonnes pratiques

Limites techniques :

Transport : Streamable HTTP uniquement (pas STDIO, pas SSE)
Données : entreprises françaises uniquement
Accès en lecture seule (aucune modification de données possible)
Quota API selon votre plan Pappers

Bonnes pratiques :

Ne versionnez jamais votre clé API dans Git — utilisez des variables d'environnement
Pour les équipes, utilisez .mcp.json avec ${PAPPERS_API_KEY} pour partager la config sans exposer la clé
Combinez Pappers avec les capacités de synthèse de votre IA pour des analyses, comparaisons et résumés automatiques

Ressources

📖 Documentation API Pappers
🔑 Obtenir une clé API
🌐 Page MCP officielle Pappers
📚 Model Context Protocol — documentation
🐙 Exemple open source mcp-pappers