Claude Desktop Integration

Give Claude Desktop persistent, encrypted memory in under 5 minutes. Every memory passes through PII sanitization, intent validation, and AES-256-GCM encryption before storage.

Overview

Claude Desktop supports the Model Context Protocol (MCP), which lets you connect external tools as first-class capabilities. By registering Synapse Layer as an MCP server, Claude gains two primary tools — store_memory and recall_memory — plus 11 additional specialized tools for memory management, health checks, and context initialization.

All memory operations go through the Cognitive Security Pipeline: PII detection and redaction, intent classification, experimental embedding noise (no formal DP guarantee), and AES-256-GCM encryption at rest.

Prerequisites

  • Claude Desktop installed (macOS or Windows)
  • Node.js 18+ (npx ships with it)
  • A Connect Token (sk_connect_*) from Dashboard → Connect

Configuration

Add Synapse Layer to your claude_desktop_config.json:

json
{
  "mcpServers": {
    "synapse-layer": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://forge.synapselayer.org/api/mcp",
        "--header",
        "x-connect-token: sk_connect_YOUR_TOKEN"
      ]
    }
  }
}

Note

The mcp-remote bridge proxies Claude Desktop to the hosted endpoint and carries your Connect Token in the auth header. There is no local server to install. Alternatively, install from the Smithery listing: smithery.ai/server/synapselayer/synapselayer.

Usage

Once configured, Claude Desktop automatically discovers the Synapse Layer tools. You can ask Claude to use memory naturally:

You:"Remember that I prefer TypeScript and my project uses Next.js 14."
Claude:I've stored that preference. The memory was processed through the security pipeline — PII sanitization applied, intent classified as "preference" with 0.92 confidence, and encrypted with AES-256-GCM.
You:"What do you know about my project setup?"
Claude:Based on my memory, you prefer TypeScript and your project uses Next.js 14. (Trust Quotient: 0.95)

Available Tools

When connected, Claude Desktop has access to all 13 Synapse Layer MCP tools. The most commonly used in interactive sessions:

ToolDescription
store_memoryStore text through the full security pipeline
recall_memorySemantic search across stored memories
list_memoriesBrowse all memories for this agent
health_checkVerify pipeline status and version
initialize_contextBootstrap agent context from existing memories

See the MCP Tools Reference for the complete list of all 13 tools with parameter schemas.

Troubleshooting

Tools not appearing in Claude Desktop

Verify the config path is correct and restart Claude Desktop. On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Connection errors

Run the bridge manually to see the raw error: npx mcp-remote https://forge.synapselayer.org/api/mcp --header "x-connect-token: YOUR_TOKEN"

Memories not persisting between sessions

Memories are bound to the Connect Token's agent scope. Reusing the same token keeps one memory namespace; a different token is a different agent.