Brancher un assistant IA avec le serveur MCP
Swimlane expose un serveur MCP sur https://api.getswimlane.com/mcp. MCP (Model Context Protocol) est la manière standard de confier un produit à un assistant IA : au lieu d'écrire des appels d'API, vous décrivez ce que vous voulez et l'assistant les passe.
Il expose toute l'API publique sous forme d'outils — imports de sourcing, contacts, listes, tags, pipelines, rappels, campagnes, file d'arrière-plan et consommation quotidienne.
Avant de commencer
Il vous faut un token d'API. Allez dans Paramètres → API → Ajouter un token, choisissez le type API publique, et copiez-le : il n'est affiché qu'une fois. La même page affiche la configuration ci-dessous avec votre hôte déjà renseigné.
L'installer dans votre client
Claude Code — une commande :
claude mcp add --transport http swimlane \
https://api.getswimlane.com/mcp \
--header "Authorization: Bearer wpa_votre_token"
Claude Desktop — dans claude_desktop_config.json :
{
"mcpServers": {
"swimlane": {
"type": "http",
"url": "https://api.getswimlane.com/mcp",
"headers": {"Authorization": "Bearer wpa_votre_token"}
}
}
}
Cursor — ~/.cursor/mcp.json (ou .cursor/mcp.json dans un projet) prend la même forme mcpServers, sans la ligne type.
VS Code — .vscode/mcp.json utilise servers au lieu de mcpServers, avec type, url et headers.
OpenAI — une entrée de tools[] sur l'API Responses :
{
"type": "mcp",
"server_label": "swimlane",
"server_url": "https://api.getswimlane.com/mcp",
"headers": {"Authorization": "Bearer wpa_votre_token"},
"require_approval": "never"
}
Redémarrez le client ensuite. Il doit lister les outils Swimlane ; sinon, c'est en général le token — vérifiez qu'il commence par wpa_ et qu'il a bien été créé en type API publique.
Quoi lui demander
Sourcer une liste sans ouvrir LinkedIn
« Prends tous les gens qui ont commenté ce post, mets-les dans une liste Commentateurs webinaire, et continue à la remplir : https://www.linkedin.com/posts/… »
L'assistant crée la liste et met l'import en file. Les contacts arrivent dans les minutes qui suivent, et la liste se recharge toutes les deux ou trois heures. Demandez « c'est fini ? » et il consulte la file d'arrière-plan.
Comprendre pourquoi une campagne s'est tue
« Où en sont mes campagnes, et est-ce que quelque chose est bloqué ? »
Il lit vos campagnes et leurs statistiques, puis votre consommation du jour et la file d'attente. La réponse utile est souvent la seconde : « votre séquence Acme n'a rien envoyé depuis mardi parce que la limite quotidienne d'invitations est à 20/20 chaque matin ».
Rédiger une séquence
« Prépare une séquence en trois étapes pour la liste Engagés Acme : invitation, trois jours d'attente, message à ceux qui ont accepté, tag pour les autres. »
Il ouvre une campagne en brouillon et pose le flux ramifié. Il s'arrête là : démarrer une campagne est un outil séparé, vous relisez donc les étapes dans l'application d'abord.
Repérer les contacts qu'on ne pourra jamais contacter
« Dans la liste Importés du CSV, quels contacts n'ont pas de profil LinkedIn ? Tague-les
profil-manquant. »
Un contact sans profil LinkedIn est une fiche CRM et rien d'autre : aucune étape de campagne ne peut agir sur lui. C'est la panne qui se manifeste sinon des semaines plus tard, sous forme d'étapes qui finissent en failed.
Poser un rappel en une phrase
« Rappelle-moi de relancer Sofia Marchetti dans deux semaines à propos de la question de tarif. »
Il retrouve Sofia et crée le rappel sur sa fiche, là où vous le verrez à côté de la conversation.
Bon à savoir
- Deux outils envoient pour de vrai. Démarrer ou reprendre une campagne met de vraies invitations et de vrais messages devant de vraies personnes, depuis votre compte LinkedIn. Ils sont marqués pour que votre client demande confirmation — laissez cette confirmation active.
- Le token agit comme vous. Même espace de travail, même session LinkedIn, mêmes limites quotidiennes. Il ne voit jamais les campagnes d'un coéquipier.
- Tout est journalisé. Chaque appel d'outil est un appel d'API : il compte dans la limite des 100 par minute et apparaît dans Paramètres → API avec sa méthode, son chemin et son statut.
- Il ne lit pas vos conversations. Un assistant peut vous dire que quelqu'un a répondu, pas ce qu'il a écrit. Écrire un message à une personne se fait toujours dans l'application.
- Révoquer l'accès, c'est supprimer le token dans Paramètres → API. La connexion cesse immédiatement de fonctionner.
Pour les endpoints derrière les outils, voir Référence de l'API publique Swimlane.
