Installation des serveurs MCP Nexus

Aurora Nexus expose trois serveurs MCP. Ils permettent à ChatGPT, Codex ou un autre agent LLM compatible MCP d'accéder à Nexus sans contourner l'API, les droits utilisateur ni les contrats de sécurité.

Vue rapide

1. nexus-api — OAuth utilisateur

nexus-api est le connecteur principal pour brancher un assistant LLM à l'API Nexus comme un utilisateur.

Réglages ChatGPT / client MCP :

Server URL: https://mcp-nexus.auroramind.fr/mcp
Auth: OAuth
Client ID: valeur OAUTH_CLIENT_ID
Client Secret: secret OAuth stocké hors dépôt

Smoke public :

curl -s https://mcp-nexus.auroramind.fr/healthz

Résultat attendu :

{
  "status": "ok",
  "server": "nexus-api",
  "schema_version": "nexus_api_mcp.v1",
  "readonly": true
}

Prompt de test :

Utilise uniquement le connecteur nexus-api. Appelle nexus_status avec ping_api=true, puis liste les source_app accessibles. Ne lance aucune ingestion, aucune régénération KG et aucune action admin.

2. nexus-code-kg — Code KG / Meta KG

nexus-code-kg sert les agents développeurs. Il donne accès aux graphes de code, aux findings déterministes, aux contextes patch et à la régénération contrôlée après lot SR.

Réglages client :

Server URL: https://mcpkgcode.auroramind.fr/mcp
Auth: Access token / Bearer token

Smoke :

curl -s https://mcpkgcode.auroramind.fr/health

Règle importante : la régénération réelle (kg_regenerate_submit ou kg_regenerate) exige une confirmation SR ou humaine.

3. nexus-doc-kg — KG documentaire

nexus-doc-kg sert les assistants documentaires et métiers. Il lit les ressources, voisins et sous-graphes documentaires filtrés par :

caller_app
source_app
workspace
project

Réglages client :

Server URL: https://mcpkgdocs.auroramind.fr/mcp
Auth: Access token / Bearer token

Smoke :

curl -s https://mcpkgdocs.auroramind.fr/health

Ce MCP ne doit jamais exposer de régénération de graphe.

4. Caddy et services systemd

Routage actuel :

Checks serveur :

systemctl status nexus-mcp.service
systemctl status nexus-code-kg-mcp.service
systemctl status nexus-doc-kg-mcp.service

5. Packs locaux

Les packs sont regroupés dans :

MCP Servers/MCP_Nexus_API/
MCP Servers/MCP_KG_code/
MCP Servers/MCP_KG_Docs/

Les secrets runtime peuvent être placés localement dans .env, .env.local ou .secrets/. Ces fichiers sont ignorés par Git.

6. Nexus SDK

Le dossier /home/ubuntu/apps/Nexus SDK/ est distinct des MCP. Il contient les SDK TypeScript/Python pour les applications qui intègrent Nexus par code produit ou backend externe. Utiliser le SDK pour une intégration applicative classique; utiliser les MCP pour des agents LLM.