Aller au contenu
Nexus TéléchargerDémarrer

Connecter vos assistants avec MCP

Nexus expose un serveur MCP distant, à l’adresse https://api.nexus-engine.eu/api/v1/mcp. Ce n’est pas un second produit : chaque outil rejoue une route de l’API avec la clé de l’utilisateur. Validations, droits, cloisonnement, journal s’appliquent donc exactement comme pour un appel direct, et une clé en lecture seule ne peut appeler que les outils de lecture.

claude.ai et ChatGPT : rien à copier

Ajoutez un connecteur MCP personnalisé avec l’adresse ci-dessus. Le connecteur découvre le serveur d’autorisation tout seul (OAuth 2.1, PKCE), ouvre une page Nexus dans votre navigateur, où vous vous connectez à votre compte et choisissez ce que l’application peut faire — tout, ou la lecture seule. L’application reliée apparaît ensuite dans Paramètres › API et MCP, d’où elle se retire d’un clic.

Claude Code

claude mcp add --transport http nexus https://api.nexus-engine.eu/api/v1/mcp --header "Authorization: Bearer nexus_VOTRE_CLE"

Codex

Dans ~/.codex/config.toml, la clé étant posée dans la variable d’environnement NEXUS_API_KEY :

[mcp_servers.nexus]
url = "https://api.nexus-engine.eu/api/v1/mcp"
bearer_token_env_var = "NEXUS_API_KEY"

Cursor, VS Code, Windsurf

{
  "mcpServers": {
    "nexus": {
      "type": "http",
      "url": "https://api.nexus-engine.eu/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer nexus_VOTRE_CLE"
      }
    }
  }
}

Clients sans HTTP natif (Claude Desktop…)

{
  "mcpServers": {
    "nexus": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.nexus-engine.eu/api/v1/mcp",
        "--header",
        "Authorization: Bearer nexus_VOTRE_CLE"
      ]
    }
  }
}

Vérifier

curl -s -X POST https://api.nexus-engine.eu/api/v1/mcp \
  -H "Authorization: Bearer nexus_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Une liste d’outils, et la connexion fonctionne. 401 : clé absente, invalide, expirée ou révoquée. 429 : plafond atteint (300 appels par minute et par clé).

Ne pas confondre avec le pont d’une session. Une session d’agent ouverte dans Nexus reçoit déjà un serveur MCP local, déclaré tout seul, sans clé et sans réseau : il connaît le projet en cours, ses accès, son navigateur de vérification, les constats de recette, les connecteurs branchés, le Drive, l’infrastructure et les maquettes Figma du projet. Le serveur décrit ici est l’autre porte : celle qu’on ouvre à un outil qui n’est pas dans Nexus — claude.ai, ChatGPT, un éditeur, un script. Les deux appliquent les mêmes droits ; seul le second demande une clé.

Le modèle reçoit une règle du jeu à la poignée de main. Annoncer ce qui va changer et obtenir l’accord avant toute écriture, ne jamais écrire un secret révélé dans un fichier ou un journal, considérer un 403 comme une règle de Nexus et non une panne. Les outils qui suppriment sont marqués destructifs : un client peut demander confirmation avant de les exécuter.