MCP maison VFG — guide d'installation et état machine FG (15 août 2026)

TL;DR

• MCP ici = outils structurés que l'agent appelle avant de greper le disque : docs SSOT, bus fleet, actions gate, plus utilitaires (markdown, watts, commands, telemetry).
• Catalogue usage : T1 = docs / feed / gate ; T2 = markdown / neuralwatts ; T3 = commands / telemetry (+ Citadelle optionnelle).
• Sur la machine FG (2026-08-15) : trio T1 câblé dans le workspace VFG_PT__ et vivant en public (HTTP 200) ; ~/.cursor/mcp.json global = {} ; aucun Bearer T2/T3 ni VFG_ADMIN_PASSWORD en variables utilisateur ; ports loopback MCP fermés.
• Ce billet synthétise et pointe les SSOT existants — il ne remplace pas le catalogue ni les runbooks.

1. Qu'est-ce qu'un MCP « maison » ici ?

Un serveur MCP VFG expose une petite surface d'outils (boot, search docs, snapshot, wizz, publish…) que Cursor / OpenCode / Claude appellent via HTTP (SSE ou JSON-RPC). L'intérêt n'est pas « encore une API » : c'est réduire le contexte et forcer un ordre — lire la carte avant de fouiller le terrain.

Phrase agent (canon) :

Lis vfg-docs avant grep local ; vfg-feed pour le bus ; vfg-gate seulement pour agir.

Deux grilles se croisent (ne pas les confondre) :

La synthèse juin documente le catalogue ; le runbook juillet documente le déploiement et l'incident 502. Les deux restent valides.

2. Catalogue des 7 (+ Citadelle)

Placeholders uniquement. Les path-secrets et Bearer ne vont jamais dans un article, un commit, ou un chat.

Health publics utiles (sans secret) : https://mcp-docs.vfg.lol/healthz, https://mcp-feed.vfg.lol/healthz, https://mcp-vfg.vfg.lol/healthz.

Inventaire outils T1 (rappel court) : docs ≈ 5 outils lecture ; feed ≈ 9 lecture ; gate ≈ 7 écriture — détail dans .cursor/MCP-README.md.

3. Install Cursor — workspace vs global

3.1 Workspace D:\VFG_PT__\.cursor\mcp.json (recommandé pour le metaprojet)

C'est la config effective sur FG aujourd'hui : trio T1 uniquement (vfg-docs, vfg-feed, vfg-gate), URLs VPS avec path-secret.

Avantage : scoped au workspace VFG ; pas de pollution des autres projets Cursor.

3.2 Global C:\Users\FG\.cursor\mcp.json

Aujourd'hui : {"mcpServers": {}}.

Pour avoir le trio T1 dans tout Cursor (hors workspace VFG_PT__) :

1. Copier le bloc T1 du workspace (ou générer via le kit catalogue / generate-mcp-configs quand dispo).
2. Ne pas coller de Bearer en clair — utiliser ${MCP_COMMANDS_AUTH_TOKEN} etc. pour T2/T3.
3. Reload MCP dans Cursor.

3.3 Variables d'environnement (noms seulement)

Définir au niveau utilisateur Windows, redémarrer Cursor. Ne jamais committer les valeurs.

Doc client multi-IDE : RAPPORT-EXPERIENTIEL/docs/SETUP-MCP-BLOG-ARTICLES.md et docs/MCP-CROSS-IDE-SETUP.md (attention : certains docs historiques peuvent contenir des secrets — les traiter comme hors-ligne, pas comme source à republier).

4. Variante loopback vs VPS

Règle anti-doublon : ne jamais charger en même temps le même serveur logique en local et en VPS — outils dupliqués, latence, confusion.

Sur FG au 15/08 : ports 4340–4342 et 5194/5197/5198/5199 = closed → mode VPS uniquement, cohérent avec le câblage workspace.

5. Règles d'usage agent

1. docs avant grep — vfg_search_docs / vfg_boot_context / vfg_ssot_get avant Read/Grep sur STATUS, handoffs, SSOT.
2. feed pour le vivant — idées #N, snapshot, events, runbook hotfix.
3. gate seul pour agir — wizz, OSC, deploy R3 (confirmR3:true) ; jamais en doublon ouvert.
4. markdown = secondaire — index lourd ; docs reste primaire SSOT-aware.
5. publish blog — outil vfg_commands_devblog_publish (T3) ou node scripts/publish-local.mjs … avec VFG_ADMIN_* ; un git push ne publie plus les articles.
6. Hors MCP — code src/, git dirty, tests : outils locaux.

Règle Cursor workspace : .cursor/rules/vfg-mcp-docs.mdc. Guide contexte : billet MCP-first (lien §7).

6. État machine FG — 2026-08-15

Sondage live (Windows FG), sans exposer de secrets :

Ce qui marche : lire docs / feed / gate depuis le workspace VFG_PT__ (si Cursor a chargé le projet). Santé publique T1 OK.

Ce qui manque : tokens T2/T3 ; password admin blog côté user ; câblage global ; stack loopback ; outil publish dans les sessions hors workspace.

7. Liens SSOT (ne pas dupliquer)

8. Checklist next steps (FG)

• Copier le trio T1 workspace → C:\Users\FG\.cursor\mcp.json (Reload MCP).
• Poser les variables User : MCP_COMMANDS_AUTH_TOKEN, TELEMETRY_AUTH_TOKEN (et optionnel NEURALWATTS_AUTH_TOKEN, CITADELLE_TOKEN).
• Ajouter T2/T3 dans le mcp.json choisi (workspace ou global — pas les deux pour le même serveur).
• Poser VFG_ADMIN_PASSWORD (+ VFG_ADMIN_BACKEND_URL=https://blog.vfg.lol) pour publish CLI.
• Smoke : vfg_boot_context + vfg_gate_health ; puis draft via vfg_commands_devblog_publish ou publish-local.mjs.
• Ne pas démarrer loopback en parallèle du VPS tant que le câblage n'est pas explicitement « local-only ».
• Traiter les docs cross-IDE qui contiennent encore des secrets en clair : rotation + purge des copies republables.

Commande publish (quand le secret admin est dispo)

cd D:\VFG_PT__\RAPPORT-EXPERIENTIEL
# dry-run
node scripts/publish-local.mjs devblog/posts/workflows-agentiques/2026-08-15-guide-mcp-maison-vfg-etat-machine-fg.md --dry-run

# prod
set VFG_ADMIN_BACKEND_URL=https://blog.vfg.lol
set VFG_ADMIN_PASSWORD=<secret-local-jamais-commité>
node scripts/publish-local.mjs devblog/posts/workflows-agentiques/2026-08-15-guide-mcp-maison-vfg-etat-machine-fg.md

URL attendue après publish :

https://blog.vfg.lol/devblog/posts/workflows-agentiques/2026-08-15-guide-mcp-maison-vfg-etat-machine-fg.md.html

9. Méthode de ce sondage

• Boot VFG : node scripts/dev-meta.js boot --project blog (VFVFGPT).
• Croisement blog ?tag=mcp, MCP-README, SETUP-MCP-BLOG-ARTICLES, MCP-CROSS-IDE-SETUP, WORKFLOW-PUBLICATION-BLOG, articles juillet (runbook, MCP-first, câblage, PR#42).
• Probes HTTP status-only ; inventaire env noms ; inspection mcp.json sans recopier les path-secrets.

Fin — guide opérationnel + rapport d'état, 2026-08-15.