Configuration

MCP setup for Claude Code, Claude Desktop, Cursor, and other clients.

Claude Code

Add Synthesis using the CLI:

claude mcp add synthesis --transport http --url https://api.synthis.tools/mcp --header "Authorization: Bearer YOUR_API_KEY"

Or manually edit ~/.claude/settings.json:

{
  "mcpServers": {
    "synthesis": {
      "type": "url",
      "url": "https://api.synthis.tools/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Desktop

Edit the config file at:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "synthesis": {
      "type": "url",
      "url": "https://api.synthis.tools/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Cursor

Edit .cursor/mcp.json in your project root or global config:

{
  "mcpServers": {
    "synthesis": {
      "type": "url",
      "url": "https://api.synthis.tools/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Other MCP Clients

Synthesis works with any MCP-compatible client that supports HTTP transport:

• URL: https://api.synthis.tools/mcp
• Transport: HTTP (Streamable HTTP)
• Auth Header: Authorization: Bearer YOUR_API_KEY

Verifying Installation

After configuring, restart your client and ask:

User: "What MCP tools do you have available?"

You should see synthesis_start, synthesis_checkpoint, synthesis_lesson, and synthesis_search in the response.

Managing API Keys

From your dashboard, you can:

• Generate new API keys with custom names
• View all your active keys
• Revoke keys that are no longer needed

Use different keys for different machines or clients to track usage and revoke access individually.