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.
- Sur claude.ai ou dans l'app Desktop : Réglages → Connecteurs → Ajouter un connecteur personnalisé
- Collez l'URL :
https://api.onemcp.fr/mcp - 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)
- 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.jsonAuth : 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":"..."}}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 toolslist_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 toolssearch_people, search_organizations, enrich_person, enrich_organization, add_contact_to_sequence.
whatsapp__*4 toolssend_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_SECRETINSEE Sirene — api.insee.fr/catalogue
INPI_USERNAME / INPI_PASSWORDINPI RNE (statuts, UBO) — data.inpi.fr
COMPANIES_HOUSE_API_KEYCompanies House UK — developer.company-information.service.gov.uk
EPO_CLIENT_KEY / EPO_CLIENT_SECRETBrevets EPO OPS — developers.epo.org
FRANCE_TRAVAIL_CLIENT_ID / FRANCE_TRAVAIL_CLIENT_SECRETOffres d'emploi — francetravail.io/data/api
PISTE_CLIENT_ID / PISTE_CLIENT_SECRETLégifrance + Judilibre — piste.gouv.fr
Meta / Routing
2 toolsmcp_guideGratuitRoutage en langage naturel. Décris ton intention, le tool recommandé t'est retourné avec des paramètres d'exemple.
{ "tool": "mcp_guide", "params": { "intent": "trouver les marchés publics d'une mairie" } }sources_listGratuitListe toutes les sources avec licences, TTL de cache, et statut de configuration (clés BYOK présentes ou non).
Entreprises
8 toolscompany_deep_profileGratuitProfil complet en 1 appel : identité + BODACC + marchés publics + LEI + risques géographiques en parallèle. Retourne _request_id pour tracer les logs.
{ "siren": "552032534", "contracts_limit": 10 }company_searchGratuitRecherche full-text d'entreprises françaises. Retourne total_results, has_more pour la pagination.
{ "query": "BNP Paribas", "per_page": 10 }company_getGratuitFiche complète par SIREN (9 chiffres) ou SIRET (14 chiffres). Inclut dirigeants, établissements, finances.
{ "identifier": "552032534" }company_enrichGratuitDue diligence : BODACC + Géorisques + LEI en parallèle pour un SIREN donné.
company_batchGratuitLookup de 1 à 20 SIRENs en un seul appel. Résultats individuels avec found/error par SIREN.
{ "sirens": ["552032534", "542107651"] }company_financial_historyGratuitHistorique financier : CA, résultat net, effectifs sur les années disponibles.
company_sireneBYOK INSEEFiche officielle INSEE Sirene. Mise à jour quotidienne. Historique des périodes via periodesUniteLegale.
company_rneBYOK INPIINPI RNE : statuts, actes, comptes annuels, bénéficiaires effectifs (UBO). Source KYC/AML.
company_ukBYOK Companies HouseRegistre officiel des sociétés UK. Recherche par nom ou numéro Companies House.
{ "identifier": "00445790" }Légal & BODACC
2 toolslegal_announcements_searchGratuitAnnonces légales BODACC par SIREN ou nom. Filtres date_from/date_to disponibles.
{ "siren": "552032534", "date_from": "2024-01-01" }legal_procedures_checkGratuitVérifie si une entreprise est en procédure collective active (redressement judiciaire, liquidation).
Textes légaux
3 tools · BYOK PISTElaw_searchBYOK PISTERecherche dans les textes légaux Légifrance : codes, lois, décrets, JORF, circulaires, conventions collectives.
{ "query": "licenciement économique", "fond": "CODE" }Fonds disponibles : CODE · LEGI · JURI · JURI_ADMIN · JORF · KALI · CONSTIT · CIRC · ACCO
jurisprudence_searchBYOK PISTEDécisions de justice via Judilibre : Cour de cassation, Cours d'appel, Tribunaux judiciaires.
{ "query": "force majeure COVID", "jurisdiction": "cc" }Juridictions : cc (Cour de cassation) · ca (Cours d'appel) · tj (Tribunaux judiciaires)
code_table_of_contentsBYOK PISTETable des matières d'un code juridique français. Supporte les noms courants et les identifiants LEGITEXT.
{ "code_name": "code civil" }Codes courants : code civil · code de commerce · code du travail · code pénal
Géocodage & Risques
5 toolsaddress_searchGratuitGéocodage d'adresse texte vers coordonnées GPS. Source : Base Adresse Nationale (BAN).
{ "q": "20 avenue de Ségur, Paris" }address_reverseGratuitReverse geocoding : coordonnées GPS vers adresse postale normalisée.
{ "lat": 48.8584, "lon": 2.2945 }address_risksGratuitRisques naturels et technologiques à une adresse via Géorisques : inondations, séismes, ICPE, mouvements de terrain…
{ "address": "20 avenue de Ségur, Paris" }address_validateGratuitValide 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": "20 avenue de Ségur Paris" }address_batchGratuitGé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": ["20 avenue de Ségur Paris", "1 place du Capitole Toulouse"] }Découpage administratif
8 toolsadmin_commune_searchGratuitCherche une commune française par nom, code postal ou code de département.
{ "nom": "Lyon" }admin_commune_getGratuitFiche complète d'une commune par code INSEE : population, coordonnées, département, région.
{ "code": "75056" }admin_departement_listGratuitListe des 101 départements français. Filtrable par code région.
admin_departement_communesGratuitToutes les communes d'un département avec population et codes INSEE.
{ "code": "69" }admin_region_listGratuitListe des 18 régions françaises avec chefs-lieux et codes.
admin_epci_listGratuitListe des EPCIs (intercommunalités) par département.
{ "code_departement": "69" }admin_epci_communesGratuitCommunes membres d'un EPCI par code intercommunalité.
{ "code": "200046977" }commune_statsGratuitStatistiques 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_code": "75056" }Immobilier
2 toolsrealestate_transactionsGratuitTransactions 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.
{ "postal_code": "75008", "type_bien": "Appartement", "price_min": 200000 }realestate_statsGratuitPrix médian, moyen, min, max au m² pour une commune. Segmenté Maison / Appartement. Basé sur les données DVF.
{ "insee_code": "75056", "sample_size": 200 }Identité & TVA
4 toolsvat_validateGratuitValidation TVA intracommunautaire via VIES pour les 27 pays de l'UE. Temps réel.
{ "vat_number": "FR76552032534" }lei_searchGratuitRecherche le LEI (Legal Entity Identifier) mondial d'une entité par nom.
{ "legal_name": "BNP Paribas" }lei_lookupGratuitFiche complète par code LEI (GLEIF).
{ "lei": "R0MUWSFPU8MPRO8K5P83" }company_vat_checkGratuitDé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": "552032534" }Brevets
2 tools · BYOK EPOpatents_searchBYOK EPORecherche de brevets mondiaux EPO Espacenet en syntaxe CQL. Champs : ti (titre), ab (abrégé), pa (déposant), in (inventeur), cl (classification IPC).
{ "query": "ti=machine learning AND pa=BNP" }patent_getBYOK EPOFiche complète d'un brevet par numéro de publication EPO.
{ "country": "EP", "doc_number": "1000000", "kind": "A1" }Emploi
2 tools · BYOK France Travailjobs_searchBYOK France TravailOffres d'emploi France Travail. Filtres : mots-clés, lieu, type de contrat (CDI/CDD/intérim).
{ "keywords": "développeur TypeScript", "location": "Paris" }rome_searchBYOK France TravailCodes ROME par libellé de métier. Utile pour qualifier des offres ou des profils.
{ "query": "développeur logiciel" }Marchés publics
2 toolspublic_contracts_searchGratuitMarchés publics DECP. Filtres : titulaire (SIREN), acheteur (SIRET), code CPV, département, plage de dates, montant minimum.
{ "siren_titulaire": "552032534", "limit": 20 }area_business_intelligenceGratuitIntelligence économique territoriale : entreprises actives + marchés publics + transactions immobilières + données admin par département ou commune.
{ "departement": "75" }Sources
1 toolsources_listGratuitListe les 16 sources avec ID, licence, TTL de cache, et statut de configuration en temps réel.