Référence des outils MCP

Une commande de départ.
Des outils mémoire clairs.

Lancez le setup une fois et redémarrez votre outil IA. Engram apparaît ensuite comme outils MCP avec une guidance de démarrage; consultez les outils ciblés au besoin.

1. Action humaine

Installer une seule fois

Vous lancez une commande terminal : npx engram-tools@0.3.6 --setup <api-key>. Elle écrit la configuration MCP pour Claude Code, Cursor, Gemini, Antigravity, Codex, OpenCode et VS Code/Copilot quand possible.

$ npx -y engram-tools@0.3.6 --setup <api-key>

2. Action agent

Appeler les outils dans l’app IA

Vous ne lancez pas engram_start dans le shell. Après le setup, le client expose les outils Engram et la guidance de démarrage à l’agent. Vous décrivez la tâche normalement; si le client ignore la guidance, collez une fois un court prompt de contexte.

Vous : travaillez sur ce repo/cette tâche. Utilisez le contexte Engram avant de planifier.

3. Pourquoi ça marche

MCP expose Engram comme outils

Après redémarrage, le client IA charge le serveur MCP Engram. Lagent voit engram_start, engram_store, engram_recall, la guidance AGENTS.md et les helpers slash Claude.

L’agent voit : engram_start, engram_store, engram_recall...

Le meilleur premier message pour votre agent

Engram guide aussi l’agent via MCP. Ce prompt rend la première session explicite et aide l’agent à utiliser recall, cross-pollination et rehydrate au bon moment.

L’email de bienvenue l’inclut aussi. Ici, c’est un secours si le client AI ignore le guidage MCP au démarrage.

Appelle engram_start avec ce contexte:
  project: <produit ou client>
  repo: <repo>
  role: <rôle>
  market: <domaine ou marché>
  stack: <technologies principales>
  task: <tâche actuelle>
Avant de choisir une approche, appelle engram_recall.
Si un autre repo a peut-être résolu ce pattern, appelle engram_cross_pollinate.
Si le chat a été compacté ou repris, appelle engram_rehydrate.

Configuration par client

La commande de setup gère cela automatiquement. Ces exemples montrent les formats exacts des clients qui n’utilisent pas le JSON standard.

Antigravity

Le flux Gemini actuel peut envoyer les utilisateurs vers Antigravity. Engram écrit la config Gemini partagée et les fichiers propres à Antigravity.

// ~/.gemini/config/mcp_config.json
// ~/.gemini/antigravity/mcp_config.json
{
  "mcpServers": {
    "engram": {
      "command": "npx",
      "args": ["-y", "engram-tools", "mcp"]
    }
  }
}

OpenCode

OpenCode utilise un tableau de commande au lieu du format mcpServers. Le setup écrit ce format automatiquement.

// ~/.config/opencode/opencode.json
{
  "mcp": {
    "engram": {
      "type": "local",
      "command": ["npx", "-y", "engram-tools", "mcp"],
      "enabled": true
    }
  }
}

Codex

Codex utilise TOML. Engram remplace uniquement la table engram et conserve le reste de la config Codex.

# ~/.codex/config.toml
[mcp_servers.engram]
type = "stdio"
command = "npx"
args = ["-y", "engram-tools", "mcp"]

Outils

Choisissez un outil à inspecter

Boucle principale

Outils du flux normal et reprise après compaction.

Avancés et checkpoints

Disponibles, mais à utiliser seulement avec un vrai déclencheur.

Choisissez un outil à inspecter

engram_start

À utiliser quand l’agent doit démarrer une session.

engram_start

Outil Engram pour démarrer une session.

À utiliser quand l’agent doit démarrer une session.

agent_tool

optionnel

string