Développeurs — MCP Weenova Cowork

Mis à jour le 2026-08-25

Weenova expose un serveur MCP authentifié pour synchroniser une prospection LinkedIn autorisée avec le CRM Cowork de l’utilisateur. Cette surface couvre sept outils spécialisés ; Weenova ne publie pas actuellement d’API REST générale.

Quand utiliser le serveur MCP Weenova

Utilisez le serveur weenova-cowork lorsqu'un utilisateur Weenova veut faire travailler un agent compatible MCP sur son processus de prospection LinkedIn tout en conservant une trace fiable dans son CRM. Le serveur permet de démarrer et clôturer une session, enregistrer chaque prospect et message, suivre les rendez-vous et relire le pipeline.

Ne l'utilisez pas pour accéder au CRM général, aux contrats d'assurance, aux sinistres ou aux données d'un autre cabinet : ces fonctions ne font pas partie de la surface MCP publique documentée.

Connexion et authentification

Endpoint Streamable HTTP : https://mcp.weenova.ai/mcp. Le serveur exige une authentification liée au compte Weenova et publie ses métadonnées OAuth pour permettre la découverte automatique. Les droits sont limités aux données Cowork de l’utilisateur autorisé ; aucun user_id ne doit être envoyé dans les appels d’outil.

Les sept outils MCP disponibles

  • cowork_session_start — démarre une session add_contacts, first_message, followup ou custom et retourne son identifiant.
  • cowork_add_prospect — crée ou met à jour un prospect, avec l’URL LinkedIn comme clé d’idempotence.
  • cowork_log_message — consigne un message entrant ou sortant et met à jour le statut du prospect.
  • cowork_log_meeting — enregistre un rendez-vous et passe le prospect à meeting_booked.
  • cowork_update_status — fait avancer explicitement un prospect dans le pipeline.
  • cowork_list_prospects — recherche et filtre les prospects pour éviter les doublons et contrôler la synchronisation.
  • cowork_session_complete — clôture la session avec ses statistiques et son compte rendu.

Flux recommandé pour un agent

  1. Appeler cowork_session_start une seule fois et conserver le session_id.
  2. Vérifier les prospects existants avec cowork_list_prospects avant toute action.
  3. Après chaque action LinkedIn confirmée, consigner immédiatement le prospect, le message ou le rendez-vous avec l’outil correspondant.
  4. Relire le pipeline avec cowork_list_prospects afin de détecter tout écart.
  5. Terminer systématiquement avec cowork_session_complete, y compris si la session est interrompue.

Idempotence, contrôle humain et sécurité

Les écritures sont conçues pour être idempotentes : réappeler un outil avec la même clé stable met à jour l’enregistrement au lieu de créer un doublon. Une URL LinkedIn canonique identifie un prospect et linkedin_message_id permet de dédupliquer un message.

L’agent ne doit consigner qu’une action réellement effectuée ou observée. Une réponse générée, une invitation préparée ou un rendez-vous proposé ne doivent jamais être enregistrés comme envoyés ou confirmés. Si l’état ne peut pas être vérifié, l’agent s’arrête et le signale à l’utilisateur.

Erreurs et résolution

  • Authentification invalide ou expirée — reconnecter le serveur MCP depuis le compte Weenova, puis relancer la requête.
  • Prospect introuvable — rechercher le prospect avec cowork_list_prospects, puis réessayer avec son prospect_id ou son URL LinkedIn canonique.
  • Message déjà enregistré — une réponse dedup: true signifie que l’idempotence a fonctionné ; ne pas créer une seconde entrée.
  • Écriture non confirmée — ne pas poursuivre silencieusement. Informer l’utilisateur et vérifier l’état du CRM avant toute autre action.

Périmètre API publié

La surface d’intégration publique documentée de Weenova est aujourd’hui le serveur MCP Cowork ci-dessus. Il n’existe pas encore d’API REST générale ni de spécification OpenAPI publique pour le CRM complet. Cette limite est volontairement déclarée afin qu’un agent ne déduise pas des endpoints inexistants à partir de l’interface web.

Questions fréquentes

Weenova possède-t-il une API publique générale ?

Non. La surface actuellement documentée est le serveur MCP Weenova Cowork, limité à la synchronisation de la prospection LinkedIn. Aucune API REST générale du CRM n'est annoncée publiquement.

Combien d’outils le serveur MCP expose-t-il ?

Sept : démarrage et clôture de session, ajout de prospect, journalisation de message et de rendez-vous, mise à jour de statut et recherche de prospects.

Les outils MCP peuvent-ils accéder aux données d’un autre cabinet ?

Non. L’authentification lie les appels au compte Weenova autorisé et la surface Cowork est scopée aux données de cet utilisateur.