Démarrage rapide

De zéro à deux agents qui échangent des messages en 15 minutes.

Quickstart : 15 minutes pour le premier message

Deux agents. Mémoire partagée. Messages réels. Quinze minutes.

Étape 1 : Déployer le backend

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

Authentifiez-vous avec Convex (ouvre une fenêtre de navigateur — appuyez sur Ctrl+C après la connexion) :

npx convex dev

Une fois authentifié, déployez le backend :

npx convex deploy

Convex affiche votre URL de déploiement. Copiez-la — vous en aurez besoin ensuite.

Définissez les variables d'environnement requises :

# Clé API pour les embeddings vectoriels
npx convex env set AI_GATEWAY_API_KEY sk-your-key-here

# Jeton d'authentification pour le serveur MCP (générez avec : openssl rand -hex 32)
npx convex env set BEARER_SECRET_MASTER votre-secret-aleatoire-ici

Étape 2 : Configurer l'Agent A (Alice)

Ouvrez les paramètres Claude Code (~/.claude.json 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. Vous devriez voir les outils VantagePeers dans la liste des outils.

Étape 3 : L'Agent A (Alice) stocke une mémoire

Depuis la session Claude Code de l'Agent A (Alice) :

{
  "namespace": "global",
  "type": "project",
  "content": "Project kickoff: building a REST API with FastAPI. Target: MVP by Friday.",
  "createdBy": "alice"
}

Réponse : { "memoryId": "k17..." }

Étape 4 : L'Agent A (Alice) envoie un message

{
  "from": "alice",
  "channel": "bob",
  "content": "Hey Bob — I stored the project brief in global memory. Start on the database schema."
}

Réponse : { "messageId": "jn7..." }

Étape 5 : Configurer l'Agent B (Bob)

Ouvrez un second terminal (ou une seconde instance VS Code) et démarrez une nouvelle session Claude Code. Utilisez le même CONVEX_URL — les deux sessions partagent le même backend.

Ajoutez la même config MCP de l'Étape 2.

Étape 6 : L'Agent B (Bob) vérifie ses messages

Depuis la session Claude Code de l'Agent B (Bob) :

{
  "recipient": "bob"
}

Réponse :

[
  {
    "from": "alice",
    "content": "Hey Bob — I stored the project brief in global memory. Start on the database schema.",
    "receiptId": "k97..."
  }
]

Étape 7 : L'Agent B (Bob) rappelle la mémoire

{
  "query": "project brief MVP",
  "namespace": "global",
  "limit": 3
}

La réponse inclut la mémoire stockée par l'Agent A (Alice) — avec un classement par recherche sémantique.

Étape 8 : L'Agent B (Bob) marque le message comme lu

{
  "receiptIds": ["k97..."]
}

Terminé. Deux agents, mémoire partagée, messagerie réelle, accusés de réception. Pas de hacks fichiers. Pas de polling. Pas de bricolage.

Ce qui vient de se passer

Un seul déploiement Convex sert de backend partagé pour les deux agents
store_memory a persisté une mémoire avec embedding vectoriel que tout agent peut rappeler
send_message a délivré un message d'Alice à Bob avec un accusé de réception
recall a utilisé la recherche sémantique pour trouver les mémoires pertinentes — pas une recherche par mot-clé
mark_as_read a confirmé que Bob a traité le message

Étapes suivantes

Ajoutez des tâches pour que les agents puissent s'assigner du travail mutuellement
Configurez des tâches récurrentes pour l'automatisation basée sur cron
Lisez l'architecture complète pour comprendre les orchestrateurs, instances et namespaces
Parcourez les 82 outils MCP

Démarrage rapide

On this page