Connect Claude to SynContext¶

Connect Claude to your SynContext account. Three methods available depending on which Claude client you use.

Prerequisites¶

A SynContext account with an API key (create one)

Method 1: Claude.ai (Web)¶

For the Claude web interface at claude.ai.

Steps¶

Open claude.ai
Go to a Project (or create one)
Open Project Settings → Integrations (or MCP Servers)
Click Add MCP Server
Enter the URL: https://syncontext.dev/mcp?key=YOUR_API_KEY
Save and start a new conversation in that project

Verify¶

Ask Claude: List all my projects in SynContext

Claude should call the hub_list_projects tool and show your projects.

Method 2: Claude Desktop¶

For the Claude Desktop app (macOS/Windows).

Prerequisites¶

Claude Desktop installed
Node.js installed (for npx — download here)

Steps¶

Open Claude Desktop
Go to Settings → Developer → Edit Config (or find claude_desktop_config.json)
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Add the SynContext server:

{
  "mcpServers": {
    "syncontext": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://syncontext.dev/mcp",
        "--header",
        "X-API-Key: YOUR_API_KEY"
      ]
    }
  }
}

Replace YOUR_API_KEY with your actual API key
Save the file and restart Claude Desktop

Verify¶

After restarting, you should see a hammer icon (tools) in the chat input area. Click it to see the 10 SynContext tools listed.

Ask Claude: Search my SynContext for anything

Troubleshooting¶

"npx not found" — Install Node.js from nodejs.org and restart your terminal
Tools don't appear — Check the JSON syntax carefully (missing commas, wrong brackets). Restart Claude Desktop after any config change.
"Connection refused" — Verify the URL uses https:// not http://

Method 3: Claude Code (CLI)¶

For the Claude Code command-line tool.

Steps¶

Run this command in your terminal:

claude mcp add syncontext --transport http https://syncontext.dev/mcp --header "X-API-Key: YOUR_API_KEY"

Replace YOUR_API_KEY with your actual API key.

Verify¶

Start a Claude Code session and ask:

List my SynContext projects

Troubleshooting¶

"transport error" — Verify the URL and API key are correct
Tools not available — Run claude mcp list to verify syncontext is registered
Remove and re-add — claude mcp remove syncontext then add again

Available tools¶

Once connected, Claude has access to 10 MCP tools:

Tool	Description
`search`	Full-text search across all context entries
`fetch`	Get a context entry by ID (full content)
`hub_list_projects`	List all your projects
`hub_get_project`	Get project details with recent entries
`hub_store_context`	Store a new context entry
`hub_update_context`	Update an existing entry (saves version)
`hub_update_status`	Update project status
`hub_log_decision`	Record a decision with rationale
`hub_get_decisions`	Get decision history
`hub_export_project`	Export a complete project as JSON

See the full API Reference for parameters and examples.

Cross-AI sync¶

If you also have ChatGPT connected (guide):

Store context from Claude: Store in SynContext project "shared": Title: "Test", Content: "Hello from Claude"
Open ChatGPT and ask: Search my SynContext for "Hello from Claude"
ChatGPT finds the entry Claude stored — sync confirmed

For more issues, see the full Troubleshooting Guide.