Documentation du serveur MCP

Connectez votre agent à tous les outils Vayne

Le serveur MCP Vayne permet aux agents IA — Claude, Cursor et tout client compatible MCP — d'utiliser chaque fonctionnalité de l'API Vayne sous forme d'outils : scraping Sales Navigator, scraping de profils et d'entreprises, scraping d'offres d'emploi et de posts, recherche inversée d'email et enrichissement email & téléphone. Cette page couvre les détails de connexion, la configuration par client, le catalogue d'outils, les crédits et les webhooks.

Découvrir le MCP Vayne

Transport: Streamable HTTP, hébergé et sans état
Authentification: Connexion OAuth, ou un jeton API Bearer
Offres: Accès API à partir de Starter, mêmes crédits
Outils: Plus de 30 outils, découverts automatiquement

Configuration

Détails de connexion

Le serveur MCP Vayne est un service HTTP hébergé et sans état — rien à installer ni à faire tourner vous-même.

Transport: Streamable HTTP
En-tête d'authentification (clients par token uniquement): Authorization: Bearer <YOUR_TOKEN>

URL du serveur

https://mcp.vayne.io/mcp

Deux façons de s'authentifier. OAuth est la voie par défaut pour Claude : Claude Desktop, Claude.ai, Claude Code et Cursor n'ont besoin que de l'URL du serveur — ils vous redirigent vers Vayne pour vous connecter et autoriser l'accès, et ne stockent aucun token sur votre machine. Pour mettre fin à une connexion OAuth, supprimez le connecteur dans le client ; les tokens d'accès qu'il détient sont de courte durée et expirent d'eux-mêmes. Tous les autres clients envoient un token API Vayne dans l'en-tête Authorization.

L'utilisation du MCP nécessite un plan avec accès API (Starter et au-dessus), connexions OAuth comprises : sur un plan inférieur, le connecteur s'autorise quand même, mais chaque appel d'outil renvoie « Plan does not include API access ». Récupérez ou régénérez votre token API dans l'app Vayne, dans les Paramètres API ; les utilisateurs connectés trouveront aussi des configurations client prêtes à l'emploi dans la fenêtre Configuration MCP de chaque page de fonctionnalité.

🤖 Donnez cette documentation à votre agent IA

Le guide agent complet — chaque outil, le modèle de crédits, les webhooks et le glossaire des colonnes d'export — est publié en une seule page markdown. Copiez-le et collez-le dans n'importe quel assistant IA, ou donnez l'URL brute à votre agent.

Voir le markdown brut

Astuce : Les clients MCP découvrent les outils automatiquement à la connexion — le guide est du contexte supplémentaire qui aide votre agent à choisir le bon outil et à estimer les coûts avant de dépenser des crédits.

Configuration par client

Choisissez votre client ci-dessous. Claude Desktop, Claude.ai, Claude Code et Cursor peuvent se connecter à Vayne via OAuth — rien à copier hormis l'URL du serveur. Les autres extraits attendent votre token API à la place de <YOUR_TOKEN>.

Claude Desktop (recommandé)

Claude Desktop se connecte directement au serveur Vayne. Aucun fichier de configuration à modifier, aucun token API à copier et rien à installer — seulement l'URL du serveur et votre identifiant Vayne.

Dans Claude Desktop, ouvrez Réglages → Connecteurs.
Cliquez sur Ajouter un connecteur personnalisé en bas de la liste.
Nommez-le Vayne et collez l'URL du serveur ci-dessous.
Cliquez sur Ajouter, puis sur Se connecter — Claude ouvre Vayne dans votre navigateur.
Connectez-vous à Vayne si ce n'est pas déjà fait, puis cliquez sur Autoriser.
De retour dans Claude, ouvrez une nouvelle conversation et demandez « combien de crédits Vayne me reste-t-il ? » pour vérifier que les outils sont actifs.

URL du serveur à coller

https://mcp.vayne.io/mcp

Les connecteurs personnalisés nécessitent un plan Claude payant (Pro, Max, Team ou Enterprise). Vayne ne voit jamais votre compte Claude, et aucun token API n'est stocké sur votre machine. Pour vous déconnecter plus tard, supprimez le connecteur dans Claude — il ne lui reste alors plus rien pour appeler Vayne.

Avancé : se connecter avec un token API à la place

Utile uniquement si les connecteurs personnalisés ne sont pas disponibles sur votre plan Claude. Cette méthode lance un pont local et nécessite donc Node.js. Ajoutez ce bloc dans claude_desktop_config.json (Réglages → Développeur → Modifier la configuration), remplacez <YOUR_TOKEN>, enregistrez puis redémarrez Claude Desktop :

{
  "mcpServers": {
    "vayne": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.vayne.io/mcp", "--header", "Authorization: Bearer <YOUR_TOKEN>"]
    }
  }
}

Claude.ai (web & mobile)

Identique à Claude Desktop : Réglages → Connecteurs → Ajouter un connecteur personnalisé, collez l'URL du serveur ci-dessus, puis autorisez Vayne quand Claude vous y redirige. Un connecteur ajouté sur une application Claude apparaît aussi sur les autres.

Claude Code (CLI)

Exécutez ceci dans un terminal, puis tapez /mcp dans Claude Code et choisissez Authenticate pour vous connecter à Vayne dans votre navigateur :

claude mcp add --transport http vayne https://mcp.vayne.io/mcp

Vous préférez un token API ? Utilisez plutôt cette commande

Remplacez <YOUR_TOKEN> par votre token API Vayne — aucune connexion via navigateur, pratique pour un serveur ou une CI :

claude mcp add --transport http vayne https://mcp.vayne.io/mcp --header "Authorization: Bearer <YOUR_TOKEN>"

Cursor

Dans Cursor, ouvrez Settings → MCP et ajoutez un nouveau serveur avec cette configuration (remplacez <YOUR_TOKEN>). Pour utiliser OAuth à la place, supprimez le bloc headers — Cursor vous proposera alors de vous connecter à Vayne.

{
  "mcpServers": {
    "vayne": {
      "url": "https://mcp.vayne.io/mcp",
      "headers": { "Authorization": "Bearer <YOUR_TOKEN>" }
    }
  }
}

Claude Agent SDK

Pour construire votre propre agent avec le Claude Agent SDK. Il n'y a pas d'étape navigateur ici, utilisez donc un token : remplacez <YOUR_TOKEN> par le token Vayne de l'utilisateur au nom duquel l'agent agit.

import { query } from "@anthropic-ai/claude-agent-sdk";

const result = query({
  prompt: "Find CEOs in North America and start a Sales Navigator scrape",
  options: {
    mcpServers: {
      vayne: {
        type: "http",
        url: "https://mcp.vayne.io/mcp",
        headers: { Authorization: "Bearer <YOUR_TOKEN>" },
      },
    },
  },
});

Tout autre client MCP

Pointez n'importe quel agent compatible MCP (par exemple Goose, Cline ou OpenCode) vers l'URL du serveur ci-dessus. Les clients qui implémentent le flux OAuth MCP sont redirigés vers Vayne pour se connecter ; les autres envoient votre token API dans l'en-tête Authorization.

Référence

Outils

30+ outils regroupés par fonctionnalité — les mêmes capacités que l'API Vayne, plus des assistants exclusifs au MCP comme les constructeurs de recherches Sales Navigator.

Sales Navigator Construisez des recherches de leads ou d'entreprises à partir de critères en langage naturel, estimez gratuitement le nombre de résultats, puis créez et suivez des ordres de scraping (jusqu'à 20 000 résultats par recherche). build_search_url · build_account_search_url · estimate_search · create_order · list_orders · get_order

Scraping de profils & entreprises Scrapez n'importe quelle URL de profil ou d'entreprise LinkedIn — une URL unique répond instantanément, deux ou plus deviennent un job batch asynchrone. scrape_linkedin_url · get_linkedin_scraping

Scraping & recherche d'offres d'emploi Scrapez des offres d'emploi (à l'unité ou en batch) et cherchez des offres LinkedIn par mots-clés, localisation ou entreprise, avec chargement de pages supplémentaires à la demande. scrape_linkedin_job · get_linkedin_job_scraping · search_linkedin_jobs · get_linkedin_job_search · load_more_linkedin_job_search

Scrapers de posts Capturez chaque liker et commentateur d'un post, ou de tous les posts récents d'un profil ou d'une page entreprise — avec estimation du coût au préalable. scrape_post_engagement · scrape_profile_posts · estimate_profile_posts · scrape_company_posts · estimate_company_posts · list_post_scrapers · get_post_scraper

Recherche inversée d'email Transformez des emails B2B en profils LinkedIn. Facturé par match trouvé, pas par email soumis. create_reverse_lookup · list_reverse_lookups · get_reverse_lookup

Enrichissement email & téléphone Trouvez l'email professionnel et le téléphone d'un contact — un contact par appel, identifié par URL LinkedIn ou nom + domaine d'entreprise. Utilise les crédits d'enrichissement. create_contact_finder · list_contact_finders · get_contact_finder

Find people Recherche rapide de personnes par entreprise et titre de poste, sans construire d'URL Sales Navigator. find_people · get_find_people

État du compte & assistants Vérifiez les soldes de crédits et limites quotidiennes, contrôlez la connexion LinkedIn, et résolvez secteurs, localisations et entreprises en identifiants LinkedIn pour un ciblage précis. get_credits · check_linkedin_status · search_industries · search_locations · search_companies

Crédits

Les actions MCP consomment les mêmes crédits que l'app web et l'API — il n'y a pas de tarification MCP séparée. Deux pools, tous deux visibles via get_credits :

Les crédits de scraping financent les ordres Sales Navigator, les recherches inversées, les scrapings d'URL et d'offres d'emploi, les recherches d'offres (y compris load_more) et les scrapers de posts. Les limites quotidiennes ne s'appliquent qu'aux scrapes Sales Navigator.
Les crédits d'enrichissement financent uniquement l'enrichissement email & téléphone (contact finder).
Les agents ont pour consigne d'estimer le nombre de résultats et de confirmer le coût en crédits avec vous avant de créer un ordre.

Webhooks

La plupart des outils de création acceptent une URL de webhook HTTPS optionnelle qui reçoit les résultats à la fin du job — pratique pour Clay, Bitscale, les CRM, Zapier, n8n ou des backends maison. Les livraisons sont protégées par un mécanisme de confiance à la première utilisation : la première fois qu'un job cible un nouvel hôte de destination, le job s'exécute normalement mais la livraison est retenue et vous recevez un email d'approbation en un clic. Une fois approuvé, l'hôte est de confiance pour les livraisons futures ; les livraisons retenues expirent après 7 jours sans approbation.

Bon à savoir

Les ordres de scraping sont limités à 5 par 15 minutes et par utilisateur, et les ordres dépassant vos crédits disponibles sont refusés.
Une recherche Sales Navigator scrape au maximum 20 000 résultats — les cibles plus larges sont découpées en plusieurs recherches.
create_order peut aussi enregistrer la recherche dans Sales Navigator (savedSearch) — leads uniquement, et LinkedIn limite les recherches enregistrées à 50 par compte.
Le scraping Sales Navigator utilise la session LinkedIn connectée à votre compte Vayne ; si elle expire, rafraîchissez-la dans les paramètres de connexion LinkedIn de l'app. Les autres fonctionnalités ne nécessitent aucun compte LinkedIn.
Un 401 sur n'importe quel outil signifie que le token API est erroné ou a été régénéré — copiez-en un nouveau depuis les Paramètres API. Sur un connecteur OAuth, supprimez-le puis rajoutez-le pour ré-autoriser l'accès.
Les clients MCP mettent en cache la liste d'outils à la connexion ; si de nouveaux outils n'apparaissent pas, déconnectez puis reconnectez complètement le client.

Découvrir le MCP Vayne Documentation API REST