Documentation

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

Démarrage rapide

  1. 1
    Crée un compte
    Inscris-toi et crée un projet. Une clé API est générée.
  2. 2
    Récupère clé + projet
    Copie ta clé API (API Keys) et l’ID de projet (page du projet).
  3. 3
    Colle la config
    Ajoute le bloc MCP dans ton agent (ci-dessous), puis redémarre-le.
MCP

Installation par agent

Remplace les valeurs memexa_sk_prod_••• et your-project-id.

Cursor .cursor/mcp.json
mcp.json
{
  "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 Code CLI
macOS / Linux bash · zsh
terminal
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-server
Windows PowerShell
PowerShell
claude 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).

opencode opencode.json
opencode.json
{
  "$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.

ENV

Variables d’environnement

MEMEXA_API_KEYreq
Ta clé API. Depuis le dashboard → API Keys.
MEMEXA_API_URLreq
URL de l'API. Utilise https://api.memexa.tech/v1.
MEMEXA_PROJECT_IDreq
ID du projet. Depuis la page du projet.
MEMEXA_AGENTopt
Libellé de l'agent affiché dans l'activité (ex : cursor, claude-code).
Modèle

Concepts

Entrée de contexte
Décision, bug, convention ou snapshot de progression. Versionnée, interrogeable.
Snapshot / commit
État agrégé et immuable d’une session, visible dans le graph.
Proposition (PR)
Modification suggérée d’une entrée, en attente de validation.
Contradiction
Deux entrées qui se contredisent sémantiquement.
Outils

Session & contexte

get_context
Restaure le contexte compressé et pertinent du projet au démarrage de session.
update_context
Met à jour le contexte en fin de session : décisions, bugs, progression.
get_project_status
Résumé rapide de l'état du projet.
validate_context
Analyse la cohérence du contexte et retourne un rapport de santé.
get_insights
Insights pré-calculés : patterns, score de santé, alertes, trajectoire.
get_contradictions
Entrées qui se contredisent sémantiquement, à résoudre.
Outils

Connaissance

add_decision
Enregistre une décision avec contexte, alternatives et raisonnement complet.
log_bug
Enregistre un bug : description, cause racine, solution.
get_decision_history
Timeline chronologique des décisions architecturales.
search_memory
Recherche sémantique dans l'historique complet du projet.
search_cross_project
Recherche sémantique dans tous les projets de l'utilisateur.
compare_sessions
Diff structuré entre l'état actuel et l'état il y a N sessions.
Outils

Collaboration (propositions)

propose_change
Propose une modification à une entrée — PR en attente de validation.
list_proposals
Liste les propositions (pending, approved, rejected).
merge_proposal
Approuve et fusionne une proposition. Crée une nouvelle version.
reject_proposal
Rejette une proposition sans l'appliquer.
Outils

Versions

get_entry_versions
Historique des versions d'une entrée.
restore_version
Restaure une entrée à une version antérieure.
Outils

Commits d'état

create_commit
Snapshot agrégé (décisions, bugs, PRs) visible dans le graph.
list_commits
Liste tous les commits d'état du projet.
Automatiser

Rè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.

CLAUDE.md · .cursorrules
# 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.

Accès

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_).

© 2026 Memexa · https://api.memexa.tech/v1