API & MCP

Votre prospection Prosperian, depuis Claude ou par API

Pilotez votre prospection B2B depuis Claude, ou automatisez-la depuis vos outils.

Connecter mon assistant IAIntégrer l'API HTTP

Clé API, documentation et serveur MCP inclus dans toutes les offres. Certaines fonctions avancées sont réservées à l'offre Entreprise. Voir les tarifs

Connecter votre assistant IA (MCP)

Il vous faut un compte Prosperian et le rôle administrateur de l'organisation à brancher.

Vous demandez

« Liste mes campagnes actives »

Claude appelle l'outil list_campaigns sur votre organisation et vous répond avec vos campagnes.

Sur claude.ai

  1. Ouvrez Réglages, puis Connecteurs, puis Ajouter un connecteur personnalisé.
  2. Collez l'URL du serveur ci-dessous. Laissez les champs Client ID et Client Secret vides.
  3. Connectez-vous à Prosperian, choisissez l'organisation, puis approuvez.
  4. Demandez à Claude : « Liste mes campagnes actives ». Vous voyez vos campagnes actives, ou une liste vide si aucune ne l'est.

URL du serveur MCP

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

Dans Claude Code

Claude Code installé, ajoutez le serveur :

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

Puis, dans Claude Code, tapez /mcp, choisissez prosperian et connectez-vous à Prosperian (même consentement administrateur que sur claude.ai).

Le connecteur s'authentifie par OAuth : ne collez pas de clé API dans le connecteur. La clé API sert à l'API HTTP.

Quatre actions attendent votre validation avant de s'exécuter : rattacher des prospects, activer une séquence, enrichir un contact, enrichir une liste. Vous les approuvez dans Prosperian, sous Agent, puis À valider.

Si ça ne marche pas

  • « Couldn't reach the MCP server » : l'URL doit être exactement celle ci-dessus, sans barre oblique finale.
  • Consentement refusé : seul un administrateur de l'organisation peut approuver le connecteur.

Intégrer l'API HTTP

Il vous faut un compte Prosperian et le rôle administrateur de l'organisation pour créer une clé.

Votre clé

Dans l'application : Paramètres, puis API et développeurs. La création d'une clé est réservée aux administrateurs.

Pas administrateur ? Demandez à un administrateur de votre organisation.

Le secret ne s'affiche qu'une fois : enregistrez-le à la création.

Ouvrir Prosperian pour créer une cléCréer une clé, pas à pas

Votre première requête

  • Une lecture seule, sans effet de bord.
  • Clés live uniquement : il n'existe pas de clé de test.

bash / zsh

read -rs PROSPERIAN_API_KEY && export PROSPERIAN_API_KEY

Collez votre clé quand le terminal attend, puis Entrée : elle ne s'affiche pas et ne reste pas dans l'historique. Script, CI ou agent : définissez plutôt PROSPERIAN_API_KEY dans l'environnement.

curl -sS -w '\nHTTP %{http_code}\n' https://app.prosperian.co/api/copilot/stats/list \
  -H "X-API-Key: $PROSPERIAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":1}'

Nécessite la saisie de la clé ci-dessus.

Sous Windows, importez la spécification OpenAPI dans Postman.

Exemple de réponse : organisation sans campagne

{ "campaigns": [], "limit": 1 }
HTTP 200

Cet exemple renvoie au plus une campagne (limit: 1) ; augmentez limit pour en voir plus. Première requête dans la référence

Si ça ne marche pas

Lisez d'abord le statut HTTP. Les champs code et ref sont présents sur la plupart des erreurs, pas sur toutes.

StatutCauseQue faire
401Clé absente, invalide ou révoquée.Vérifiez que la variable PROSPERIAN_API_KEY est définie dans ce terminal et que l'en-tête X-API-Key est présent, puis recréez la clé si besoin.
403Clé d'une autre organisation, ou fonction pas encore ouverte ou pas approuvée pour la vôtre.Lisez le message error de la réponse (et le champ code quand il est présent) : il dit lequel des cas, la référence explique quoi faire.
402Crédits insuffisants pour l'opération demandée.Rechargez vos crédits, puis relancez.
500Erreur côté serveur.Contactez le support avec l'heure de l'appel et la ref si la réponse en contient une. Contacter le support

Gestion des erreurs

Ce que l'API couvre

Webhooks sortants

Prosperian peut notifier vos outils (n8n, Make, Zapier) à chaque événement, avec une signature à vérifier. Notifications sortantes

Ressources

Pas encore client ? Lancez votre agent, la clé API est incluse

Lancer mon agent gratuitementDemander une démo

Essai gratuit · Prêt en quelques minutes · Résiliation à tout moment