Passer au contenu principal

Présentation

Nudgen héberge un serveur MCP sur /mcp à l’origine de votre application. Il prend en charge MCP 2026-07-28 via Streamable HTTP et exige OAuth 2.1. Connectez-vous dans le navigateur et approuvez les autorisations demandées. Lorsque cette option est disponible, choisissez un espace de travail ou autorisez explicitement tous les espaces actuels et futurs dont vous êtes membre. Changer d’espace dans le tableau de bord ne modifie pas celui utilisé par défaut par MCP.

Travailler dans plusieurs espaces

Les connexions existantes restent limitées à leur espace initial jusqu’à une nouvelle connexion avec un consentement élargi. Avec l’accès à tous les espaces, les nouvelles adhésions deviennent automatiquement disponibles. La perte d’une adhésion bloque les actions suivantes dans cet espace. Les rôles, abonnements et quotas restent propres à chaque espace. Utilisez list_workspaces avec page et pageSize pour consulter les identifiants, noms, slugs, rôles et l’espace par défaut. La portée teams:read est requise. Ajoutez workspaceId à un appel d’outil pour choisir un espace uniquement pour cette action. Sans cet argument, la connexion utilise son espace par défaut. Utilisez le même identifiant explicite pour examiner et envoyer une campagne. Choisissez l’espace par défaut lors du consentement OAuth. Modifiez-le dans Paramètres → Clés API → Applications MCP connectées ou avec set_default_workspace, workspaceId et la portée teams:write. Ce changement s’applique à toutes les conversations utilisant la connexion. Un choix ponctuel ne modifie pas la valeur par défaut. Si cet espace est supprimé ou inaccessible, indiquez un autre identifiant ou modifiez la valeur par défaut. Nudgen ne choisit jamais un remplacement silencieusement.
Les URI existants utilisent l’espace par défaut. Ces modèles ciblent un espace explicitement :

Pourquoi c’est important

Votre assistant peut consulter les contacts, rechercher des entreprises et créer des brouillons de campagnes. Autorisez un envoi ou une programmation dans le chat. Il exécute directement votre demande, sans lien d’approbation dans le navigateur.

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. Utilisez campaigns:read pour consulter, campaigns:write pour les brouillons et modifications, et campaigns:send pour les actions d’envoi autorisées. Le consentement OAuth reste obligatoire.
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 (one-time, drip ou lifetime). 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.

Lancer une campagne en brouillon

  1. Vérifiez le nom, l’objet, le contenu, l’expéditeur effectif, le nombre estimé de destinataires et l’horaire avec get_campaign.
  2. Autorisez l’action dans le chat. L’assistant appelle directement launch_campaign avec l’ID et soit sendNow: true, soit scheduledAt avec une date future et un fuseau horaire. Ne combinez pas des horaires contradictoires. Une autorisation déjà donnée ne nécessite pas de nouvelle confirmation.
  3. Consultez le statut, l’horaire programmé et le lien vers le dashboard retournés. En file ou programmé ne signifie pas livré. Vérifiez get_campaign et get_campaign_stats avant de réessayer si le résultat est incertain.
Nudgen vérifie toujours les droits du workspace, l’expéditeur, les destinataires admissibles, l’abonnement, le quota, la version de campagne et la file. Créer ou modifier enregistre uniquement un brouillon ; la livraison nécessite le worker de campagnes.

Gérer les accès

Ouvrez Paramètres → Clés API → Applications MCP connectées pour consulter l’accès, changer l’espace par défaut ou déconnecter l’application. Déconnecter une connexion multi-espaces révoque ses jetons et codes d’autorisation en attente pour tous les espaces sans déconnecter les connexions REST distinctes. OAuth REST et l’assistant intégré conservent leurs limites actuelles.

Dépannage

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

Rayon de recherche et enrichissement

Les recherches API et MCP utilisent 5 km par défaut et acceptent un entier radiusKm de 1 à 100, sans dialogue de confirmation. Conservez les mêmes paramètres avec pageToken fourni par nextPageToken. Une page vide peut encore avoir une page suivante. enrichmentPending indique une recherche de site encore en cours. Consultez businessSummary et businessSources lorsqu’ils sont disponibles. Le contexte importé peut aider à personnaliser les introductions des campagnes. Une adresse e-mail absente peut encore être en cours de recherche. Avec enrichmentRetryToken, appelez retry_map_leads_enrichment avec token et la portée campaigns:read. Le jeton est lié au workspace connecté, expire après 15 minutes et ne sert qu’une fois. Fusionnez par placeId avant import. emailOnly filtre la réponse actuelle ; des leads peuvent apparaître après la nouvelle tentative.

Modifier les brouillons et couverture

Utilisez update_campaign pour modifier un brouillon existant et delete_campaign pour le supprimer. Les deux nécessitent campaigns:write ; aucun ne lance ni ne programme d’envoi. Les nouveaux domaines du produit nécessitent leurs propres autorisations OAuth. Reconnectez-vous et approuvez ces autorisations lorsque cela vous est demandé. La liste des outils indique les outils disponibles et leurs paramètres. Un lien vers le navigateur n’exécute aucune action. Utilisez le navigateur pour les paiements, l’autorisation des fournisseurs, les invitations, la création/suppression/adhésion aux espaces et les réglages de versement sensibles. Le ciblage MCP et son espace par défaut ne changent pas l’espace du tableau de bord. L’administration, les identifiants, les webhooks, les callbacks de suivi et l’assistant interne sont exclus. Consultez la couverture avec get_api_capabilities. Après autorisation dans le chat, appelez directement send_test_email, activate_lifetime_campaign ou trigger_lifetime_campaign. Les tests sont envoyés uniquement à l’adresse du compte. Activer lifetime permet les futurs envois automatiques. Aucun lien ni ID d’approbation n’est nécessaire. Vérifiez le statut ou l’historique avant de réessayer un résultat incertain.