Skip to main content

​
Présentation

Nudgen héberge un serveur MCP sur le point de terminaison /mcp de l’origine de votre application. Il utilise MCP 2026-07-28 via Streamable HTTP et exige OAuth 2.1. Connectez un client compatible avec ce transport. Connectez-vous à Nudgen dans votre navigateur, choisissez un espace de travail et approuvez les autorisations demandées par le client. La connexion reste associée à cet espace de travail, même si vous changez ensuite d’espace de travail dans le tableau de bord.

​
Pourquoi c’est important

Votre assistant peut consulter les contacts et les campagnes, trouver des entreprises à proximité, rédiger du contenu et préparer le lancement d’une campagne sans gérer de session du tableau de bord ni de jeton d’accès personnel. Vous examinez chaque envoi réel ou planification dans votre navigateur avant son exécution.

​
Connecter votre client

Le point de terminaison de production est :
Ajoutez-le comme serveur MCP HTTP distant dans un client compatible avec OAuth. Le client découvre le serveur d’autorisation de Nudgen à partir du point de terminaison et ouvre un processus de connexion et de consentement dans le navigateur. Sélectionnez l’espace de travail auquel le client doit accéder et n’approuvez que les portées dont il a besoin. Documents de découverte : Le serveur d’autorisation utilise le code d’autorisation avec PKCE S256, la liaison à la ressource et la rotation des jetons d’actualisation. Il accepte les documents de métadonnées d’ID client et l’enregistrement dynamique des clients. Pour Codex CLI, utilisez :
Si un client nommé nudgen est déjà configuré, mettez à jour cette entrée avec l’URL /mcp. Si vous devez uniquement consulter des données, demandez campaigns:read. Ajoutez campaigns:write lorsque le client doit modifier des contacts, des brouillons, des paramètres de marque ou des prospects importés. Ajoutez campaigns:send uniquement lorsque le client doit demander l’approbation d’un lancement.
Les jetons d’accès personnels authentifient l’API de développeur, mais pas /mcp. Un client MCP doit suivre le processus de connexion OAuth.

​
Outils disponibles

create_campaign enregistre un brouillon de campagne ponctuelle. Il ne peut pas envoyer ni planifier directement la campagne. get_campaign vous permet de vérifier l’objet, le contenu, le lien, l’audience et l’expéditeur avant le lancement. Le serveur expose également des ressources en lecture seule avec campaigns:read :

​
Trouver et importer des prospects depuis la carte

  1. Demandez à l’assistant d’appeler search_map_leads avec un lieu et des mots-clés d’entreprise, par exemple une ville et marketing agency.
  2. Les filtres facultatifs sont radiusKm (1 à 100), lat et lng, ainsi que emailOnly pour ne conserver que les entreprises qui publient une adresse e-mail.
  3. Lorsque le résultat contient nextPageToken, transmettez-le comme pageToken pour charger une autre page.
  4. Demandez à l’assistant d’appeler import_map_leads avec les mêmes lieu et mots-clés, ainsi que les objets de prospect à enregistrer. Chaque appel accepte jusqu’à 200 prospects.
L’importation crée des contacts dans l’espace de travail connecté. Les prospects sans adresse e-mail sont ignorés. Un prospect déjà existant est mis à jour.

​
Approuver le lancement d’une campagne

  1. Demandez à l’assistant d’examiner le brouillon avec get_campaign.
  2. Demandez-lui d’appeler prepare_campaign_launch avec l’ID de la campagne et l’heure exacte d’envoi immédiat ou planifié souhaitée. L’appel renvoie une URL d’approbation à usage unique ; aucun e-mail n’est encore envoyé.
  3. Ouvrez l’URL, vérifiez l’espace de travail, l’estimation du nombre de destinataires, le contenu, l’expéditeur et l’heure, puis cliquez sur Approuver le lancement.
  4. Revenez au client afin qu’il appelle launch_campaign avec le même ID de campagne, la même heure et le même approvalId.
Une approbation expire après 10 minutes et ne peut être utilisée qu’une fois. Si la campagne ou l’expéditeur change, demandez une nouvelle approbation. Lors du lancement, Nudgen vérifie à nouveau que l’expéditeur est prêt, que les destinataires sont admissibles, que l’abonnement et le quota sont suffisants, et que la file d’attente est disponible. La livraison ne commence qu’après le traitement du lancement par le worker de campagne.
L’approbation et la finalisation de launch_campaign peuvent envoyer de vrais e-mails. Utilisez le processus d’envoi de test du tableau de bord pour vérifier un aperçu dans votre boîte de réception avant d’approuver l’envoi à une audience réelle.

​
Gérer les accès

Ouvrez Paramètres → Clés API → Applications MCP connectées pour voir l’espace de travail et les portées de chaque client connecté. Révoquez une connexion depuis cette page si elle ne doit plus avoir accès. La révocation désactive ses jetons et ses approbations de lancement en attente. Vous pourrez rétablir la connexion via OAuth ultérieurement. Les autorisations OAuth sont valides pendant 90 jours au maximum. La perte d’accès à un espace de travail empêche également le client d’utiliser la connexion associée à cet espace.

​
Dépannage

Pour les scripts qui utilisent des jetons porteurs et des points de terminaison REST directs, consultez l’API de développeur.