Skip to content

Installer le serveur MCP

Installez @lebureau/mcp, recuperez une cle API, et branchez-le dans Claude Desktop ou Claude Code.

3 min de lecture

Prerequis

  • Node.js 20 ou plus recent. Verifiez avec node --version.
  • Un compte Le Bureau.

Recuperer une cle API

  1. Connectez-vous au tableau de bord.
  2. Ouvrez Parametres -- Cles API.
  3. Cliquez sur Creer une cle API, donnez-lui un nom descriptif (par exemple claude-desktop-laptop), et choisissez ses capabilities dans la grille de cases a cocher. La selection par defaut est volontairement etroite ; n'ajoutez des scopes que si vous en avez vraiment besoin.
  4. Copiez la cle immediatement. Elle n'est affichee qu'une seule fois et commence par sk_live_. Stockez-la dans un gestionnaire de mots de passe ou dans le trousseau de votre OS. Ne la commitez jamais dans un depot.

Si vous perdez la cle, revoquez-la depuis le meme onglet et generez-en une nouvelle.

Lancer le serveur via npx

@lebureau/mcp est publie sur npm. Vous ne le lancez normalement pas a la main -- votre client MCP s'en charge. La commande est :

npx -y @lebureau/mcp@latest

Le binaire s'appelle lb-mcp. Le drapeau -y accepte l'invite d'installation et @latest garantit que vous tirez la version publiee la plus recente a chaque lancement.

Configurer Claude Desktop

Ouvrez claude_desktop_config.json et ajoutez une entree sous mcpServers :

{
  "mcpServers": {
    "lebureau": {
      "command": "npx",
      "args": ["-y", "@lebureau/mcp@latest"],
      "env": {
        "LEBUREAU_API_KEY": "sk_live_..."
      }
    }
  }
}

Sauvegardez le fichier et redemarrez Claude Desktop. Les outils Le Bureau apparaitront dans la prochaine conversation.

Configurer Claude Code

Meme structure, dans .mcp.json a la racine de votre projet (ou dans votre configuration utilisateur) :

{
  "mcpServers": {
    "lebureau": {
      "command": "npx",
      "args": ["-y", "@lebureau/mcp@latest"],
      "env": {
        "LEBUREAU_API_KEY": "sk_live_..."
      }
    }
  }
}

Redemarrez Claude Code apres avoir sauvegarde.

Verifier que ca fonctionne

Demarrez une nouvelle conversation et demandez :

Liste mes bureaux.

L'assistant doit appeler l'outil desktops_list et renvoyer vos bureaux actuels. Si rien ne se passe, voir Depannage ci-dessous.

Variables d'environnement

VariableRequiseDefautDescription
LEBUREAU_API_KEYoui--Cle API depuis la page de parametres. Commence par sk_live_.
LEBUREAU_BASE_URLnonhttps://lebureau.talentai.frA surcharger uniquement si le support vous le demande.
LEBUREAU_MCP_LOG_LEVELnonwarnUne des valeurs debug, info, warn, error. Les logs sont ecrits sur stderr.
LEBUREAU_MCP_DESTRUCTIVEnon0Reserve pour une version future. Sans effet aujourd'hui.

Depannage

SymptomeCe que cela veut direQue faire
401 UnauthorizedLa cle est invalide ou a ete revoquee.Generez une nouvelle cle dans Parametres -- Cles API.
403 Forbidden avec les champs required et heldLa cle ne possede pas la capability requise par l'outil.Soit creez une nouvelle cle avec la capability manquante, soit utilisez un autre outil. Voir Capabilities API.
429 Too Many RequestsVous avez atteint la limite de debit par cle (60 requetes par minute).Attendez et reessayez. Le message d'erreur contient un indice Retry-After lorsque le serveur en fournit un.
Outils absents dans votre client MCPLe client n'a pas pris en compte la configuration, ou le JSON est invalide.Redemarrez le client apres avoir edite le fichier de configuration. Validez le JSON -- une virgule trainante en fin de bloc supprime silencieusement l'entree.

Articles connexes

Vue d'ensemble du serveur MCP

Ce qu'est @lebureau/mcp, ce qu'il permet a votre assistant IA de faire, et comment il dialogue avec Le Bureau.

Reference des outils MCP

Les 18 outils livres dans @lebureau/mcp v0.1.0, groupes par domaine, avec la capability requise sur la cle API.

Capabilities API

Comment fonctionnent les capabilities des cles API et les sept scopes utilisateur que vous pouvez attacher a une cle.

PreviousVue d'ensemble du serveur MCP
NextReference des outils MCP