Branche la mémoire à ton agent.
Memexa expose 20 outils via le protocole MCP. Pas de code à écrire — colle une config dans ton agent et c’est branché.
Démarrage rapide
- 1Crée un compteInscris-toi et crée un projet. Une clé API est générée.
- 2Récupère clé + projetCopie ta clé API (API Keys) et l’ID de projet (page du projet).
- 3Colle la configAjoute le bloc MCP dans ton agent (ci-dessous), puis redémarre-le.
Installation par agent
Remplace les valeurs memexa_sk_prod_••• et your-project-id.
{
"mcpServers": {
"memexa": {
"command": "npx",
"args": ["-y", "@memexa/mcp-server"],
"env": {
"MEMEXA_API_KEY": "memexa_sk_prod_•••",
"MEMEXA_API_URL": "https://api.memexa.tech/v1",
"MEMEXA_PROJECT_ID": "your-project-id"
}
}
}
}claude mcp add memexa --env MEMEXA_API_KEY=memexa_sk_prod_••• --env MEMEXA_API_URL=https://api.memexa.tech/v1 --env MEMEXA_PROJECT_ID=your-project-id -- npx -y @memexa/mcp-serverclaude mcp add-json memexa '{"command":"npx","args":["-y","@memexa/mcp-server"],"env":{"MEMEXA_API_KEY":"memexa_sk_prod_•••","MEMEXA_API_URL":"https://api.memexa.tech/v1","MEMEXA_PROJECT_ID":"your-project-id"}}'Sous PowerShell, le séparateur « -- » est avalé par le shell : utilise add-json (un seul argument JSON, rien à mal interpréter).
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"memexa": {
"type": "local",
"command": ["npx", "-y", "@memexa/mcp-server"],
"enabled": true,
"env": {
"MEMEXA_API_KEY": "memexa_sk_prod_•••",
"MEMEXA_API_URL": "https://api.memexa.tech/v1",
"MEMEXA_PROJECT_ID": "your-project-id"
}
}
}
}Tout client compatible MCP fonctionne avec le bloc mcpServers ci-dessus.
Variables d’environnement
MEMEXA_API_KEYreqMEMEXA_API_URLreqMEMEXA_PROJECT_IDreqMEMEXA_AGENToptConcepts
Session & contexte
get_contextupdate_contextget_project_statusvalidate_contextget_insightsget_contradictionsConnaissance
add_decisionlog_bugget_decision_historysearch_memorysearch_cross_projectcompare_sessionsCollaboration (propositions)
propose_changelist_proposalsmerge_proposalreject_proposalVersions
get_entry_versionsrestore_versionCommits d'état
create_commitlist_commitsRègles agent (automatique)
Un agent MCP n’appelle les outils que s’il sait quand le faire. Dépose ce fichier à la racine de ton projet (CLAUDE.md pour Claude Code, .cursorrules pour Cursor, règles projet pour opencode) : l’agent chargera et sauvegardera la mémoire tout seul, à chaque session — sans que tu aies à le demander.
# Memexa — persistent project memory (MCP)
This project uses Memexa: shared memory that persists across AI coding sessions.
Every new session starts amnesic — Memexa restores what previous sessions knew.
Use the tools yourself, proactively; do not wait to be asked.
## Session protocol
1. At the START of every session, before anything else:
- get_context — load the project's memory (decisions, bugs, conventions, progress).
- Empty result = new project: start fresh and begin recording.
2. WHILE working, record as you go (never batch to the end):
- add_decision — on every architectural/technical choice, with reasoning + rejected alternatives.
- log_bug — on every bug found or fixed, with root cause + fix.
3. Before ENDING a task:
- update_context — persist this session's progress, decisions and bugs.
- create_commit — snapshot the session so it shows in the project timeline.
## Reach for these when relevant
- search_memory — before building something, check if it was already decided/tried here.
- search_cross_project — how you solved a similar problem in your other projects.
- get_decision_history — the chronological trail of architectural decisions.
- get_contradictions — surface entries that now conflict; resolve them.
- get_project_status / validate_context / get_insights — health of the memory (coherence, patterns, alerts).
- compare_sessions — diff the current state against N sessions ago.
- get_entry_versions / restore_version — inspect or roll back a specific entry.
- propose_change / list_proposals / merge_proposal / reject_proposal — with multiple agents, suggest edits as reviewable changes instead of overwriting.
- list_commits — list the project's state snapshots.
## Rules
- Load memory FIRST; never re-ask for what is already in memory.
- Record decisions and bugs the moment they happen, concisely, in your own words.
- Update or search existing entries instead of creating duplicates.Nouveau projet = mémoire vide au premier get_context : c’est normal, l’agent la remplit au fil des sessions.
Clés API & projet
Ta clé API authentifie l’agent (en-tête X-Memexa-Key). L’ID de projet cible la mémoire concernée.
Ne commite jamais ta clé (préfixe memexa_sk_).