Serveur MCP

Configuration

Autres clients

Tout client compatible Streamable HTTP se connecte de la même façon, avec l'URL et un header Authorization. Teste le serveur avec le MCP Inspector.

npx @modelcontextprotocol/inspector --cli https://gemlead.ai/mcp \
  --transport http \
  --header "Authorization: Bearer $GEMLEAD_API_KEY" \
  --method tools/list

Plusieurs comptes X

Une connexion correspond à un seul compte X. Pour en gérer plusieurs en même temps, ajoute Gemlead une fois par compte, chacun avec sa propre URL de serveur, https://gemlead.ai/mcp/ suivi d'un nom que tu choisis, comme https://gemlead.ai/mcp/acme et https://gemlead.ai/mcp/julien. Le nom n'est qu'une étiquette, en lettres, chiffres, - et _.

Connecte chacun et choisis son compte X sur la page de consentement de Gemlead. Un nom identique au nom d'utilisateur X du compte le sélectionne automatiquement. Si les comptes sont rattachés à des logins Gemlead différents, connecte-toi au bon avant chaque connexion.

Chaque connexion ne lit et n'agit que sur son propre compte, et dit à l'assistant de quel @handle il s'agit, donc un DM part toujours du compte que tu as demandé. Nomme chaque connecteur d'après son compte, comme Gemlead Acme, pour les distinguer dans le chat.

Outils

Le serveur a 67 outils, un par action de l'API. Les outils de lecture ne font que lire. Les outils d'écriture modifient des données ou agissent sur X depuis ton compte. Ils nécessitent donc le scope write, et l'assistant te demande ton accord avant d'envoyer, de lancer ou de supprimer quoi que ce soit.

Clique sur le tag MCP d'un endpoint dans la référence API pour aller directement à son outil.

Aucun outil ne définit ni ne retire le code X Chat, et c'est voulu, pour qu'un code ne passe jamais par un chat IA. Définis-le dans l'app ou avec Définir le code X Chat.

Arguments et résultats

• Un outil prend les paramètres de son endpoint, avec des ID nommés d'après leur objet, comme lead_id, persona_id, campaign_id, conversation_id ou export_id. Les listes se paginent avec limit et cursor, comme dans Pagination.
• Un outil qui fait plusieurs choses prend un argument action, kind ou status, comme lead_action avec action égal à rescore, refresh, follow ou unfollow.
• list_campaigns prend status sous forme de tableau de draft, active, paused et archived. get_campaign_stats compte de from à to, deux dates ISO 8601. Par défaut, to vaut maintenant et from 30 jours avant.
• create_export prend les filtres de search_leads dans filters, sans limit ni cursor. Avec type à conversations, il exporte toutes les conversations en DM avec leur fil complet, et filters prend persona_id et unread. Il fonctionne avec une clé read, comme Créer un export.
• ask_julien_ai envoie text à Julien AI, avec chat_id pour continuer un chat. Une réponse qui prend plus de 25 secondes revient en running avec son id. Rappelle l'outil avec seulement reply_id, égal à cette valeur, et il attend encore jusqu'à 25 secondes.
• get_conversation et list_messages donnent les médias de chaque message avec leur url. view_media prend l'url d'une image ou d'un GIF et montre l'image elle-même à l'assistant, qui peut ainsi lire une capture envoyée par un lead. send_message en envoie une avec media, soit une url https publique, soit des data en base64 avec leur mime_type.
• Un argument incorrect renvoie une erreur d'outil qui le nomme. Une erreur de l'API revient sous forme d'erreur d'outil, avec son code et l'argument concerné.

Chaque outil répond avec le JSON de son endpoint, en contenu structuré et en texte. Les outils ne publient aucun schéma de sortie, la référence API décrit chaque objet.

Sur les plans Free et Starter, le serveur s'installe et liste ses outils, et chaque appel renvoie une erreur plan_required que l'assistant peut expliquer. Les appels d'outils comptent dans les 120 requêtes par minute de la clé, partagées avec l'API REST.

Exemples de prompts

• Montre-moi les leads chauds du jour pour mon persona Tipsters, et pourquoi chacun a un bon score.
• Quelle campagne a eu le meilleur taux de réponse sur les 30 derniers jours, et combien de DM a-t-elle envoyés ?
• Liste mes conversations non lues et résume ce que demande chaque lead.
• Exporte en CSV tous les leads chauds trouvés cette semaine et donne-moi le lien.
• Exporte toutes mes conversations en DM, puis dis-moi quelles accroches obtiennent le plus de réponses et comment les leads réagissent au prix.
• Clôture le lead @jane_builds et enregistre son ID HubSpot hs_48213 dans ses métadonnées.
• Passe Sam AI en Semi-auto pour mon persona Tipsters et ajoute notre PDF de tarifs à ce qu'il lit.

Sécurité

• L'assistant ne voit que le compte X que tu as connecté.
• Révoque une connexion ou une clé à tout moment dans l'app, sur la page API.
• Donne une clé read à un assistant qui n'a besoin que de lire.
• Un assistant peut être piégé par un texte qu'il lit. Vérifie ce qu'un outil d'écriture s'apprête à faire avant de l'autoriser.