← Documentation ConnectMachine

Model Context Protocol

Le serveur MCP de ConnectMachine

ConnectMachine expose un serveur MCP distant : tout outil IA compatible peut gérer vos contacts, événements, réseaux et cartes numériques par simple conversation. Rien à installer : l'outil se connecte en HTTPS avec votre clé personnelle.

Inclus avec les comptes ConnectMachine. Quelques actions avancées suivent les mêmes règles Premium que l'application.

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.
Important

Les 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. Les clés sont gérées côté backend et n'expirent pas ; gardez la vôtre secrète et supprimez la configuration de votre outil pour vous déconnecter.

  • 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. Sur Claude web et bureau : Paramètres, puis Connecteurs, choisissez Ajouter un connecteur personnalisé et collez l'URL du serveur. Pour Claude Code, créez .mcp.json à la racine du projet avec l'extrait ci-dessous (remplacez YOUR_MCP_KEY par votre clé) puis redémarrez Claude Code.

.mcp.json
{
  "mcpServers": {
    "connectmachine": {
      "type": "http",
      "url": "https://mcp.connectmachine.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_KEY"
      }
    }
  }
}
04

Connecter Cursor

Créez ou modifiez ~/.cursor/mcp.json (global) ou .cursor/mcp.json dans un projet, collez l'extrait ci-dessous et remplacez YOUR_MCP_KEY par votre clé. Rechargez Cursor : les outils ConnectMachine apparaissent dans la liste MCP.

~/.cursor/mcp.json
{
  "mcpServers": {
    "connectmachine": {
      "url": "https://mcp.connectmachine.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_KEY"
      }
    }
  }
}
05

Connecter VS Code

VS Code utilise un objet servers au lieu de mcpServers. Créez .vscode/mcp.json dans votre espace de travail, collez l'extrait ci-dessous et remplacez YOUR_MCP_KEY par votre clé.

.vscode/mcp.json
{
  "servers": {
    "connectmachine": {
      "type": "http",
      "url": "https://mcp.connectmachine.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_KEY"
      }
    }
  }
}
06

Connecter Zed

Zed appelle context servers les serveurs MCP et prend en charge les serveurs distants nativement : aucune extension à installer. Ouvrez Paramètres, puis AI et MCP Servers, cliquez sur Add Server et choisissez Add Remote Server, ou collez l'extrait ci-dessous dans votre settings.json Zed. Sans en-tête Authorization, Zed exécute le flux OAuth standard de MCP et vous demande de vous connecter à la première utilisation ; ajoutez un objet "headers" avec votre clé si vous préférez un jeton statique.

Zed settings.json
{
  "context_servers": {
    "connectmachine": {
      "url": "https://mcp.connectmachine.ai/mcp"
    }
  }
}
07

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
08

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.
09

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.

10

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.
  • Déconnectez-vous à tout moment en supprimant la configuration de votre outil.
  • Conditions et confidentialité : connectmachine.ai/fr/legal/terms-of-service et connectmachine.ai/fr/legal/privacy.
11

Dépannage

La plupart des problèmes viennent de l'URL, de la clé ou de l'état du compte.

  • Clé invalide : reconnectez-vous sur la page de connexion et utilisez la clé affichée.
  • 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.