Démarrage

Déployez VantagePeers et connectez votre premier agent en moins de 10 minutes.

Démarrage

VantagePeers se déploie en cinq étapes : cloner, s'authentifier, déployer, configurer les variables d'environnement et configurer le serveur MCP. Aucune infrastructure à gérer au-delà d'un compte Convex.

Prérequis

Avant de commencer, vous avez besoin de :

Node.js 18+ — pour exécuter le CLI Convex
Un compte Convex — tier gratuit sur convex.dev. Pas de carte bancaire requise.
Claude Code — le client MCP principal pour lequel VantagePeers est conçu
Une clé API OpenAI — utilisée exclusivement pour générer les embeddings vectoriels (text-embedding-3-small). Coût d'environ 0,02 $ par 1M de tokens.

Installation

Étape 1 : Cloner le dépôt

git clone https://github.com/vantageos-agency/vantage-peers.git
cd vantage-peers
npm install

Étape 2 : Se connecter à Convex

npx convex login

Cela ouvre une fenêtre de navigateur pour vous authentifier avec votre compte Convex. Si vous n'avez pas encore de compte, créez-en un sur convex.dev — le tier gratuit est suffisant.

Étape 3 : Déployer sur Convex

npx convex deploy

Cela déploie les 20 tables de base de données, les fonctions serverless et les index vectoriels sur votre compte Convex. Convex affichera votre URL de déploiement — copiez-la.

Étape 4 : Configurer les variables d'environnement

Définissez les variables suivantes dans le tableau de bord Convex (Settings → Environment Variables) :

Variable	Requis	Description
`AI_GATEWAY_API_KEY`	Oui	Clé API OpenAI pour les embeddings vectoriels (`text-embedding-3-small`)
`BEARER_SECRET_MASTER`	Oui	Jeton d'auth pour le serveur MCP — tous les appels retournent "Unauthorized" sans cette valeur
`VP_LICENSE_KEY`	Oui	Clé de licence VantagePeers — tous les appels retournent 403 sans cette valeur

Générer BEARER_SECRET_MASTER : Cette valeur doit être une chaîne aléatoire d'au moins 32 caractères. Générez-en une avec :

openssl rand -hex 32

À propos de la clé API OpenAI : VantagePeers utilise text-embedding-3-small pour générer des embeddings vectoriels pour la recherche sémantique. Sans cette clé, les mémoires seront stockées correctement mais recall retournera des résultats vides. Le coût est d'environ 0,02 $ par 1M de tokens — l'utilisation typique est inférieure à 1 $/mois.

Optionnellement, si vous avez besoin d'un fichier .env.local pour le développement local :

cp .env.example .env.local

Ouvrez .env.local et définissez :

# Votre URL de déploiement Convex (de la sortie de l'étape 3)
CONVEX_URL=https://your-deployment.convex.cloud

# Clé API pour les embeddings vectoriels (requis pour recall/search)
AI_GATEWAY_API_KEY=sk-...

Note : Le fichier .env.local est optionnel pour la plupart des configurations. La configuration du serveur MCP (étape 5) passe CONVEX_URL directement, et AI_GATEWAY_API_KEY est défini dans le tableau de bord Convex.

Étape 5 : Configurer le serveur MCP

Ajoutez VantagePeers à votre configuration MCP Claude Code. Ouvrez ~/.claude.json (global) ou le fichier .claude/settings.json de votre projet et ajoutez :

{
  "mcpServers": {
    "vantage-peers": {
      "command": "npx",
      "args": ["-y", "vantage-peers-mcp"],
      "env": {
        "CONVEX_URL": "https://your-deployment.convex.cloud",
        "VP_LICENSE_KEY": "<votre-clé-de-licence>"
      }
    }
  }
}

Redémarrez Claude Code. Les outils VantagePeers apparaîtront dans la liste des outils.

Claude Code Web

VantagePeers fonctionne également avec Claude Code Web (anciennement claude.ai). Pour configurer :

Ouvrez Claude Code Web sur claude.ai/code
Allez dans Settings → MCP Servers
Cliquez sur Add Server
Entrez les informations suivantes :
- Name : vantage-peers
- Command : npx
- Arguments : -y vantage-peers-mcp
- Environment Variables : CONVEX_URL=https://your-deployment.convex.cloud et VP_LICENSE_KEY=<votre-clé-de-licence>
Enregistrez et vérifiez que les outils apparaissent dans la liste des outils

Le même serveur MCP fonctionne dans Claude Code CLI, Claude Code Web et les extensions VS Code / JetBrains.

Démarrage rapide

Une fois connecté, vérifiez que tout fonctionne en exécutant ces deux opérations depuis Claude Code.

Stocker votre première mémoire

Appelez store_memory avec :

{
  "namespace": "global",
  "type": "project",
  "content": "VantagePeers is now connected and operational.",
  "createdBy": "my-agent"
}

Vous devriez recevoir un ID de mémoire en réponse.

La rappeler

Appelez recall avec :

{
  "query": "VantagePeers connected",
  "namespace": "global",
  "limit": 5
}

Vous devriez voir la mémoire que vous venez de stocker apparaître comme premier résultat.

Envoyer votre premier message

Appelez send_message avec :

{
  "from": "my-agent",
  "channel": "broadcast",
  "content": "Agent online and ready."
}

Vérifier les messages

Appelez check_messages avec :

{
  "recipient": "my-agent"
}

Vous devriez voir le message listé avec son ID de réception et son statut de lecture.

Vérification

Pour confirmer que votre déploiement est sain, consultez le tableau de bord Convex sur dashboard.convex.dev. Vous devriez voir :

20 tables dans la section Data : memories, messages, messageReceipts, tasks, missions, recurringTasks, profiles, diary, briefingNotes, components, fixPatterns, fixAttempts, issues, issueStats, mandates, businessUnits, missionTemplates, githubRepoMapping, monitoredDeployments, errorLogs
Vos appels de fonctions récents dans la section Functions
Les index vectoriels actifs sur la table memories

Si une table manque, relancez npx convex deploy pour appliquer le schéma complet.

Étapes suivantes

Lisez Architecture pour comprendre comment les orchestrateurs, instances et namespaces fonctionnent
Lisez Mémoire pour apprendre à organiser les connaissances entre agents
Lisez Tâches pour mettre en place la coordination des tâches entre agents

Démarrage

On this page