Alchemyst AI - AI-Native Context Management Platform

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 higher)
Docker (if using the Docker Setup)
SuperGateway access (via Docker or npx)
Alchemyst API key - Obtain it from your Alchemyst AI dashboard.
Claude Desktop (latest version)

Run with Docker

Click on the ☰ Hamburger Menu in the top-left corner of Claude Desktop.
Go to File → Settings….
In the sidebar, go to Developer Tab.
Click on Edit Config.
It will take you to a file called claude_desktop_config.json.
Open the 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"
      ]
    }
  }

Save the file and restart your Claude Desktop.
After restart, navigate back to Developer Tab in File → Settings….
You will be able to see your added MCP Server.
There should be a running (blue colored) tag in front of your MCP server name. It will ensure that the server is running fine.

If there is a running tag then “Congratulations”, your Claude Desktop is integrated with Alchemyst AI via Docker Setup.

Common Error

If there is a failed tag, then click on the Error logs button and this will open a folder Error Logs in which navigate and open the file named alchemyst_context_processor_mcp. This contains the error stopping the MCP server from running. 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

Click on the ☰ Hamburger Menu in the top-left corner of Claude Desktop.
Go to File → Settings….
In the sidebar, go to Developer Tab.
Click on Edit Config.
It will take you to a file called claude_desktop_config.json.
Open the 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"
    ]
  }
}

Save the file and restart your Claude Desktop.
After restart, navigate back to Developer Tab in File → Settings….
You will be able to see your added MCP Server.
There should be a running (blue colored) tag in front of your MCP server name. It will ensure that the server is running fine.

If there is a running tag then “Congratulations”, your Claude 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 / Error	Possible Cause	Solution / Fix
Container stops immediately after start	Docker 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 happens	Incorrect 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 Forbidden`	Invalid 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 connected	MCP 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.

​Prerequisites

​Run with Docker

​Common Error

​Run with npx

​Troubleshooting

Prerequisites

Run with Docker

Common Error

Run with npx

Troubleshooting