Documentation développeur · Configuration MCP

Connectez votre IA à votre espace ArtisanLoop en deux minutes.

ArtisanLoop parle le Model Context Protocol — le standard ouvert d'Anthropic pour l'intégration IA ↔ outils. Branchez Claude Desktop, Cursor ou tout client compatible MCP à votre espace de travail et votre assistant peut chercher dans vos contacts, rédiger des devis, et plus encore.

Qu'est-ce que le Model Context Protocol ?

MCP est un standard ouvert publié par Anthropic qui permet aux modèles d'IA d'appeler des outils externes via une interface unique et sécurisée. Voyez-le comme un USB-C pour l'IA : un seul connecteur, tous vos outils. Le standard est livré avec des SDK de référence et est supporté nativement par Claude Desktop, Cursor, Zed et un écosystème grandissant de clients LLM.

ArtisanLoop héberge un serveur MCP à mcp.artisanloop.com. Une fois votre clé émise, votre client MCP dialogue en JSON-RPC sur HTTP avec ce point d'accès, et nous routons chaque appel d'outil dans le même pipeline scopé et auditable que l'agent vocal embarqué.

Outils disponibles

La surface MCP démarre volontairement petite. Nous ajoutons les outils au fur et à mesure de leur validation par l'agent vocal — chaque outil listé ici est celui que votre standardiste IA utilise déjà.

lookup_contact

Recherche les contacts de votre espace de travail par nom, téléphone ou email. Renvoie jusqu'à 10 résultats avec leurs champs canoniques (nom, email, téléphone, dernière interaction).

D'autres outils arrivent à mesure qu'ils sont livrés dans @artisanloop/agent-tools. Le serveur MCP les expose automatiquement.

Émettez votre première clé

Tout client MCP a besoin d'un jeton porteur. Émettez-en un depuis le dashboard, collez-le dans la config de votre client et vous êtes connecté.

1
Ouvrez le dashboard
Rendez-vous dans Paramètres → Clés MCP de votre espace ArtisanLoop. Vous devez être propriétaire ou administrateur pour émettre des clés.
2
Nommez la clé et choisissez les portées
Donnez un nom lisible à la clé (ex. « Claude Desktop — portable ») et sélectionnez les outils qu'elle peut invoquer. « Tous les outils » est l'option par défaut et convient à la plupart des configurations.
3
Copiez le jeton en clair
Après avoir cliqué sur Créer, le jeton en clair est affiché UNE SEULE FOIS. Copiez-le immédiatement — une fois la fenêtre fermée, nous ne pouvons plus vous le restituer.

Ouvrir Paramètres → Clés MCP

Branchez-le à votre client

Trois transports, même format. Collez le snippet pour votre client, remplacez le marqueur par votre clé émise et redémarrez le client.

Claude Desktop

Claude Desktop lit sa liste de serveurs MCP dans claude_desktop_config.json. Ajoutez le snippet ci-dessous, sauvegardez le fichier et quittez puis relancez complètement Claude.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) · %APPDATA%\Claude\claude_desktop_config.json (Windows)

json

{
  "mcpServers": {
    "artisanloop": {
      "transport": "http",
      "url": "https://mcp.artisanloop.com/mcp",
      "headers": {
        "Authorization": "Bearer mcp_live_<paste-your-key-here>"
      }
    }
  }
}

Cursor

Cursor utilise le même format que Claude Desktop. Ajoutez le snippet dans la config MCP de Cursor et redémarrez l'application.

~/.cursor/mcp.json

json

{
  "mcpServers": {
    "artisanloop": {
      "url": "https://mcp.artisanloop.com/mcp",
      "headers": {
        "Authorization": "Bearer mcp_live_<paste-your-key-here>"
      }
    }
  }
}

Client HTTP personnalisé

Tout client HTTP qui parle JSON-RPC fonctionne. Envoyez le jeton porteur dans l'en-tête Authorization et faites un POST sur /mcp.

bash

curl -X POST https://mcp.artisanloop.com/mcp \
  -H "Authorization: Bearer mcp_live_<paste-your-key-here>" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list"
  }'

Modèle d'authentification

Chaque clé est un jeton porteur. Le cloisonnement par tenant et les limites de débit sont appliqués côté serveur — votre clé porte l'identité de l'espace de travail, aucun en-tête organisation n'est nécessaire.

Une clé, un espace de travail
Chaque clé authentifie exactement un espace de travail. Pour utiliser MCP dans plusieurs espaces, émettez une clé par espace.
Les portées restreignent les outils
Les portées sont des motifs de noms d'outils. Utilisez « * » pour un accès complet, ou listez des outils spécifiques (ex. « lookup_contact ») pour limiter l'impact en cas de fuite.
Limite de débit par clé
Nous limitons le débit des appels MCP par clé pour éviter les boucles incontrôlées dans les agents mal configurés. Besoin d'un débit plus élevé ? Contactez-nous.
Journal d'audit complet
Chaque invocation d'outil est enregistrée avec l'id de la clé, le nom de l'outil, les arguments et l'acteur. Consultez-les dans Paramètres → Journal d'audit.

Recommandations de sécurité

Les clés MCP donnent au client IA un accès réel aux données de votre espace de travail. Traitez-les comme des mots de passe.

Faites tourner les clés régulièrement
Nous recommandons de faire tourner les clés MCP tous les 90 jours. Le flux est « émettre, coller dans le client, révoquer l'ancienne » — les clés révoquées cessent de fonctionner dans les 60 secondes.
Restreignez les portées par défaut
Commencez par le jeu minimal d'outils dont le client a besoin. Vous pourrez toujours émettre une clé plus large ensuite ; vous ne pouvez pas reprendre un jeton plein accès qui a fuité.
Révoquez au moindre doute
Si un portable est perdu, un prestataire part ou une sauvegarde est exposée, révoquez la clé concernée depuis le dashboard. Le cache de vérification du serveur MCP est purgé en moins de 60 secondes.
Inspectez le journal d'audit
Des appels d'outils inattendus ou des motifs inhabituels ? Le journal d'audit enregistre chaque appel avec l'id de clé responsable — commencez votre enquête là.

Prêt à connecter votre IA ?

Émettez votre première clé MCP depuis le dashboard et collez-la dans votre client. Le flux entier prend moins de deux minutes.

Émettre une clé MCP