Claude Code Setup

Add Memcone memory to Claude Code in under 60 seconds.

Automatic setup (recommended)

Run this in your project directory:

npx @memcone/cli link

npx @memcone/cli link

link detects Claude Code, merges project-scoped MCP into .mcp.json at the project root, and scopes memory to your project automatically. Restart Claude Code and you're done.

You need a Memcone API key from dashboard → API keys. The CLI will prompt for it on first run and save it to ~/.memcone/credentials.

Manual config

If you prefer to configure manually, create .mcp.json in your project root (Claude Code’s team-shared file):

{
  "mcpServers": {
    "memcone": {
      "type": "http",
      "url": "https://memcone.com/api/mcp",
      "headers": {
        "Authorization": "Bearer mem_live_YOUR_KEY_HERE"
      }
    }
  }
}

{
  "mcpServers": {
    "memcone": {
      "type": "http",
      "url": "https://memcone.com/api/mcp",
      "headers": {
        "Authorization": "Bearer mem_live_YOUR_KEY_HERE"
      }
    }
  }
}

Or use Claude Code's built-in CLI:

claude mcp add memcone \
  --url https://memcone.com/api/mcp \
  --header "Authorization: Bearer mem_live_YOUR_KEY_HERE"

claude mcp add memcone \
  --url https://memcone.com/api/mcp \
  --header "Authorization: Bearer mem_live_YOUR_KEY_HERE"

Verify with:

claude mcp list
claude mcp get memcone

claude mcp list
claude mcp get memcone

Using it

Claude Code will call memcone.context automatically at the start of every session. You can also prompt directly:

"Remember that this project uses Drizzle ORM with Neon Postgres"

"What do you know about how this codebase is structured?"

Available tools:

• memcone.context
• memcone.remember
• memcone.recall

Troubleshooting

claude mcp list doesn't show memcone → Re-run claude mcp add or check that the JSON config has "type": "http".

401 Unauthorized → Verify your key at dashboard → API keys. It must start with mem_live_.

Tools registered but never called → Type /mcp to see active servers. Prompt directly: "Use memcone.context to load my project memory".

"Protocol error" → Make sure "type" is "http" — not "sse" or "stdio".

No memory returned → Nothing is stored yet. Ask Claude: "Remember that this project uses Next.js and Drizzle". Confirm at dashboard → Memory.