01 Ce que le serveur expose
Le serveur publie 40 outils. Votre assistant choisit le bon pour chaque demande ; vous ne les appelez jamais par leur nom.
- Contacts (12) : liste, recherche, création, mise à jour, suppression, recherche intelligente, secteurs, doublons, fusion et réseaux.
- Événements (3) : listez vos événements et ajoutez ou retirez l'événement où vous avez rencontré un contact.
- Réseaux (5) : liste, création, mise à jour, suppression et réorganisation.
- Cartes numériques (7) : gestion complète, carte partagée et extraction des données d'une photo de carte.
- Import et export (6) : sessions d'import par lots, suivi et export CSV.
- Notifications et profil (7) : notifications, compteurs, profil et abonnement.
ImportantLes outils de requêtes IA et de transcription de réunions arriveront dans une phase ultérieure.
02 Obtenez votre clé MCP
La clé est un jeton personnel lié à votre compte. Ouvrez la page de connexion MCP, connectez-vous avec votre e-mail (code à usage unique) ou Google, puis copiez la clé et les configurations prêtes à l'emploi. Gardez-la secrète ; pour la révoquer, générez-en une nouvelle.
- Page de connexion : licenses.connectmachine.ai/mcp/auth
- Chaque requête de votre outil IA est authentifiée avec cette clé, uniquement sur votre compte.
03 Connecter Claude
Claude prend en charge les serveurs MCP distants sur le web, l'application de bureau et Claude Code.
- Claude web et bureau : Paramètres > Connecteurs > Ajouter un connecteur personnalisé avec https://mcp.connectmachine.ai/mcp.
- Claude Code : claude mcp add --transport http connectmachine https://mcp.connectmachine.ai/mcp --header "Authorization: Bearer VOTRE_CLE".
- Clients JSON : ajoutez le serveur dans mcpServers avec l'url et l'en-tête Authorization: Bearer.
04 Connecter Cursor
Créez ou modifiez .cursor/mcp.json dans votre projet (ou le fichier global ~/.cursor/mcp.json) et ajoutez l'entrée connectmachine dans mcpServers avec l'url du serveur et l'en-tête Authorization portant votre clé. Rechargez Cursor : les outils apparaissent.
ImportantURL du serveur : https://mcp.connectmachine.ai/mcp
05 Connecter VS Code
VS Code utilise un objet servers au lieu de mcpServers. Créez .vscode/mcp.json avec une entrée de type "http", l'url du serveur et l'en-tête Authorization. La page de connexion génère ce fichier exact.
06 Autres clients MCP
Tout client compatible avec les serveurs MCP distants se connecte avec deux valeurs : l'URL du serveur et votre clé en jeton bearer. Les clients qui implémentent le flux OAuth de MCP peuvent aussi se connecter via le navigateur : le serveur prend en charge OAuth 2.0 avec enregistrement dynamique et PKCE.
- URL du serveur : https://mcp.connectmachine.ai/mcp
- En-tête : Authorization: Bearer VOTRE_CLE
07 Comportement des outils
Le serveur est conçu pour qu'un assistant ne puisse pas se tromper en silence avec votre réseau.
- Homonymes : si deux contacts portent le même nom, find_contact signale l'ambiguïté et demande à l'assistant de vous poser la question plutôt que de deviner.
- Des événements, pas des tags : on enregistre l'événement de la rencontre, comme dans l'application.
- La recherche couvre nom, entreprise, poste, e-mail, téléphone, notes, localisation et événements.
- Nouveaux comptes : tant que l'onboarding n'est pas terminé dans l'application, les outils répondent par des conseils et des liens de téléchargement.
08 Forfaits et actions Premium
Connecter votre outil IA est inclus. Les actions Premium de l'application restent Premium via MCP, comme l'export CSV ou les filtres par secteur et localisation. Un compte gratuit reçoit un message clair nommant la fonctionnalité et la marche à suivre, jamais un échec silencieux.
09 Confidentialité et sécurité
Le serveur MCP est une passerelle légère et authentifiée vers l'API ConnectMachine. Il ne conserve aucune copie de votre réseau.
- La clé est validée sur votre compte à chaque requête ; aucun accès entre comptes.
- L'assistant ne reçoit que les données nécessaires à la demande.
- Révoquez à tout moment : générez une nouvelle clé ou supprimez la configuration.
- Conditions et confidentialité : connectmachine.ai/fr/legal/terms-of-service et connectmachine.ai/fr/legal/privacy.
10 Dépannage
La plupart des problèmes viennent de l'URL, de la clé ou de l'état du compte.
- Clé invalide ou expirée : reconnectez-vous sur la page de connexion et utilisez la nouvelle clé.
- Message d'onboarding : terminez l'onboarding dans l'application, puis réessayez.
- Message Premium : l'action requiert un forfait supérieur ; le reste continue de fonctionner.
- Échec de connexion : vérifiez que l'URL est exactement https://mcp.connectmachine.ai/mcp et redémarrez l'outil après toute modification.