Connecteur MCP

Prosperian expose un serveur MCP (Model Context Protocol) : un client compatible — claude.ai, Claude Code — s'y branche et pilote la plateforme en langage naturel.

Il vous faut un compte Prosperian, et le rôle administrateur dans l'organisation que vous voulez brancher. Le connecteur ne crée pas de compte : il donne accès au vôtre. Se connecter.

L'URL à coller

https://app.prosperian.co/api/mcp

Sur claude.ai : Réglages → Connecteurs → Ajouter un connecteur personnalisé, puis cette URL. Laissez les champs « Client ID » et « Client Secret » vides : le serveur enregistre votre client automatiquement (RFC 7591), il n'y a rien à copier.

Ce qui se passe quand vous vous branchez

La première étape est invisible — le client et le serveur négocient seuls. Les trois suivantes vous demandent quelque chose, et ce sont les seules où ça peut coincer.

Le client appelle https://app.prosperian.co/api/mcp, reçoit un 401, suit le pointeur qu'il porte et lit les métadonnées de découverte (https://app.prosperian.co/.well-known/…). Il s'enregistre comme client public.
Il vous envoie sur l'écran de consentement. Si vous n'êtes pas connecté, on vous demande d'abord de vous connecter — c'est le point où l'on croit le plus souvent que « ça ne marche pas ».
Vous choisissez l'organisation à brancher. Elle est figée à cet instant : le jeton la portera jusqu'à sa révocation, même si vous changez d'organisation active ensuite.
Vous approuvez. Le client échange son code contre un jeton, avec PKCE S256.

Le consentement est réservé aux administrateurs de l'organisation. Un connecteur remet à un tiers un accès durable qui se renouvelle seul : c'est autre chose qu'une clé qu'on copie et qu'on garde.

Si le client répond « Couldn't reach the MCP server », c'est presque toujours l'URL : elle doit être exactement celle ci-dessus, sans barre oblique finale ajoutée.

Portée du jeton

Le jeton ne vaut que pour ce serveur MCP : il est frappé pour cette URL précise et refusé ailleurs. Il porte le périmètre d'une clé API, sur l'organisation choisie à l'écran de consentement.

Les actions qui attendent votre validation

4 outils ne s'exécutent pas au premier appel. Ils déposent une demande de validation, et le client doit les rappeler une seconde fois une fois que vous avez approuvé :

attach_prospects — Rattache une liste de prospects à une séquence pour qu’ils y entrent.
start_sequence — Active une séquence pour qu’elle commence à envoyer. La mise en pause, elle, s’applique IMMÉDIATEMENT — arrêter des envois n’attend pas. Seule l’ACTIVATION attend votre validation : une séquence annoncée comme lancée peut n’être qu’en attente.
enrich_contact — Retrouve l’email et/ou le téléphone d’un contact à partir de son nom et de son entreprise. Consomme des crédits (email ≈ 1, téléphone ≈ 10).
enrich_list — Enrichit tous les prospects d’une liste existante. Consomme des crédits par prospect résolu (email ≈ 1, téléphone ≈ 10).

L'approbation se donne dans Prosperian, sous Agent → À valider — pas dans la conversation.

Ces garde-fous ne couvrent pas que les crédits : certains de ces outils n'en dépensent aucun mais envoient des emails à de vrais prospects.

Les 12 outils

Outil	Ce qu'il fait
`find_leads`	Trouve des prospects B2B à partir d’une description en langage naturel (« fondateurs fintech à Londres ») et crée la liste correspondante.
`create_campaign`	Crée une séquence sortante et ses étapes. Rien n’est envoyé à ce stade : la séquence est créée à l’arrêt.
`attach_prospects`	Rattache une liste de prospects à une séquence pour qu’ils y entrent. (validation requise)
`start_sequence`	Active une séquence pour qu’elle commence à envoyer. La mise en pause, elle, s’applique IMMÉDIATEMENT — arrêter des envois n’attend pas. (validation requise)
`enrich_contact`	Retrouve l’email et/ou le téléphone d’un contact à partir de son nom et de son entreprise. Consomme des crédits (email ≈ 1, téléphone ≈ 10). (validation requise)
`enrich_list`	Enrichit tous les prospects d’une liste existante. Consomme des crédits par prospect résolu (email ≈ 1, téléphone ≈ 10). (validation requise)
`get_campaign_stats`	Mesures d’une campagne : entonnoir et paliers d’engagement. Lecture en direct.
`list_campaigns`	Liste les campagnes de l’organisation pour en retrouver les identifiants. Les compteurs affichés sont approchés.
`get_org_stats`	Vue d’ensemble de l’organisation : crédits restants, prospects, listes, campagnes et rendez-vous obtenus.
`get_activity_report`	Rapport d’activité par commercial, séquence ou liste sur une période : tâches, rendez-vous, appels, emails et issues d’appel.
`get_objections`	Répartition des objections par catégorie et par canal, à partir des réponses reçues et des issues d’appel.
`get_response_heatmap`	Meilleurs moments de contact par canal et par créneau. Email et LinkedIn rendent un taux de réponse, le téléphone un taux de décroché — le champ `metric` dit lequel, et les deux ne se comparent pas entre eux.

Retirer un connecteur

Paramètres → API et développeurs → Connecteurs MCP liste ce qui est branché : quel client, par qui, quand, et son dernier appel. Révoquer coupe l'accès immédiatement ; vos clés API ne sont pas affectées.

Claude Code

Le connecteur OAuth marche aussi en ligne de commande :

claude mcp add --transport http prosperian https://app.prosperian.co/api/mcp