> ## Documentation Index
> Fetch the complete documentation index at: https://getalchemystai.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Desktop

> Configure Claude Desktop MCP with Alchemyst AI

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](https://getalchemyst.com).
* **Claude Desktop** (latest version)

### Run with Docker

1. Click on the **☰ Hamburger Menu** in the top-left corner of **Claude 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 a file called **`claude_desktop_config.json`**.
6. Open the file and add the following configurations:

```json theme={null}
"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"
      ]
    }
  }
```

7. Save the file and restart your **Claude Desktop**.
8. After restart, navigate back to **Developer** Tab in **File → Settings...**.
9. You will be able to see your added MCP Server.
10. 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

1. Click on the **☰ Hamburger Menu** in the top-left corner of **Claude 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 a file called **`claude_desktop_config.json`**.
6. Open the file and add the following configurations:

```json theme={null}
"mcpServers": {
  "alchemyst_context_processor_mcp": {
    "command": "npx",
    "args": [
      "-y",
      "supergateway",
      "--sse",
      "https://mcp.getalchemystai.com/mcp/sse",
      "--oauth2Bearer",
      "YOUR_ALCHEMYST_PLATFORM_API_KEY"
    ]
  }
}
```

7. Save the file and restart your **Claude Desktop**.
8. After restart, navigate back to **Developer** Tab in **File → Settings...**.
9. You will be able to see your added MCP Server.
10. 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**.<br />Ensure the Docker service is active with:<br />`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:<br />`net start com.docker.service`.                                                  |
| **"Connecting to SSE…" but nothing happens**       | Incorrect SSE URL or invalid Alchemyst API key.           | Verify the URL:<br />`https://mcp.getalchemystai.com/mcp/sse`<br />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:<br />`--oauth2Bearer YOUR_API_KEY`.                  |
| **Claude or MCP not showing as connected**         | MCP configuration not detected or extension not reloaded. | 1. Restart **VS Code**.<br />2. Open Command Palette → "MCP: List Active MCP Servers".<br />3. Confirm `supergateway` is listed and running. |