Documentation OneMCP

Documentation OneMCP

Tes apps, tes APIs, n'importe quel serveur MCP · 41 tools inclus · 16 sources officielles FR/EU · v0.6.0

Installation

⚡ Claude — connecteur en 1 clic (recommandé)

Aucun fichier à éditer, aucune clé à copier-coller. Claude gère la connexion tout seul — sur claude.ai (web) comme sur l'app Desktop.

  1. Sur claude.ai ou dans l'app Desktop : Réglages → Connecteurs → Ajouter un connecteur personnalisé
  2. Collez l'URL : https://api.onemcp.fr/mcp
  3. Claude ouvre une page de connexion OneMCP dans le navigateur — entrez votre email, un code à 6 chiffres arrive par mail (aucun compte préalable requis, il est créé automatiquement)
  4. Cliquez Autoriser — c'est fait, les outils apparaissent dans Claude

Claude Desktop / Claude Code — config manuelle (avancé)

Pour un usage local sans compte, ou en environnement scripté/CI.

// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "onemcp": {
      "command": "npx",
      "args": ["-y", "@altura_ma/onemcp"]
    }
  }
}

Mode hébergé avec clé API statique (avancé)

Pour les clients MCP qui ne supportent pas le connecteur OAuth (scripts, intégrations serveur-à-serveur).

{
  "mcpServers": {
    "onemcp": {
      "url": "https://api.onemcp.fr/mcp",
      "headers": { "Authorization": "Bearer mk_live_xxx" }
    }
  }
}

ChatGPT Custom Actions

3 étapes pour brancher OneMCP dans un GPT personnalisé.

1. Obtenir une clé API

Inscris-toi sur onemcp.fr/#signup — 500 calls/mois gratuits, sans carte bancaire. Conserve la clé affichée (elle ne sera plus visible).

2. Importer la spec dans GPT Builder

Dans ChatGPT → Explore GPTs → Create → Configure → Actions → Import from URL, colle :

https://api.onemcp.fr/openapi-gpt.json

Auth : API Key, header name Authorization, valeur Bearer mk_live_xxx.

3. Ajouter les instructions système

Tu as accès à OneMCP via l'action call_onemcp_tool.
Utilise-le pour toute requête sur les entreprises françaises,
adresses, marchés publics, immobilier, TVA EU ou brevets.
Paramètre : {"tool":"company_search","params":{"query":"..."}}

Guide complet avec exemples de prompts →

Connecteurs & coffre-fort

Au-delà des 41 tools officiels France/EU, connecte tes propres outils tiers depuis ton dashboard → Tes sources de données. Chaque credential est chiffré (AES-256-GCM) et isolé par compte — jamais partagé, jamais loggé en clair.

Tools natifs Lemlist & Apollo.io

Ajoute le connecteur, les tools apparaissent automatiquement dans tools/list, namespacés <connecteur>__<tool>.

lemlist__*9 tools

list_campaigns, get_campaign, list_campaign_leads, add_lead_to_campaign, remove_lead_from_campaign, pause_lead, resume_lead, get_lead, list_activities (suivi des réponses).

apollo__*5 tools

search_people, search_organizations, enrich_person, enrich_organization, add_contact_to_sequence.

whatsapp__*4 tools

send_text, send_media (image/document/vidéo), send_voice (message vocal), get_media (télécharge une pièce jointe reçue par son id). Envoi uniquement — nécessite ton propre WhatsApp Business Account et un token System User permanent (Meta for Developers).

N'importe quelle API REST

Tout connecteur avec une base_url (catalogue ou custom) expose un tool générique <connecteur>__http_request — méthode, chemin, query, body au choix. Idéal pour un service sans tools natifs dédiés (HubSpot, Airtable, Stripe, Brevo, Slack, Notion, GitHub, Linear, Firecrawl, Apify…).

Proxy MCP universel

Enregistre l'URL d'un serveur MCP tiers déjà hébergé (Notion, GitHub Copilot, Apollo, Stripe, Linear…) — ses tools sont fusionnés dans ton /mcp, namespacés et cachés 5 minutes.

OAuth2 — connexion 1 clic

Certains connecteurs (ex. Google Drive) utilisent l'app OAuth d'OneMCP — clique « Connecter », autorise, c'est fait. Pour les autres, apporte ta propre app OAuth2 (client_id/secret) via le formulaire connecteur custom.

OAuth2 sur /mcp (ChatGPT Apps, Codex)

En plus des clés API mk_live_..., /mcp accepte l'authentification OAuth2 standard (RFC 7591/8414) — nécessaire pour le mode « OAuth » du portail OpenAI Apps. Les deux modes fonctionnent en parallèle, aucune migration requise pour tes clés existantes.

Clés BYOK (optionnelles)

Ces connecteurs nécessitent tes propres clés. Tous offrent un accès gratuit avec inscription.

INSEE_CLIENT_ID / INSEE_CLIENT_SECRET

INSEE Sirene — api.insee.fr/catalogue

INPI_USERNAME / INPI_PASSWORD

INPI RNE (statuts, UBO) — data.inpi.fr

COMPANIES_HOUSE_API_KEY

Companies House UK — developer.company-information.service.gov.uk

EPO_CLIENT_KEY / EPO_CLIENT_SECRET

Brevets EPO OPS — developers.epo.org

FRANCE_TRAVAIL_CLIENT_ID / FRANCE_TRAVAIL_CLIENT_SECRET

Offres d'emploi — francetravail.io/data/api

PISTE_CLIENT_ID / PISTE_CLIENT_SECRET

Légifrance + Judilibre — piste.gouv.fr

Meta / Routing

2 tools
mcp_guideGratuit

Routage en langage naturel. Décris ton intention, le tool recommandé t'est retourné avec des paramètres d'exemple.

intentlang
{ "tool": "mcp_guide", "params": { "intent": "trouver les marchés publics d'une mairie" } }
sources_listGratuit

Liste toutes les sources avec licences, TTL de cache, et statut de configuration (clés BYOK présentes ou non).

Aucun paramètre

Entreprises

8 tools
company_deep_profileGratuit

Profil complet en 1 appel : identité + BODACC + marchés publics + LEI + risques géographiques en parallèle. Retourne _request_id pour tracer les logs.

sireninclude_legalinclude_contractsinclude_leiinclude_riskscontracts_limit
{ "siren": "552032534", "contracts_limit": 10 }
company_searchGratuit

Recherche full-text d'entreprises françaises. Retourne total_results, has_more pour la pagination.

queryper_pagepage
{ "query": "BNP Paribas", "per_page": 10 }
company_getGratuit

Fiche complète par SIREN (9 chiffres) ou SIRET (14 chiffres). Inclut dirigeants, établissements, finances.

identifier
{ "identifier": "552032534" }
company_enrichGratuit

Due diligence : BODACC + Géorisques + LEI en parallèle pour un SIREN donné.

siren
company_batchGratuit

Lookup de 1 à 20 SIRENs en un seul appel. Résultats individuels avec found/error par SIREN.

sirens[]include_bodacc
{ "sirens": ["552032534", "542107651"] }
company_financial_historyGratuit

Historique financier : CA, résultat net, effectifs sur les années disponibles.

siren
company_sireneBYOK INSEE

Fiche officielle INSEE Sirene. Mise à jour quotidienne. Historique des périodes via periodesUniteLegale.

siren
company_rneBYOK INPI

INPI RNE : statuts, actes, comptes annuels, bénéficiaires effectifs (UBO). Source KYC/AML.

siren
company_ukBYOK Companies House

Registre officiel des sociétés UK. Recherche par nom ou numéro Companies House.

identifier
{ "identifier": "00445790" }

Géocodage & Risques

5 tools
address_searchGratuit

Géocodage d'adresse texte vers coordonnées GPS. Source : Base Adresse Nationale (BAN).

qlimit
{ "q": "20 avenue de Ségur, Paris" }
address_reverseGratuit

Reverse geocoding : coordonnées GPS vers adresse postale normalisée.

latlon
{ "lat": 48.8584, "lon": 2.2945 }
address_risksGratuit

Risques naturels et technologiques à une adresse via Géorisques : inondations, séismes, ICPE, mouvements de terrain…

address
{ "address": "20 avenue de Ségur, Paris" }
address_validateGratuit

Valide et normalise une adresse française via la Base Adresse Nationale. Retourne l'adresse officielle, les coordonnées GPS, le score de confiance et le code INSEE.

address
{ "address": "20 avenue de Ségur Paris" }
address_batchGratuit

Géocode jusqu'à 50 adresses françaises en un seul appel via la BAN. Retourne pour chaque adresse : adresse normalisée, coordonnées GPS, code INSEE et score de confiance.

addresses
{ "addresses": ["20 avenue de Ségur Paris", "1 place du Capitole Toulouse"] }

Découpage administratif

8 tools
admin_commune_searchGratuit

Cherche une commune française par nom, code postal ou code de département.

nomcode_postalcode_departementlimit
{ "nom": "Lyon" }
admin_commune_getGratuit

Fiche complète d'une commune par code INSEE : population, coordonnées, département, région.

code
{ "code": "75056" }
admin_departement_listGratuit

Liste des 101 départements français. Filtrable par code région.

code_region
admin_departement_communesGratuit

Toutes les communes d'un département avec population et codes INSEE.

codelimit
{ "code": "69" }
admin_region_listGratuit

Liste des 18 régions françaises avec chefs-lieux et codes.

Aucun paramètre
admin_epci_listGratuit

Liste des EPCIs (intercommunalités) par département.

code_departement
{ "code_departement": "69" }
admin_epci_communesGratuit

Communes membres d'un EPCI par code intercommunalité.

code
{ "code": "200046977" }
commune_statsGratuit

Statistiques complètes d'une commune : données administratives, transactions immobilières DVF et marchés publics DECP. Agrège 3 sources en un seul appel.

insee_coderealestate_limitcontracts_limit
{ "insee_code": "75056" }

Immobilier

2 tools
realestate_transactionsGratuit

Transactions DVF (Demande de Valeur Foncière) des 5 dernières années. Par code INSEE ou code postal. Filtres : type de bien, price_min/price_max.

insee_codepostal_codetype_bienprice_minprice_maxlimit
{ "postal_code": "75008", "type_bien": "Appartement", "price_min": 200000 }
realestate_statsGratuit

Prix médian, moyen, min, max au m² pour une commune. Segmenté Maison / Appartement. Basé sur les données DVF.

insee_codesample_size
{ "insee_code": "75056", "sample_size": 200 }

Identité & TVA

4 tools
vat_validateGratuit

Validation TVA intracommunautaire via VIES pour les 27 pays de l'UE. Temps réel.

vat_number
{ "vat_number": "FR76552032534" }
lei_searchGratuit

Recherche le LEI (Legal Entity Identifier) mondial d'une entité par nom.

legal_namelimit
{ "legal_name": "BNP Paribas" }
lei_lookupGratuit

Fiche complète par code LEI (GLEIF).

lei
{ "lei": "R0MUWSFPU8MPRO8K5P83" }
company_vat_checkGratuit

Déduit le numéro de TVA intracommunautaire depuis un SIREN français et le valide en temps réel via VIES (UE). Retourne le numéro TVA, la raison sociale et l'adresse VIES.

siren
{ "siren": "552032534" }

Brevets

2 tools · BYOK EPO
patents_searchBYOK EPO

Recherche de brevets mondiaux EPO Espacenet en syntaxe CQL. Champs : ti (titre), ab (abrégé), pa (déposant), in (inventeur), cl (classification IPC).

querylimit
{ "query": "ti=machine learning AND pa=BNP" }
patent_getBYOK EPO

Fiche complète d'un brevet par numéro de publication EPO.

countrydoc_numberkind
{ "country": "EP", "doc_number": "1000000", "kind": "A1" }

Emploi

2 tools · BYOK France Travail
jobs_searchBYOK France Travail

Offres d'emploi France Travail. Filtres : mots-clés, lieu, type de contrat (CDI/CDD/intérim).

keywordslocationcontract_typelimit
{ "keywords": "développeur TypeScript", "location": "Paris" }
rome_searchBYOK France Travail

Codes ROME par libellé de métier. Utile pour qualifier des offres ou des profils.

query
{ "query": "développeur logiciel" }

Marchés publics

2 tools
public_contracts_searchGratuit

Marchés publics DECP. Filtres : titulaire (SIREN), acheteur (SIRET), code CPV, département, plage de dates, montant minimum.

siren_titulairesiret_acheteurcode_cpvdepartementdate_frommontant_minlimit
{ "siren_titulaire": "552032534", "limit": 20 }
area_business_intelligenceGratuit

Intelligence économique territoriale : entreprises actives + marchés publics + transactions immobilières + données admin par département ou commune.

departementinsee_codecompanies_limitcontracts_limitrealestate_limit
{ "departement": "75" }

Sources

1 tool
sources_listGratuit

Liste les 16 sources avec ID, licence, TTL de cache, et statut de configuration en temps réel.

Aucun paramètre