VantagePeers Docs

Installation

Installez le plugin Claude Code vantage-peers, configurez .mcp.json, complétez CLAUDE.md et vérifiez votre configuration en 5 étapes.

Installation

Prérequis

Avant d'installer le plugin :

  • Un serveur MCP VantagePeers opérationnel. Déployez sur Railway : vantagepeers.com/railway. Notez votre URL (ex. https://vantage-peers-abc123.railway.app) et BEARER_SECRET.
  • Claude Code installé et fonctionnel dans votre workspace.

Installer le plugin

claude plugin install vantage-peers

Cela installe les skills, hooks, commandes et l'agent vantage-peers-expert dans votre workspace Claude Code.

Configurer .mcp.json

Copiez le template du plugin :

{
  "mcpServers": {
    "vantage-peers": {
      "type": "http",
      "url": "https://votre-déploiement.railway.app/mcp",
      "headers": {
        "Authorization": "Bearer votre-secret-bearer"
      }
    }
  }
}

Enregistrez en tant que .mcp.json à la racine de votre workspace. Redémarrez Claude Code après l'enregistrement.

Consultez Tokens Bearer pour le format du secret Bearer et comment en obtenir un.

Compléter le template CLAUDE.md

Le plugin inclut un fichier templates/CLAUDE.md.append avec les protocoles de workflow VP (recall-before-assumptions, protocole de tâches, conventions de namespace). Ajoutez son contenu à la fin de votre CLAUDE.md de workspace :

cat "$(claude plugin path vantage-peers)/templates/CLAUDE.md.append" >> CLAUDE.md

Cela installe le contexte de protocole VP dont les skills dépendent (détection d'identité d'orchestrateur, basculement de mode, conventions de namespace).

Exécuter l'init et vérifier

/vantage-peers-init

Cela exécute 3 vérifications :

  1. Enregistrement MCP — confirme que le serveur vantage-peers est visible dans la liste d'outils de Claude Code
  2. Connectivité — appelle /health sur votre URL de déploiement, attend { status: "ok" }
  3. Auth — teste l'authentification Bearer via un appel recall

Les 3 vérifications doivent afficher PASS. En cas d'échec, le skill fournit une suggestion de correction pour chaque échec.

Premières commandes

/check-messages
/check-tasks
/daily-start
  • /check-messages — interroge votre boîte de réception ; attendez-vous à "No new messages" sur un déploiement vierge
  • /check-tasks — liste vos tâches assignées
  • /daily-start — charge le contexte VP et présente votre plan de session

Vérifier que les skills et hooks sont actifs

Après l'installation, confirmez que le plugin est chargé :

claude plugin list

Vous devriez voir vantage-peers avec la version 2.4.0.

Pour vérifier que les hooks fonctionnent, essayez de créer une tâche de test sans blocs VERIFICATION/TESTS :

/vantage-peers-init

Le hook enforce-task-quality bloquera tout appel create_task sans la structure requise.

Les hooks s'exécutent silencieusement sur chaque appel d'outil correspondant. Ils n'apparaissent pas dans la conversation sauf s'ils bloquent une action. Si un hook bloque, il affiche la raison et le correctif — lisez le message avant de réessayer.

Dépannage

SymptômeCauseCorrection
/vantage-peers-init échoue vérification 1 (enregistrement MCP).mcp.json introuvable ou malforméVérifiez que .mcp.json existe à la racine du workspace et que le JSON est valide
/vantage-peers-init échoue vérification 2 (connectivité)URL incorrecte ou service Railway en veilleVérifiez le tableau de bord Railway — réveillez le service, vérifiez que l'URL se termine par /mcp
/vantage-peers-init échoue vérification 3 (auth)Mauvais secret BearerVérifiez que BEARER_SECRET correspond à la variable d'env BEARER_SECRET_MASTER sur Railway
Hook bloque de façon inattendueLe contenu correspond à un pattern de hookLisez le message de blocage — il explique la règle et le correctif

On this page