Intégration MCP
MemoryFirst expose un serveur Model Context Protocol (MCP). Tout client compatible (Claude, ChatGPT, Cursor, LM Studio, un agent maison) lit et écrit dans la mémoire de votre entreprise avec votre identité et des citations vérifiables. Un modèle local sans client MCP peut aussi l'utiliser : il reçoit le contexte sous forme de texte.
Le raccourci : demandez-le à votre IA
Si vous ne trouvez pas le menu des connecteurs, ou si vous êtes sur mobile, collez ce message dans votre assistant : il lira cette page et vous dictera les étapes exactes pour votre client.
https://mcp.memoryfirst.ai Installe ceci comme connecteur MCP et donne-moi les étapes exactes pour mon client d'IA.Deux façons de se connecter
Distant (recommandé)
Un seul endpoint HTTP pour tous les clients et tous les membres de l'équipe. Rien à installer ; fonctionne depuis le mobile et depuis claude.ai.
https://mcp.memoryfirst.aiL'ancienne URL continue de fonctionner pour ceux qui l'ont déjà configurée : https://api.memoryfirst.ai/mcp
Clients stdio uniquement
Pour les clients qui ne lancent que des processus locaux (anciens Claude Desktop, scripts), le pont open source mcp-remote se connecte au même serveur distant et s'authentifie avec OAuth. Il n'existe pas de paquet propre sur npm.
npx -y mcp-remote https://mcp.memoryfirst.aiAuthentification et identité
- Clé API: pour les scripts, la CLI et les agents. Elle se crée dans Paramètres → Clés API. Elle est envoyée comme
Authorization: Bearer mf_live_… - OAuth: pour les personnes : le client ouvre l'écran de connexion de MemoryFirst, vous vous connectez avec votre compte et chaque appel est signé avec votre nom et l'IA qui l'a effectué. Sans copier de clés.
- Équipe: chaque membre du workspace a un rôle : propriétaire, membre ou lecture seule. Un lecteur peut se souvenir et interroger, mais pas écrire. Les événements conservent qui les a écrits (personne et modèle).
Configuration par client
- Claude Code:
claude mcp add --transport http memoryfirst https://mcp.memoryfirst.ai --header "Authorization: Bearer mf_live_…" - claude.ai, Claude Desktop, Claude iOS: Paramètres → Connecteurs → Ajouter un connecteur personnalisé avec l'URL ci-dessus ; la connexion se fait par OAuth.
- ChatGPT: Paramètres → Connecteurs → Créer avec l'URL ci-dessus. Utilisez les outils search et fetch du connecteur, en plus des mf_*.
- Cursor, VS Code, Windsurf: ajoutez dans le fichier des serveurs MCP :
{ "mcpServers": { "memoryfirst": { "url": "https://mcp.memoryfirst.ai", "headers": { "Authorization": "Bearer mf_live_…" } } } } - LM Studio, Open WebUI, Jan: tout client de bureau compatible MCP utilise la même URL et la même clé ; le modèle qui tourne sur votre machine lit et écrit dans la mémoire de l'entreprise.
- Agents maison: JSON-RPC 2.0 sur HTTP (initialize, tools/list, tools/call), sans état. N'importe quel SDK MCP fonctionne.
Connecter ChatGPT
- Dans ChatGPT, ouvrez Paramètres → Apps et connecteurs. Si votre offre l'exige pour les connecteurs personnalisés, activez le mode développeur dans les paramètres avancés.
- Cliquez sur Créer, nommez-le MemoryFirst, choisissez l'authentification OAuth et collez comme URL du serveur MCP :
https://mcp.memoryfirst.ai - ChatGPT vous amène à l'écran de MemoryFirst : connectez-vous avec votre compte, choisissez l'espace de travail, le niveau d'accès (Lecture seule est coché par défaut), le périmètre et, si vous le souhaitez, une date d'expiration. Cliquez sur Autoriser.
- Dans une conversation, activez MemoryFirst depuis le menu des outils. ChatGPT cherche avec search et fetch et interroge avec mf_query ; avec Lecture et écriture, il peut aussi enregistrer avec mf_record.
Connecter Claude
- Dans claude.ai, ouvrez Paramètres → Connecteurs → Ajouter un connecteur personnalisé et collez l'URL (dans les offres Team et Enterprise, c'est un administrateur de l'organisation qui l'ajoute) :
https://mcp.memoryfirst.ai - Cliquez sur Connecter : l'écran de MemoryFirst s'ouvre. Connectez-vous, choisissez l'espace, le niveau d'accès, le périmètre et l'expiration, puis cliquez sur Autoriser.
- Le connecteur est disponible dans claude.ai, Claude Desktop et l'application mobile avec le même compte ; activez-le dans chaque conversation depuis le menu des outils.
- Dans Claude Code, ajoutez le serveur et autorisez avec /mcp (ou utilisez une clé API, comme ci-dessus) :
claude mcp add --transport http memoryfirst https://mcp.memoryfirst.ai
Excluez votre propre session des réponses
Si vous envoyez l'en-tête X-MemoryFirst-Session avec l'id de votre session Claude Code, mf_query et search excluent la transcription de cette même session, et la réponse n'est pas la question que vous venez de poser renvoyée en écho. C'est facultatif : sans lui, rien ne change. La valeur doit comporter de 8 à 128 caractères parmi lettres, chiffres, tiret ou tiret bas ; toute autre valeur est ignorée. Claude Code développe les références aux variables d'environnement dans la configuration enregistrée à chaque connexion, de sorte que l'id est lu depuis l'environnement de la session en cours. Dans le terminal, utilisez des guillemets simples pour que la variable ne soit pas développée lors de l'ajout du serveur. Cela suppose que Claude Code expose CLAUDE_CODE_SESSION_ID dans son environnement : si votre version ne l'expose pas, l'en-tête part vide ou non développé et le serveur l'ignore.
En ligne de commande (ajoutez aussi l'en-tête Authorization si vous vous connectez avec une clé API) :
claude mcp add --transport http memoryfirst https://mcp.memoryfirst.ai \
--header 'X-MemoryFirst-Session: ${CLAUDE_CODE_SESSION_ID}'Ou dans .mcp.json :
{
"mcpServers": {
"memoryfirst": {
"type": "http",
"url": "https://mcp.memoryfirst.ai",
"headers": { "X-MemoryFirst-Session": "${CLAUDE_CODE_SESSION_ID}" }
}
}
}Le serveur stdio (@memoryfirst/mcp-server) et les hooks de Claude Code l'envoient déjà d'eux-mêmes lorsqu'ils connaissent l'id de session.
Ce que signifie chaque niveau d'accès
L'application demande un maximum ; vous décidez de ce que vous lui accordez. Elle ne reçoit jamais plus que ce que votre rôle permet : un membre en lecture seule n'écrit pas même s'il choisit l'écriture.
- Lecture seule (par défaut): consulte la mémoire : mf_recall, mf_query, mf_projects, mf_state, search et fetch. Ne peut pas enregistrer d'événements, régénérer l'état ni toucher aux tâches.
- Lecture et écriture: enregistre en plus des décisions et des événements (mf_record), régénère l'état et crée ou met à jour des tâches, signés de votre nom. Risque : si l'IA lit un contenu malveillant (un site web, un e-mail), elle pourrait être induite à écrire de fausses données dans votre mémoire. Ne l'accordez qu'à l'application qui en a vraiment besoin.
- Seulement certains projets: la connexion ne voit que les projets que vous cochez. Les outils qui parcourent tout l'espace (search, mf_morning, mf_assets, mf_skills) lui sont fermés ; dans ChatGPT, interrogez avec mf_query en indiquant le projet.
- Expiration: passée la date que vous choisissez, la connexion cesse de fonctionner et l'application doit redemander l'autorisation.
- Révoquer: dans votre tableau de bord, Applications connectées liste chaque connexion avec son niveau, ses projets, qui l'a approuvée et sa dernière utilisation. Révoquer coupe le renouvellement et la connexion cesse de fonctionner dès son prochain appel.
Installation en un clic
Ouvre l'éditeur avec le serveur déjà configuré. La première fois que vous l'utiliserez, il vous demandera de vous connecter avec votre compte MemoryFirst.
Modèles locaux sans client MCP
Ollama, llama.cpp ou tout modèle qui n'accepte qu'un system prompt : demandez le contexte du projet déjà ramené à un budget de tokens et transmettez-le. C'est le même état que voient les autres ; le client change, pas la mémoire.
# État du projet en markdown, dans le budget demandé CONTEXT=$(curl -s "https://api.memoryfirst.ai/v1/brain/context?project=lexiel&max_tokens=3000" \ -H "Authorization: Bearer $MEMORYFIRST_API_KEY") ollama run llama3.1 --system "$CONTEXT"
Dans Claude Code, c'est déjà automatisé (contexte au démarrage, session distillée en événements à la fin) avec @memoryfirst/claude-hooks.
Outils
Les mêmes en distant et en local ; la parité est vérifiée dans les tests.
mf_recall· décisions, blocages, déploiements et état en vigueur d'un projetmf_query· question en langage naturel avec citations ; restreignable par partition et par type de documentmf_record· enregistre une décision, un blocage, un déploiement, un contact client ; signé avec votre identité et votre IAmf_projects· liste les projets de la mémoire du workspace, avec le nombre d'événements de chacunmf_morning· brief des dernières 24 h du workspace, par typemf_skills· catalogue de skills compilées à partir de questions répétées et leur SKILL.mdmf_assets· registre des actifs et des projets du workspacemf_state· état en vigueur du projet (ce qui reste valable, pas l'historique)search· recherche pour le connecteur ChatGPTfetch· un événement complet par id, pour le connecteur ChatGPT
Citations vérifiables
Chaque réponse de mf_query comporte un spanRef par citation : page et zone dans les documents, millisecondes dans l'audio, id d'événement dans le brain. Votre client les affiche comme des liens vers la source.
{
"answer": "The contract scope is fixed-fee €4,500.",
"citations": [
{
"sourceType": "doc",
"spanRef": { "page": 3, "bbox": [120, 450, 380, 60] },
"snippet": "Fixed fee of €4,500 for the scope defined..."
},
{
"sourceType": "ops",
"spanRef": { "source": "brain.event:decision_taken:78048c2c-…", "eventId": "chunk:0" },
"snippet": "Decision (Jose, claude-code): fixed fee confirmed with the client on 12 May."
}
]
}Schémas détaillés, codes d'erreur et limites par plan : voir la référence API. Il manque quelque chose ? Écrivez à hola [at] memoryfirst.ai.