MCP Connection

Connectez AgentLed à Claude Code, Cursor, Windsurf, Codex ou à tout client compatible MCP. Une commande à configurer, une clé API pour s'authentifier.


Comment fonctionne MCP

AgentLed s'exécute en tant que serveur MCP (Model Context Protocol). Votre client AI s'y connecte via stdio, donnant au AI un accès direct à plus de 100 intégrations, à l'orchestration de flux de travail et au Knowledge Graph, le tout authentifié avec une seule clé API.

Le serveur est distribué sous forme de package npm (@agentled/mcp-server). Votre client MCP le lance en tant que sous-processus et communique via stdin/stdout.


Claude Code

Recommandé: installez le plugin. Il regroupe le serveur MCP et la compétence AgentLed (workflow-authoring et Claude se chargent automatiquement) en une seule étape. Dans Claude Code, exécutez:

/plugin marketplace add Agentled/mcp-server
/plugin install agentled@agentled

Définissez ensuite votre clé API dans le shell à partir duquel vous lancez Claude Code:

export AGENTLED_API_KEY=wsk_...

Vous pouvez également enregistrer manuellement uniquement le serveur MCP (ignorez ceci si vous avez installé le plugin - les deux exécutent deux processus serveur identiques):

claude mcp add agentled \
  -e AGENTLED_API_KEY=wsk_... \
  -- npx -y @agentled/mcp-server

Remplacer wsk_... avec votre clé API réelle. Voir Clés API pour savoir comment en générer un.


OpenAI Codex

codex mcp add agentled \
  -e AGENTLED_API_KEY=wsk_... \
  -- npx -y @agentled/mcp-server

Attention: le @agentled/mcp-server le colis n'expédie plus de agentled binaire (il était en conflit avec @agentled/cli). Installer @agentled/cli pour la commande du terminal; utiliser npx -y @agentled/mcp-server pour MCP.


Cursor / Windsurf

Ajoutez ce qui suit à votre fichier JSON de paramètres MCP:

{
  "mcpServers": {
    "agentled": {
      "command": "npx",
      "args": ["-y", "@agentled/mcp-server"],
      "env": {
        "AGENTLED_API_KEY": "wsk_..."
      }
    }
  }
}

Dans Cursor, ouvrez Paramètres > MCP et collez le fichier config. Dans Windsurf, modifiez ~/.windsurf/mcp_settings.json.


Autres clients MCP

Tout client prenant en charge le transport stdio MCP peut se connecter. Le schéma général:

1.Définir la variable d'environnement AGENTLED_API_KEY à la clé de votre espace de travail

2.Lancement npx -y @agentled/mcp-server comme sous-processus

3.Communiquez via stdin/stdout en utilisant le protocole MCP


Dépannage

"AGENTLED_API_KEY est requis"

Le serveur n'a pas trouvé votre clé API. Assurez-vous que le -e AGENTLED_API_KEY=wsk_... flag est défini dans la commande MCP add, ou que la variable d'environnement est exportée dans votre shell.

"npx: commande introuvable"

Installez Node.js 18+ à partir de nodejs.org. Vérifiez avec npx --version.

Le serveur se connecte mais les outils n'apparaissent pas

Redémarrez votre client MCP après avoir ajouté le serveur. Certains clients nécessitent un redémarrage complet pour découvrir de nouveaux outils MCP.

Erreurs d'authentification (401/403)

Vérifiez que votre clé API commence par wsk_ et n'a pas été révoqué. Générer une nouvelle clé à partir de Workspace Settings > Developer dans le tableau de bord AgentLed.


Prochaines étapes