Synap Memory — Claude Code MCP server: what it does, how to install
Maintains persistent agent memory by bridging MCP tool calls directly into the Synap REST API. It records conversation context and retrieves user facts across sessions.
claude mcp add --transport http synap-mcp-server https://synap-mcp.maximem.ai/mcpWhat Synap Memory does
This remote HTTP adapter relays MCP tool calls straight to the Synap REST backend without maintaining local storage. Incoming requests carry their own Bearer synap_<key> token, which the service passes through directly to the authentication layer.
The server exposes four operations: log_exchange for storing dialogue turns, recall_context for fast memory retrieval, list_recent_memories for inspections, and check_memory_status for write verification. Streaming events to the anticipation agent is disabled by default via MCP_STREAM_EVENTS=false to avoid extra model billing and duplicated extraction passes.
Context separation follows instance rules. A B2C deployment using equals_customer accepts solely user_id and rejects customer_id immediately. In strict B2B setups, providing both customer_id and user_id is mandatory. Omitting both falls back to a shared client scope that stays hidden from relational dashboard views.
What it helps with
- persist user dialogue turns to long-range memory
- retrieve prior conversation context for a specific user ID
- verify background ingestion status for an asynchronous write
- inspect recent memory entries during agent debugging
Example prompts for the agent
- Retrieve stored background information for user
usr_123using Synap - Log this conversation turn under
usr_123so the memory persists - Check the processing state of memory write
ing_456
How to install Synap Memory
Platform CLI: remote server
claude mcp add --transport http synap-mcp-server https://synap-mcp.maximem.ai/mcpPlatform CLI: remote server
codex mcp add synap-mcp-server --url https://synap-mcp.maximem.ai/mcpConfig file
{
"mcpServers": {
"synap-mcp-server": {
"url": "https://synap-mcp.maximem.ai/mcp"
}
}
}Config file
{
"servers": {
"synap-mcp-server": {
"type": "http",
"url": "https://synap-mcp.maximem.ai/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http synap-mcp-server https://synap-mcp.maximem.ai/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Synap Memory
How to install Synap Memory in Claude Code?
Run claude mcp add --transport http synap-mcp-server https://synap-mcp.maximem.ai/mcp in your terminal.
What does Synap Memory do?
It exposes tools to record dialogue exchanges and fetch historical user context from the Synap platform over remote HTTP.
How does scoping work between B2C and B2B modes?
B2C setups only accept user_id and reject customer_id with an error. B2B configurations enforce both customer_id and user_id, while passing neither scopes records to a shared client credential.
