Connecter un assistant IA (MCP)

Leadfox expose un serveur Model Context Protocol (MCP). Tout assistant IA compatible MCP (Claude, Cursor, Gemini, ChatGPT, vos propres agents) peut s'y connecter et lire vos données Leadfox : contacts, listes, campagnes, emails, automatisations, landing pages, popups, formulaires, publicités et leurs métriques.

URL du serveur	https://mcp.leadfox.co/mcp
Transport	Streamable HTTP
Authentification	OAuth 2.1 (authorization code + PKCE), dynamic client registration
Scopes	api:read, api:write

info

Aucune clé API n'est nécessaire. Vous vous connectez avec votre utilisateur Leadfox habituel et choisissez les comptes auxquels l'assistant a accès. L'assistant ne voit jamais votre mot de passe Leadfox.

Connexion depuis votre client

Ajoutez l'URL du serveur dans votre client, puis complétez la connexion qui s'ouvre dans votre navigateur.

Claude

Dans Claude (web ou application de bureau), ouvrez Settings → Connectors → Add custom connector.

Champ	Valeur
Name	Leadfox
Remote MCP server URL	https://mcp.leadfox.co/mcp

Cliquez sur Add, puis sur Connect pour lancer la connexion. Une fois connecté, activez le connecteur Leadfox dans le menu des outils de la conversation.

Claude Code

claude mcp add --transport http leadfox https://mcp.leadfox.co/mcp

Ensuite, dans une session, lancez /mcp et sélectionnez leadfox pour démarrer la connexion.

Cursor

Ajoutez le serveur dans .cursor/mcp.json (projet) ou ~/.cursor/mcp.json (global) :

{
    "mcpServers": {
        "leadfox": {
            "url": "https://mcp.leadfox.co/mcp"
        }
    }
}

Ouvrez Settings → MCP, puis cliquez sur Connect à côté de leadfox pour démarrer la connexion.

Gemini CLI

Ajoutez le serveur dans ~/.gemini/settings.json :

{
    "mcpServers": {
        "leadfox": {
            "httpUrl": "https://mcp.leadfox.co/mcp"
        }
    }
}

Lancez ensuite /mcp auth leadfox dans Gemini CLI pour démarrer la connexion.

Autres clients

Tout client qui supporte les serveurs MCP distants en Streamable HTTP avec OAuth fonctionne. Pointez-le vers https://mcp.leadfox.co/mcp.

Le serveur annonce son authorization server via les documents de discovery standards. Les clients qui implémentent la spécification d'autorisation MCP s'enregistrent eux-mêmes et ouvrent la connexion automatiquement :

GET https://mcp.leadfox.co/.well-known/oauth-protected-resource/mcp
GET https://app.leadfox.co/.well-known/oauth-authorization-server

Autoriser l'accès

La connexion s'ouvre dans votre navigateur et se fait en quatre étapes :

1. Connectez-vous avec votre utilisateur Leadfox. Si vous êtes déjà connecté sur app.leadfox.co, cette étape est sautée.
2. Sélectionnez les comptes. Choisissez, parmi les comptes Leadfox que vous gérez, ceux auxquels l'assistant peut accéder. Tous les comptes inclut aussi les comptes qui vous seront ajoutés plus tard ; Comptes sélectionnés est une liste fixe.
3. Vérifiez les permissions demandées et les comptes, puis cliquez sur Autoriser.
4. Retournez dans votre client. Le navigateur confirme la connexion ; l'assistant peut maintenant appeler les outils Leadfox.

remarque

L'assistant agit en votre nom. Il est limité par votre propre Role dans chaque compte, exactement comme si vous utilisiez l'application.

La connexion reste active tant que l'assistant l'utilise. Une connexion inutilisée pendant 90 jours expire et vous devrez vous reconnecter.

Travailler avec les comptes

Chaque outil est limité à un seul compte Leadfox et prend un account_id. Un assistant devrait toujours commencer par search_accounts, qui liste les comptes autorisés avec leur nom, site web et ID, puis passer l'ID choisi aux autres outils.

Si vous gérez un seul compte, l'assistant l'utilisera simplement. Si vous en gérez plusieurs, nommez celui que vous visez dans votre demande (« dans le compte Acme, liste les campagnes des 30 derniers jours »).

Outils disponibles

Tous les outils sont actuellement en lecture seule et requièrent le scope api:read. Le scope api:write est réservé aux futurs outils qui créent ou modifient des données ; un token qui ne le porte pas est refusé par chaque outil d'écriture.

Entité	Outils
Comptes	search_accounts
Contacts	search_contacts, get_contact
Listes de contacts	search_contact_lists, get_contact_list, get_contact_list_members, count_contact_list_members
Propriétés de contact	search_contact_properties, get_contact_property
Campagnes	search_campaigns, get_campaign, get_campaign_metrics
Emails (envois)	search_emails, get_email, get_email_variant, get_email_metrics, get_email_variant_metrics
Automatisations	search_automations, get_automation
Emails d'automatisation	search_autoemails, get_autoemail, get_autoemail_variant, get_autoemail_metrics, get_autoemail_variant_metrics
Landing pages	search_pages, get_page, get_page_variant, get_page_metrics, get_page_variant_metrics
Popups	search_popups, get_popup, get_popup_variant, get_popup_metrics, get_popup_variant_metrics
Formulaires	search_forms, get_form, get_form_variant, get_form_metrics, get_form_variant_metrics
Publicités Facebook	search_facebook_ads, get_facebook_ad, get_facebook_ad_metrics
Domaines	search_domains, get_domain, get_root_domain, search_subdomains, search_active_domains, get_active_domain_by_name, search_email_sending_domains, get_email_sending_domain, get_selected_email_tracking_domain

Les outils search_* paginent avec skip et limit, et la plupart acceptent une option sort avec la même syntaxe que l'API REST (voir API basics). Les contacts se cherchent en texte libre ; les membres d'une liste acceptent en plus des filters.

Votre client affiche la description complète et le schéma d'entrée de chaque outil une fois connecté.

Limites

Chaque utilisateur Leadfox est limité à 120 requêtes par minute, partagées entre tous les assistants qu'il a connectés. Au-delà, les appels échouent avec une erreur 429 Too Many Requests jusqu'à la fin de la fenêtre.

Révoquer l'accès

Ouvrez Modifier mon profil > Applications connectées et cliquez sur Déconnecter à côté de l'assistant. Ses tokens sont invalidés immédiatement ; l'assistant devra refaire la connexion pour se reconnecter.

Dépannage

Symptôme	Quoi faire
Le client signale 401 Unauthorized ou redemande sans cesse de se connecter	La connexion a expiré ou a été révoquée. Retirez le serveur du client et ajoutez-le de nouveau pour relancer la connexion.
Un outil répond ... requires the api:write scope	L'outil modifie des données et votre connexion est en lecture seule. Les outils d'écriture ne sont pas encore disponibles.
Un outil répond que account_id est manquant ou inconnu	Demandez à l'assistant d'appeler search_accounts d'abord, ou nommez le compte dans votre demande. Le compte doit faire partie de ceux sélectionnés lors de l'autorisation.
429 Too Many Requests	Attendez une minute et réessayez. Demandez à l'assistant de restreindre ses recherches et de garder un limit petit plutôt que de tout récupérer.
Un compte Leadfox manque dans la liste de l'assistant	Vous avez autorisé une liste fixe de comptes. Révoquez la connexion et autorisez de nouveau en choisissant Tous les comptes ou en ajoutant le compte manquant.