Integration

Die Engine als MCP-Server an Claude anbinden oder per HTTP-API aus eigenen Apps nutzen.

Claude Code

One-Liner - fügt die Engine als MCP-Server hinzu:

claude mcp add memory-engine --transport http "https://engine.mmcp.dev/mcp" --header "Authorization: Bearer YOUR_API_KEY"

Claude Desktop

Füge diesen Block in deine claude_desktop_config.json ein. Auf dem Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "memory-engine": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://engine.mmcp.dev/mcp",
        "--header",
        "Authorization: Bearer ${MMCP_API_KEY}",
        "--transport",
        "streamablehttp"
      ],
      "env": {
        "MMCP_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Node-Version-Problem?

Claude Desktop findet manchmal eine zu alte Node-Version (z.B. v14). mcp-remote braucht Node ≥18. Lösung: ersetze "command": "npx" mit dem vollen Pfad zu Node und setze den npx-Pfad als erstes Argument.

"command": "/pfad/zu/node",
"args": ["/pfad/zu/npx", "mcp-remote", ...],
"env": { "PATH": "/pfad/zu/node/bin:/usr/local/bin:/usr/bin:/bin" }

Node-Pfad finden: which node (Mac/Linux) oder where node (Windows)

claude.ai (Remote MCP)

claude.ai unterstützt Remote MCP Server. Gehe zu Settings → Integrations → Add Custom Integration und gib die Engine-URL ein:

https://engine.mmcp.dev/mcp

HTTP API (eigene Apps)

Direkte Integration per JSON-RPC 2.0. Kein MCP-Client noetig.

Memory speichern

curl -X POST https://engine.mmcp.dev/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"memory_store","arguments":{"content":"Projekt-Deadline ist der 15. April 2026"}}}'

Memory abrufen

curl -X POST https://engine.mmcp.dev/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"memory_retrieve","arguments":{"query":"Wann ist die Projekt-Deadline?"}}}'

TypeScript / Node.js

const response = await fetch('https://engine.mmcp.dev/mcp', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer ${API_KEY}`
  },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'tools/call',
    params: {
      name: 'memory_store',
      arguments: { content: 'Wichtige Information hier' }
    }
  })
});

const { result } = await response.json();

Authentifizierung

OAuth 2.1 (empfohlen fuer MCP-Clients)

Claude Desktop, Claude Code und claude.ai unterstuetzen OAuth 2.1. Beim ersten Verbinden wirst du automatisch zum Login auf mmcp.dev weitergeleitet, waehlst deinen Vault und autorisierst den Zugriff. Danach laeuft alles automatisch inkl. Token-Refresh.

API-Key (fuer HTTP API und Server-zu-Server)

Fuer direkte HTTP-Requests brauchst du einen API-Key im Authorization: Bearer Header. API-Keys erstellst du im Vault-Dashboard. Ein Vault kann mehrere Keys haben.

Super-Keys: Fuer Supervaults gibt es Super-Keys die Zugriff auf mehrere Vaults gleichzeitig geben. Format identisch zu normalen Keys (mk_...). Die Engine erkennt automatisch ob es ein Single-Vault oder Gruppen-Key ist. Mehr dazu: Vault-Sharing und Gruppen