MCP Datactive v0.1.0-poc

Serveur Model Context Protocol exposant les capacités Datactive à Claude Desktop, Claude Code et tout client MCP.

Qu'est-ce que MCP ?

Le Model Context Protocol (MCP) est un standard ouvert qui permet à un modèle d'IA (Claude, ChatGPT, agents) d'appeler directement les capacités d'un service métier — recherche d'entreprises, lecture de fiches dirigeants, lancement de campagnes, etc. — sans intermédiaire UI. Concrètement : tu poses une question en français à Claude Desktop, Claude appelle search_companies, te rend la réponse en langage naturel.

Endpoints publics

Endpoint	Méthode	Description
`/mcp`	POST	JSON-RPC 2.0 — initialize, tools/list, tools/call (transport HTTP+SSE)
`/health`	GET	Statut du serveur (JSON public, sans auth)
`/`	GET	Cette page de documentation

Configuration Claude Desktop

Édite ton fichier de config Claude Desktop :

macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
Windows : %APPDATA%\Claude\claude_desktop_config.json

Ajoute la section mcpServers :

{
  "mcpServers": {
    "datactive": {
      "url": "https://mcp.datactive.fr/mcp",
      "headers": {
        "Authorization": "Bearer VOTRE_CLE_API"
      }
    }
  }
}

Redémarre Claude Desktop. Les 14 tools Datactive apparaîtront dans la liste des outils disponibles.

Génération de clé API — connecte-toi à ton compte Datactive, va dans Paramètres → API Keys, clique Générer une nouvelle clé. La clé apparaît une seule fois (~64 caractères hexa) — copie-la immédiatement et colle-la dans la config Claude Desktop ci-dessous. Tu peux générer jusqu'à 5 clés et les révoquer à tout moment depuis la même page.

14 tools v0 disponibles

👉 Référence complète des 14 tools — paramètres, sortie observée, exemples pour chaque tool.

Recherche & profils entreprises

search_companies — recherche full-text + filtres SIRENE
get_company_profile — fiche complète d'une entreprise (par SIREN)
get_legal_announcements — annonces BODACC liées à un SIREN
suggest_companies — autocomplete par début de raison sociale

Dirigeants

search_executives — recherche dans la base RNE/INPI
get_executive_profile — fiche d'un dirigeant identifié
list_executive_mandates — mandats actifs/historiques

Contacts B2B enrichis

search_contacts — recherche dans ct_contacts (4,5M)
get_contact_profile — fiche détaillée contact (titre, email, tél)

Campagnes

list_campaigns — campagnes du compte appelant
get_campaign — détails d'une campagne
get_campaign_analytics — taux d'ouverture, clic, désabonnement

Compte & monétisation

list_plans — plans tarifaires Datactive disponibles
get_credits_balance — solde de crédits du compte appelant

Exemples d'appels curl

1. Vérifier le serveur (sans auth)

curl https://mcp.datactive.fr/health
# {"status":"ok","version":"0.1.0-poc","tools":14}

2. Initialize — handshake MCP obligatoire

curl -X POST https://mcp.datactive.fr/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"initialize",
    "params":{
      "protocolVersion":"2024-11-05",
      "capabilities":{},
      "clientInfo":{"name":"my-client","version":"1.0"}
    }
  }'

3. Lister les tools disponibles

curl -X POST https://mcp.datactive.fr/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -H "Mcp-Session-Id: SESSION_ID_DU_INITIALIZE" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

4. Autocomplete entreprises (suggest_companies)

curl -X POST https://mcp.datactive.fr/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -H "Mcp-Session-Id: SESSION_ID" \
  -d '{
    "jsonrpc":"2.0","id":3,
    "method":"tools/call",
    "params":{
      "name":"suggest_companies",
      "arguments":{"query":"datactive","limit":5}
    }
  }'

Authentification & quotas

Chaque appel à /mcp requiert un header Authorization: Bearer <clé>. Les clés sont rattachées à un compte Datactive et héritent de ses quotas de crédits. Chaque tools/call qui touche aux données enrichies (recherche entreprise, fiche dirigeant, contacts) consomme des crédits selon le tarif du plan ; les opérations méta (list_plans, get_credits_balance) sont gratuites.

Limites du POC

Auth réutilise le système de clés API existant Datactive (table api_keys) — chaque clé est rattachée à un email de compte, hérite de son rôle (user / admin) et de son quota.
Pas encore de rate limiting MCP-spécifique — à venir avec express-rate-limit (le rate_limit existant sur api_keys n'est pas encore enforcé côté MCP).
JWT impersonation vers sirene-api via secret partagé — sera remplacé par une super-clé MCP dédiée après rotation JWT.
Audit : last_used_at et total_calls mis à jour à chaque appel, logs détaillés dans api_usage_log et user_actions_log.

Données & RGPD

Les données accessibles via MCP sont strictement les mêmes que celles disponibles dans l'interface Datactive du compte appelant — aucun privilège supplémentaire. Toute requête est journalisée. Les données B2B servies (entreprises, dirigeants, contacts) sont issues des sources publiques INSEE/SIRENE, INPI/RNE, BODACC, et d'enrichissements Apollo / Explorium dans le respect du registre RGPD Datactive (art. 30) et de la DPIA #1 disponible sur demande.