Documentation OneMCP

⚡ 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" }
    }
  }
}

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":"..."}}

Tools natifs Lemlist & Apollo.io

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

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.