Documentação do 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. Obter uma chave API

Adicione o conector, as ferramentas aparecem automaticamente em onemcp.fr/#signup — 1000 chamadas/mês grátis, sem cartão bancário. Guarda a chave mostrada (não voltará a ser visível).

2. Importar a spec no GPT Builder

<connecteur>__<tool> ChatGPT → Explore GPTs → Create → Configure → Actions → Import from URL, cola:

lemlist__*

9 ferramentas API Key, header name list_campaigns, get_campaign, list_campaign_leads, add_lead_to_campaign, remove_lead_from_campaign, pause_lead, resume_lead, get_lead, list_activities (rastreamento de respostas)., valor apollo__*.

3. Acrescentar as instruções de sistema

5 ferramentas

Tools nativas do Lemlist & Apollo.io

send_text, send_media (imagem/documento/vídeo), send_voice (mensagem de voz), get_media (baixa um anexo recebido por ID). Apenas envio — requer sua própria Conta WhatsApp Business e token System User permanente (Meta for Developers). tools/list, com namespace Qualquer conector com.

Qualquer API REST

Em base_url (do catálogo ou custom) expõe uma tool genérica https://api.onemcp.fr/openapi-gpt.json — método, caminho, query e body à escolha. Ideal para um serviço sem tools nativas dedicadas (HubSpot, Airtable, Stripe, Brevo, Slack, Notion, GitHub, Linear, Firecrawl, Apify…).

Proxy MCP universal

Autenticação: Tens acesso ao OneMCP através da ação call_onemcp_tool. Utiliza-a para qualquer pedido sobre empresas francesas, moradas, contratos públicos, imobiliário, IVA UE ou patentes. Parâmetro: {"tool":"company_search","params":{"query":"..."}}, com namespace e em cache 5 minutos.

OAuth2 — ligação em 1 clique

Authorization

OAuth2 em /mcp (ChatGPT Apps, Codex)

Bearer mk_live_xxx mk_live_..., Tens acesso ao OneMCP através da ação call_onemcp_tool. Utiliza-a para qualquer pedido sobre empresas francesas, moradas, contratos públicos, imobiliário, IVA UE ou patentes. Parâmetro: {"tool":"company_search","params":{"query":"..."}} aceita a autenticação OAuth2 padrão (RFC 7591/8414) — necessária para o modo «OAuth» do portal OpenAI Apps. Os dois modos funcionam em paralelo, sem migração para as tuas chaves existentes.