Dépannage

Le MCP est installé, mais aucun outil n’apparaît

Démarrez une nouvelle tâche ou conversation après avoir connecté le serveur. Les clients MCP chargent généralement les définitions des outils au début d’une session, pas en continu dans une session existante.

Vérifiez que l’endpoint configuré est exactement :

https://www.salestouch.io/api/mcp

Le client vous demande de vous authentifier à nouveau

Le jeton d’accès est absent, expiré ou ne possède pas le scope requis. Relancez le flux de connexion MCP, acceptez l’autorisation dans le navigateur, puis créez une nouvelle session dans le client.

paid_plan_required

L’utilisateur est authentifié, mais l’espace de travail SalesTouch ne dispose pas de l’accès au MCP LinkedIn. Il s’agit d’un problème de droit d’accès, pas de transport OAuth.

Aucun compte LinkedIn connecté

Connectez LinkedIn dans SalesTouch et vérifiez avec linkedin_accounts. Ne transmettez pas un account_id deviné.

Une cible ne peut pas être identifiée

Utilisez d’abord l’outil de recherche le plus précis :

• linkedin_lookup_profile pour un membre.
• linkedin_lookup_company pour une entreprise ou un établissement.
• linkedin_lookup_post pour une publication.

Préférez une URL LinkedIn complète lorsqu’un handle ou un identifiant fournisseur est ambigu.

message_requires_connection

Les messages directs exigent normalement une relation LinkedIn existante ou une conversation connue. Utilisez plutôt linkedin_invite ou linkedin_invite_then_message.

action_limit_queue_required

SalesTouch a protégé le compte d’une action immédiate. Répétez le même appel avec :

{
  "queue": true
}

Conservez la cible et le contenu d’origine lors du nouvel essai.

Une action planifiée attend l’horizon d’exécution

scheduler_status: "awaiting_horizon" signifie que l’action est enregistrée de façon sûre, mais qu’elle se trouve encore à plus de sept jours. SalesTouch enregistre automatiquement son événement d’exécution exact lorsqu’elle entre dans l’horizon pris en charge.

pending_retry signifie que l’enregistrement de l’événement sera retenté par le processus de récupération horaire. Consultez status avec le détail de la file pour connaître l’heure effective actuelle et toute erreur de reconnexion.

Si l’exécution renvoie linkedin_reconnect_required, la session LinkedIn enregistrée nécessite une intervention humaine. Les comptes avec identifiants se reconnectent normalement automatiquement, contrairement aux anciennes sessions par cookie.

Un résultat d’extraction est trop volumineux

Les outils d’extraction enregistrent les personnes ou entreprises et renvoient un aperçu limité. Utilisez scrape_result_page avec le result_id et le curseur renvoyés. Utilisez l’export signé CSV ou JSONL pour le jeu de données complet. Ne collez pas un export entier dans le contexte de l’agent.

Par défaut, scrape_linkedin_post_comments extrait uniquement les auteurs des commentaires racine. Définissez include_replies: true si les auteurs des réponses sont aussi nécessaires. Chaque fil de réponses exige des requêtes LinkedIn supplémentaires et peut considérablement ralentir l’extraction. Les grandes extractions de commentaires se mettent automatiquement en pause après un nombre limité de requêtes source ou une durée fournisseur définie, afin que l’appel MCP se termine dans sa fenêtre de transport. source_stats.partial_reason vaut provider_request_budget, provider_time_budget ou provider_interruption selon la limite atteinte. La progression confirmée est conservée même si LinkedIn interrompt la première page. Lorsque source_paging.exhausted vaut false, rappelez l’outil avec source_paging.arguments. Son source_cursor opaque reprend la pagination LinkedIn dans le même mode de réponses au lieu de recommencer. L’appel peut donc renvoyer moins de profils que limit. scrape_result_page parcourt uniquement les profils déjà enregistrés par un appel d’extraction.

Les données des commentaires ne contiennent pas toujours le titre professionnel actuel de l’auteur. Lorsqu’un identifiant de profil est disponible, l’extracteur effectue un enrichissement limité avant d’enregistrer l’export. Examinez source_stats.headline_availability, headline_available_count et headline_missing_count. Une valeur partial accompagnée de l’avertissement correspondant signifie que LinkedIn n’a pas exposé tous les titres dans la fenêtre d’enrichissement compatible avec le transport.

Un filtre Sales Navigator est ambigu

Appelez linkedin_sales_navigator_search_parameters avec le type de paramètre et la requête signalés. Sélectionnez l’identifiant du bon candidat, puis réessayez la recherche structurée avec { "id": "..." }. Les identifiants de paramètres dépendent du compte Sales Navigator connecté. Ne les inventez pas et ne réutilisez pas un identifiant non vérifié.

Les résultats d’outil ressemblent à du texte plutôt qu’à du JSON

C’est normal. SalesTouch renvoie du contenu texte MCP contenant du JSON formaté. L’assistant doit analyser ce texte et présenter le résultat utile dans sa réponse normale.

Toujours bloqué

Récupérez dans le journal d’activité SalesTouch le nom de l’outil, l’entrée expurgée, le code d’erreur et l’heure approximative. N’incluez jamais de jetons OAuth, de cookies LinkedIn ou d’identifiants privés dans un rapport d’assistance.