Setup - Neuradex

Connection Methods

There are three ways to connect to the Neuradex MCP server. Choose based on your client.

Method	Authentication	Target Clients
OAuth	Dashboard login	Claude.ai, ChatGPT, and other OAuth-compatible clients
Streamable HTTP	Access key (Bearer token)	Claude Desktop, Cursor, Cline, etc.
STDIO	Access key (environment variable)	Claude Desktop, Cline, etc. (local execution)

OAuth (Recommended)
Streamable HTTP
STDIO

For OAuth-compatible MCP clients, simply specify the MCP server URL. Authentication is completed by logging into the dashboard. No access key required.

Compatible Clients

Claude.ai
ChatGPT
Other OAuth (PKCE) compatible MCP clients

Setup Steps

Add MCP Server

In your client’s MCP settings, enter the following URL:

https://mcp.neuradex.ai

Authenticate via Dashboard

When connecting, your browser will open to the Neuradex dashboard login page. Log in and approve the authorization to automatically return to your client.

Done

If Neuradex tools appear in the tools list, the connection is complete.

OAuth authentication uses PKCE (S256). Tokens are automatically refreshed, so you don’t need to worry about expiration.

Connect by configuring the MCP server URL and access key. Issue an access key from the Dashboard.

Claude Desktop

You can add the server via the settings UI or configuration file.

Settings UI
Configuration File

Go to Claude Desktop Settings → MCP → Add Server.

Field	Value
Name	`Neuradex`
Transport	Streamable HTTP
URL	`https://mcp.neuradex.ai`
Bearer Token Environment Variable	`MCP_BEARER_TOKEN`

Set the MCP_BEARER_TOKEN environment variable to your access key starting with ndx_.

To edit the configuration file directly:

macOS
Windows

open ~/Library/Application\ Support/Claude/claude_desktop_config.json

notepad %APPDATA%\Claude\claude_desktop_config.json

Add the following:

claude_desktop_config.json

{
  "mcpServers": {
    "neuradex": {
      "url": "https://mcp.neuradex.ai",
      "headers": {
        "Authorization": "Bearer ndx_your_access_key_here"
      }
    }
  }
}

Restart Claude Desktop. If “neuradex” appears in the tools icon, setup is complete.

Cursor

Go to Cursor Settings → MCP → Add new MCP server.

Field	Value
Type	Streamable HTTP
URL	`https://mcp.neuradex.ai`
Headers	`Authorization: Bearer ndx_your_access_key_here`

VS Code (Cline)

Add to the Cline extension’s MCP settings.

settings.json

{
  "cline.mcpServers": {
    "neuradex": {
      "url": "https://mcp.neuradex.ai",
      "headers": {
        "Authorization": "Bearer ndx_your_access_key_here"
      }
    }
  }
}

Access keys starting with ndx_ can be obtained from the settings page in the Dashboard. See Authentication for details.

Launch the MCP server locally and connect via standard I/O (stdio). Issue an access key from the Dashboard.

Installation

npm
pnpm

npm install -g @neuradex/mcp

pnpm add -g @neuradex/mcp

Claude Desktop

claude_desktop_config.json

{
  "mcpServers": {
    "neuradex": {
      "command": "npx",
      "args": ["@neuradex/mcp"],
      "env": {
        "NEURADEX_ACCESS_KEY": "ndx_your_access_key_here",
        "NEURADEX_API": "https://api.neuradex.ai"
      }
    }
  }
}

If globally installed, change to "command": "neuradex-mcp" and set "args" to an empty array.

VS Code (Cline)

settings.json

{
  "cline.mcpServers": {
    "neuradex": {
      "command": "npx",
      "args": ["@neuradex/mcp"],
      "env": {
        "NEURADEX_ACCESS_KEY": "ndx_your_access_key_here"
      }
    }
  }
}

Environment Variables

Variable	Description	Default
`NEURADEX_ACCESS_KEY`	API access key	(required)
`NEURADEX_API`	API endpoint	`https://api.neuradex.ai`

Self-Hosting (HTTP Mode)

To run as an HTTP server on a local network or private cloud:

neuradex-mcp --mode http --port 9000

Variable	Description	Default
`MCP_MODE`	Transport mode (`stdio` / `http`)	`stdio`
`PORT`	HTTP server port	`9000`
`NEURADEX_MCP_URL`	Public URL of MCP server (HTTP mode)	`http://localhost:{PORT}`

CLI Options

neuradex-mcp [options]

Options:
  -k, --access-key <key>  Neuradex API access key
  -a, --api-url <url>     API endpoint URL
  -m, --mode <mode>       Transport mode (stdio/http)
  -p, --port <port>       HTTP server port (http mode only)
  -h, --help              Show help

Troubleshooting

MCP Server Not Recognized

Solution

Completely quit and restart Claude Desktop
Verify JSON syntax in configuration file
For remote connection, visit https://mcp.neuradex.ai/health to check server status

Authentication Error

Solution

Verify access key starts with ndx_ prefix (see Authentication)
Check key expiration and permissions in the Dashboard
When using OAuth, clear browser cache and try re-authenticating

Timeout Errors

Solution

Check network connection
Check firewall settings
For local connection, verify NEURADEX_API value is correct

Session Disconnects

Solution

Streamable HTTP mode sessions expire automatically after 30 minutes of inactivity. Reconnecting creates a new session.The active project set with switch_project is shared across sessions using the same credentials.

Next Step

Available Tools

Details of tools provided by the MCP server

MCP

​Connection Methods

​Compatible Clients

​Setup Steps

​Claude Desktop

​Cursor

​VS Code (Cline)

​Installation

​Claude Desktop

​VS Code (Cline)

​Environment Variables

​Self-Hosting (HTTP Mode)

​CLI Options

​Troubleshooting

​MCP Server Not Recognized

​Authentication Error

​Timeout Errors

​Session Disconnects

​Next Step

Available Tools

Connection Methods

Compatible Clients

Setup Steps

Claude Desktop

Cursor

VS Code (Cline)

Installation

Claude Desktop

VS Code (Cline)

Environment Variables

Self-Hosting (HTTP Mode)

CLI Options

Troubleshooting

MCP Server Not Recognized

Authentication Error

Timeout Errors

Session Disconnects

Next Step