Skip to main content

Claude Code

Claude Code uses UnifiedMemory through the remote MCP endpoint. It should get a Claude-scoped key with own-agent scope and only the capabilities needed for MCP tools.

Registry contract​

This section is generated from integrations/agent_integrations.registry.json. Edit the registry or generator, not this block.

FieldValue
Integration IDclaude-code
LabelClaude Code
Tierremote_mcp_client
Setup modehttp_mcp
Agent IDclaude-code
App IDclaude
Source app / actorsource_app=claude, agent_id=claude-code; key metadata wins over request body hints
Default scopeown
Config paths.mcp.json, ~/.claude.json, ~/.claude/settings.json
Capabilitiesmemory.read, memory.write, memory.recall, memory.delete, agent.context, agent.writeback, mesh.read, evidence.read, courtroom.read, canary.read
Supported toolsclaudeBootstrap, claudeCapture, claudeStatus, um_store, um_search, um_profile, um_courtroom

Capture policy​

MCP-first recall and explicit capture; hooks may capture Edit, Write, Bash, and Task outcomes while skipping passive Read/Glob/Grep noise.

Install command(s)​

claude mcp add --transport http --scope user --header "Authorization: Bearer {{KEY_REF}}" unified-memory {{MCP_URL}}

Verify command(s)​

claude mcp list
claude mcp get unified-memory

Environment​

{
"UNIFIED_MEMORY_API_KEY": "{{KEY_ENV_REF}}",
"UNIFIED_MEMORY_CONTAINER": "{{CONTAINER_TAG}}"
}

Risk notes​

  • Keep bearer keys in local user config or environment.
  • Use user scope for machine setup; project scope only in trusted repos.

Official upstream docs​

https://docs.anthropic.com/en/docs/claude-code/mcp

Scope and capabilities​

SettingValue
Source appclaude
Default containerjeethendra
Default scopeown
Main endpointhttps://edge-api.jithendranara.dev/mcp

Expected capabilities include recall/search, retain/writeback, agent context, Courtroom read, and canary/status checks.

Install​

Issue a Claude-scoped key from Connections, then run:

claude mcp add --transport http --scope user \
--header "Authorization: Bearer <scoped-key>" \
unified-memory https://edge-api.jithendranara.dev/mcp

The option order matters: transport, scope, and header come before the server name and URL.

Verify​

claude mcp list

Then ask Claude Code to list UnifiedMemory tools or run a memory recall canary. Verification should prove the selected key works; a browser-session preflight is not enough.

Writeback behavior​

Claude should save durable outcomes, project decisions, and verified tool results. It should not retain whole assistant answers, greetings, terminal noise, or injected memory blocks.

Risk notes​

  • If Claude supplies an agent_id in a tool body, UnifiedMemory should still use the key-bound Claude identity.
  • Cross-agent handoff should be explicit and limited to allowed memory refs.

Next steps​