CLI et éditeurs

Customermates est le CRM open source et IA native. Une fois connecté, votre agent de code lit et écrit contacts, affaires et notes sans quitter le terminal. Tous les clients présentés ici s’authentifient de la même façon : une clé API dans l’en-tête x-api-key vers <BASE_URL>/api/v1/mcp, où <BASE_URL> est l’adresse à laquelle vous ouvrez Customermates, dans le cloud ou sur votre propre instance. Les extraits ci-dessous contiennent déjà l’adresse du site qui affiche cette page ; si vous ouvrez Customermates ailleurs, remplacez cette adresse en plus de YOUR_KEY.

Créer une clé API

Dans Customermates, ouvrez Clés API, cliquez sur Ajouter et choisissez Clé API standard. Donnez-lui le nom du client (par exemple Claude Code) ; sans date dans Expire dans, elle n’expire jamais. La clé de 64 caractères n’est affichée qu’une seule fois : copiez-la immédiatement. Connexions rapides, dans la même boîte de dialogue, s’en charge pour vous : elle nomme la clé d’après le client, la fait expirer au bout de 365 jours et affiche l’extrait de configuration avec la clé déjà renseignée, sa date d’expiration figurant en dessous.

Créer une clé exige Créer sur la ligne API et webhooks de votre rôle, et la page elle-même exige l’Accès en lecture Tous sur cette ligne ; le rôle intégré Administrateur a les deux. Une clé hérite des autorisations de l’utilisateur qui l’a créée ; il n’existe pas de restriction par clé. Créez une clé par client pour pouvoir en révoquer une sans toucher aux autres ; le journal d’activité enregistre l’utilisateur auquel appartient une clé, pas la clé elle-même. Les clés API et MCP fonctionnent avec toutes les offres et sur les instances auto-hébergées. Détails : Clés API.

Claude Code

Claude Code ajoute les serveurs MCP via sa CLI. Une seule commande suffit. Exécutez-la dans n’importe quel terminal, en remplaçant YOUR_KEY :

claude mcp add --transport http customermates https://customermates.com/api/v1/mcp \
  --header "x-api-key: YOUR_KEY"

Aucun redémarrage ni modification de fichier de configuration n’est nécessaire. Claude Code se connecte automatiquement. Exécutez claude mcp list pour vérifier que customermates apparaît.

Portée : par défaut, la commande utilise la portée locale. Ajoutez --scope user pour rendre Customermates disponible partout sur votre machine, ou --scope project pour l’écrire dans le fichier .mcp.json d’un dépôt afin que vos collègues en profitent aussi.

Codex

Codex se connecte directement à Customermates en Streamable HTTP. codex mcp add customermates --url <BASE_URL>/api/v1/mcp ajoute l’URL du serveur, mais la commande de la CLI n’a aucune option pour un en-tête x-api-key personnalisé. Pour un accès par clé API, ouvrez ~/.codex/config.toml (créez-le s’il n’existe pas) et ajoutez le bloc complet ci-dessous, en remplaçant YOUR_KEY :

[mcp_servers.customermates]
enabled = true
url = "https://customermates.com/api/v1/mcp"
http_headers = { "x-api-key" = "YOUR_KEY" }

Pour récupérer la clé dans votre environnement plutôt que de l’enregistrer dans le fichier, remplacez la ligne http_headers du bloc ci-dessus par :

env_http_headers = { "x-api-key" = "CUSTOMERMATES_API_KEY" }

Exportez ensuite CUSTOMERMATES_API_KEY dans le profil de votre shell. Les nouvelles sessions prennent le serveur en compte : terminez donc la session en cours et démarrez-en une nouvelle.

Le même point d’accès HTTP accepte aussi OAuth. Si vous préférez vous connecter, ajoutez l’URL avec codex mcp add customermates --url <BASE_URL>/api/v1/mcp, puis exécutez codex mcp login customermates. Le pont stdio décrit plus bas concerne les clients Claude Desktop qui en ont besoin.

Cursor

Pour configurer Cursor, ouvrez Paramètres → Outils et MCP → Ajouter un serveur MCP et collez ceci, en remplaçant YOUR_KEY :

{
  "customermates": {
    "url": "https://customermates.com/api/v1/mcp",
    "headers": {
      "x-api-key": "YOUR_KEY"
    }
  }
}

Cursor recharge la configuration à chaud : aucun redémarrage n’est nécessaire. Les outils apparaissent tout de suite dans Composer. Pour modifier le fichier directement, le même bloc va dans ~/.cursor/mcp.json (global) ou <project>/.cursor/mcp.json (par projet), placé sous mcpServers.

CLI Gemini

La CLI Gemini charge les serveurs MCP depuis ~/.gemini/settings.json. Fusionnez-y ceci, en remplaçant YOUR_KEY :

{
  "mcpServers": {
    "customermates": {
      "httpUrl": "https://customermates.com/api/v1/mcp",
      "headers": {
        "x-api-key": "YOUR_KEY"
      }
    }
  }
}

Si mcpServers contient déjà des entrées, ajoutez customermates à côté des existantes plutôt que d’écraser l’objet.

Claude Desktop (fichier de configuration)

La voie recommandée pour Claude Desktop est le connecteur : OAuth, sans clé, synchronisé sur tous vos appareils. Avec une offre gratuite, ou si vous préférez une clé statique, le fichier de configuration ci-dessous fonctionne aussi.

Ouvrez Claude → Paramètres → Développeur → Modifier la configuration, ou le fichier directement :

• macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows : %APPDATA%\Claude\claude_desktop_config.json

Fusionnez-y ceci, en remplaçant YOUR_KEY :

{
  "mcpServers": {
    "customermates": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://customermates.com/api/v1/mcp",
        "--header",
        "x-api-key:YOUR_KEY"
      ]
    }
  }
}

mcp-remote est une passerelle qui permet à Claude Desktop de dialoguer avec un serveur MCP HTTP distant via stdio. Elle est téléchargée au premier lancement via npx, il vous faut donc Node 18+ dans le PATH.

Redémarrez ensuite : quittez complètement l’application (⌘Q sous macOS, pas seulement fermer la fenêtre) et rouvrez-la. Customermates apparaît dans le panneau des outils avec la liste des outils du CRM.

Essayer votre premier prompt

Le serveur fournit des instructions de connexion qui décrivent sa surface d’outils, ses règles de sécurité et la manière de récupérer les pages pertinentes de la base de connaissances. Les clients décident de les transmettre ou non à leur agent. Si le vôtre ne le fait pas, ajoutez la règle de récupération de la base de connaissances aux instructions permanentes de ce client. Dans les clients qui prennent en charge les prompts MCP (comme Claude Code), vous pouvez exécuter le prompt intégré get-started pour un démarrage guidé : il lit d’abord votre espace de travail et les pages pertinentes de la base de connaissances, puis ne demande que les informations manquantes.

• « Passez le champ Statut de l’affaire Acme sur “Gagnée” et ajoutez une note indiquant que le contrat a été signé aujourd’hui. »
• « Récupérez les dix derniers contacts que j’ai créés. Y en a-t-il sans adresse e-mail ? »
• « Créez un contact pour Jane Doe chez Initech, reliez-le à l’organisation Initech et lancez une affaire pour 12 heures de conseil. »

Chaque espace de travail définit ses propres types d’enregistrements, comme les contacts, les affaires ou les tâches, et les attributs, comme l’étape d’une affaire ou la priorité d’une tâche, dépendent eux aussi de la configuration de l’espace de travail. Appelez discover_record_types, puis get_record_model pour les identifiants de type concernés, avant d’écrire.

Dépannage

Suite

• Connecteur personnalisé : la voie OAuth pour les applications Claude et ChatGPT.
• Catalogue d’outils MCP : tous les outils que l’agent peut appeler.
• Webhooks : abonnez d’autres systèmes aux modifications du CRM.