Documentación de OneMCP

Claude Desktop / Claude Code

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

Modo alojado (API key)

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

1. Obtener una clave API

Regístrese en onemcp.fr/#signup — 1000 llamadas/mes gratis, sin tarjeta bancaria. Guarda la clave mostrada (no volverá a verse).

2. Importar la spec en GPT Builder

En ChatGPT → Explore GPTs → Create → Configure → Actions → Import from URL, pega:

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

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

3. Añadir las instrucciones del sistema

Tienes acceso a OneMCP vía la acción call_onemcp_tool.
Úsala para cualquier consulta sobre empresas francesas,
direcciones, contratación pública, inmobiliario, IVA UE o patentes.
Parámetro: {"tool":"company_search","params":{"query":"..."}}

Tools nativas de Lemlist & Apollo.io

Agregue el conector, y las herramientas aparecen automáticamente en tools/list, con namespace <conector>__<herramienta>.

Cualquier API REST

Cualquier conector con una base_url (del catálogo o custom) expone un tool genérico <conector>__http_request — método, ruta, query y body a elección. Ideal para un servicio sin tools nativas dedicadas (HubSpot, Airtable, Stripe, Brevo, Slack, Notion, GitHub, Linear, Firecrawl, Apify…).

Proxy MCP universal

Registre la URL de un servidor MCP de terceros ya alojado (Notion, GitHub Copilot, Apollo, Stripe, Linear…) — sus herramientas se fusionan en su /mcp, con namespace y cacheados 5 minutos.

OAuth2 — conexión en 1 clic

Algunos conectores (p. ej., Google Drive) utilizan la app OAuth de OneMCP — haga clic en "Conectar", autorice, listo. Para otros, traiga su propia app OAuth2 (client_id/secret) a través del formulario de conector personalizado.

OAuth2 en /mcp (ChatGPT Apps, Codex)

Además de las claves API mk_live_..., /mcp acepta la autenticación OAuth2 estándar (RFC 7591/8414) — necesaria para el modo «OAuth» del portal OpenAI Apps. Ambos modos funcionan en paralelo, sin migración para tus claves existentes.