> Version markdown de https://weenova.ai/developers — Weenova, CRM IA pour courtiers en assurance. Index complet des pages : https://weenova.ai/llms.txt # 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. - [Carte du serveur MCP](https://weenova.ai/.well-known/mcp/server-card.json) - [Métadonnées du serveur d’autorisation](https://mcp.weenova.ai/.well-known/oauth-authorization-server) - [Métadonnées de ressource protégée](https://mcp.weenova.ai/.well-known/oauth-protected-resource) - [Carte A2A Weenova](https://weenova.ai/.well-known/agent-card.json) - [Index Agent Skills](https://weenova.ai/.well-known/agent-skills/index.json) ## 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. [Configurer le MCP Cowork](https://app.weenova.ai/tom/cowork-mcp)