Se connecter via MCP

Mnemom exploite deux serveurs publics Model Context Protocol. Les deux utilisent le transport streamable-HTTP, donc tout client MCP qui prend en charge les serveurs HTTP distants peut s’y connecter.

Plan de contrôle

https://api.mnemom.ai/mcp75 outils reflétant la CLI mnemom — Trust Ratings, cartes d’alignement et de protection, signaux de gouvernance, postures, équipes, webhooks et clés API. tools/list est public ; l’exécution des outils s’authentifie exactement comme l’API REST.

Recherche dans la doc

https://docs.mnemom.ai/mcpTrois outils — search_mnemom_docs et query_docs_filesystem_mnemom_docs (tous deux en lecture seule, sur cette documentation et la spécification OpenAPI), plus submit_feedback (dépose un signalement sur une page de documentation). Aucune authentification.

Le plan de contrôle s’authentifie avec les mêmes identifiants que l’API REST : un Bearer token (un token d’accès OAuth, obtenu de la même façon que mnemom login en obtient un — voir Flux OAuth device) ou une X-Mnemom-Api-Key. Consultez Authentification. Le serveur de recherche dans la doc ne nécessite aucune authentification.

Authentification

Définissez votre token une fois dans l’environnement, puis référencez-le depuis chaque configuration client :

export MNEMOM_TOKEN="<your Bearer access token or mnm_… API key>"

Le serveur du plan de contrôle transmet la valeur telle quelle sous forme Authorization: Bearer <token>. Pour utiliser une clé API à la place, envoyez-la dans l’en-tête X-Mnemom-Api-Key.

Un client MCP qui implémente la découverte OAuth 2.1 n’a besoin d’aucun token collé manuellement : un appel non authentifié reçoit un 401 avec un en-tête WWW-Authenticate pointant vers https://api.mnemom.ai/.well-known/oauth-protected-resource/mcp, et le client peut suivre ce lien vers une connexion navigateur classique. L’en-tête manuel Authorization/X-Mnemom-Api-Key ci-dessous est l’alternative explicite et scriptée pour les clients qui ne font pas de découverte OAuth.

Configuration du client

Claude Code
Cursor
VS Code
Claude Desktop

Ajoutez les deux serveurs depuis la CLI :

# Control plane (authenticated)
claude mcp add --transport http mnemom https://api.mnemom.ai/mcp \
  --header "Authorization: Bearer $MNEMOM_TOKEN"

# Docs search (read-only, no auth)
claude mcp add --transport http mnemom-docs https://docs.mnemom.ai/mcp

Listez les serveurs enregistrés avec claude mcp list.

Ajoutez à ~/.cursor/mcp.json (global) ou .cursor/mcp.json (par projet) :

{
  "mcpServers": {
    "mnemom": {
      "url": "https://api.mnemom.ai/mcp",
      "headers": { "Authorization": "Bearer ${MNEMOM_TOKEN}" }
    },
    "mnemom-docs": {
      "url": "https://docs.mnemom.ai/mcp"
    }
  }
}

Ajoutez à .vscode/mcp.json dans votre espace de travail :

{
  "servers": {
    "mnemom": {
      "type": "http",
      "url": "https://api.mnemom.ai/mcp",
      "headers": { "Authorization": "Bearer ${MNEMOM_TOKEN}" }
    },
    "mnemom-docs": {
      "type": "http",
      "url": "https://docs.mnemom.ai/mcp"
    }
  }
}

Claude Desktop lance les serveurs MCP comme des processus locaux, alors reliez les points de terminaison distants avec mcp-remote. Ajoutez à claude_desktop_config.json :

{
  "mcpServers": {
    "mnemom": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://api.mnemom.ai/mcp",
        "--header", "Authorization: Bearer ${MNEMOM_TOKEN}"
      ]
    },
    "mnemom-docs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://docs.mnemom.ai/mcp"]
    }
  }
}

Redémarrez Claude Desktop après avoir modifié la configuration.

Vérifier la connexion

tools/list est public sur les deux serveurs, vous pouvez donc confirmer l’accessibilité avec un appel JSON-RPC brut avant de câbler un client :

curl -sS -X POST https://api.mnemom.ai/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' \
  | jq '.result.tools | length'

Vous devriez voir le nombre d’outils (75 pour le plan de contrôle, 3 pour la recherche dans la doc). L’exécution des outils sur le plan de contrôle applique la même autorisation que l’appel REST équivalent — un client non authentifié peut énumérer les outils mais pas invoquer ceux qui sont privilégiés.

Découverte

Le serveur du plan de contrôle publie une carte de serveur MCP découvrable (forme server.json) à https://www.mnemom.ai/.well-known/mcp/server-card.json. Les clients qui résolvent les cartes de serveur peuvent se configurer à partir de cette unique URL.

Carte des surfaces pour agents

L’ensemble complet des surfaces de Mnemom destinées aux agents — fichiers de découverte, métadonnées well-known et les deux points de terminaison MCP — est catalogué sur la page For Agents.

​Se connecter via MCP

Plan de contrôle

Recherche dans la doc

​Authentification

​Configuration du client

​Vérifier la connexion

​Découverte

Carte des surfaces pour agents

Se connecter via MCP

Authentification

Configuration du client

Vérifier la connexion

Découverte