Skip to main content
It covers two methods of connection:
  • Docker Based Setup
  • npx (Node.js) Setup

​
Prerequisites

Before you start, ensure you have the following:
  • Node.js (v18 or heigher)
  • Docker (if using the Docker Setup)
  • SuperGatway access (via Docker or npx)
  • Alchemyst API key - Obtain it from your Alchemyst AI dashboard.
  • Claude Desktop (latest version)

​
Run with Docker

  1. Click on the ☰ Hamburger Menu in the top-left corner of Cursor Desktop.
  2. Go to File → Settings….
  3. In the sidebar, go to Developer Tab.
  4. Click on Edit Config.
  5. It will take you to file called claude_desktop_config.json.
  6. Open teh file and add the following configurations:
"mcpServers": {
  "alchemyst_context_processor_mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "supercorp/supergateway",
        "--sse",
        "https://mcp.getalchemystai.com/mcp/sse",
        "--oauth2Bearer",
        "YOUR_ALCHEMYST_PLATFORM_API_KEY",
        "--keepALive"
      ]
    }
  }
  1. Save the file and Restart your Claude Desktop.
  2. After, restart navigate back to Developer Tab in File → Settings….
  3. You will able to see you added MCP Server.
  4. There should be a running (Blue colored) Tag in front of you MCP server name. It will ensure that srever is running fine.
If there is running tag then “Congratulations”, You Calude Desktop is integrated with Alchemyst AI via Docker Setup.

​
Common Error

If there is failed tag, then, click on Error logs button and this will open a folder Error Logs in which navigate and open file named alchemyst_context_processor_mcp. This contains the error stopping MCP server to run. Try to solve the error and Try again. Note that these instructions are valid for all desktop applications that use the STDIO MCP mode.

​
Run with npx

  1. Click on the ☰ Hamburger Menu in the top-left corner of Cursor Desktop.
  2. Go to File → Settings….
  3. In the sidebar, go to Developer Tab.
  4. Click on Edit Config.
  5. It will take you to file called claude_desktop_config.json.
  6. Open teh file and add the following configurations:
"mcpServers": {
  "alchemyst_context_processor_mcp": {
    "command": "npx",
    "args": [
      "-y",
      "supergateway",
      "--sse",
      "https://mcp.getalchemystai.com/mcp/sse",
      "--oauth2Bearer",
      "YOUR_ALCHEMYST_PLATFORM_API_KEY"
    ]
  }
}
  1. Save the file and Restart your Claude Desktop.
  2. After, restart navigate back to Developer Tab in File → Settings….
  3. You will able to see you added MCP Server.
  4. There should be a running (Blue colored) Tag in front of you MCP server name. It will ensure that srever is running fine.
If there is running tag then “Congratulations”, You Calude Desktop is integrated with Alchemyst AI via npx. Note that these instructions are valid for all desktop applications that use the STDIO MCP mode.

​
Troubleshooting

Issue / ErrorPossible CauseSolution / Fix
Container stops immediately after startDocker is not running or missing admin privileges.Run Docker Desktop as Administrator.
Ensure the Docker service is active with:
net start com.docker.service.
System error 5 has occurred. Access is denied.Command Prompt lacks administrator rights.Open Command Prompt as Administrator, then re-run:
net start com.docker.service.
“Connecting to SSE…” but nothing happensIncorrect SSE URL or invalid Alchemyst API key.Verify the URL:
https://mcp.getalchemystai.com/mcp/sse
and ensure your API key is valid and not expired.
401 Unauthorized or 403 ForbiddenInvalid or expired API key provided to Supergateway.Regenerate your API key from the Alchemyst Dashboard and replace it in the command:
--oauth2Bearer YOUR_API_KEY.
Claude or MCP not showing as connectedMCP configuration not detected or extension not reloaded.1. Restart VS Code.
2. Open Command Palette → “MCP: List Active MCP Servers”.
3. Confirm supergateway is listed and running.