Skip to main content

Claude Code Remote MCP Connection Issues

When connecting Claude Code to the Atlan Remote MCP server, you may encounter issues related to missing Node.js dependencies or expired OAuth tokens. This page covers the most common issues and how to fix them.

npx not recognized on Windows during Claude Code MCP setup​

Error

The term 'npx' is not recognized as the name of a cmdlet, function, script file, or operable program.

Cause​

MCP OAuth setup requires mcp-remote, which depends on Node.js and npm. If Node.js isn't installed, or was installed after the current terminal session started, npx isn't in the PATH.

Solution​

  1. Download and install Node.js LTS for Windows.
  2. Restart your terminal to reload the PATH.
  3. Verify npm is available: npm --version.
  4. Re-run the Claude Code MCP setup command.

Atlan MCP stops working after OAuth token expires​

Error

MCP connection failed. The server is not responding — your OAuth token may have expired.

Cause​

OAuth tokens have a limited lifetime. Once expired, the MCP server rejects requests and returns no results.

Solution​

  1. Remove the existing server:

    claude mcp remove atlan-oauth

  2. Re-add the server:

    claude mcp add --transport http atlan-oauth https://mcp.atlan.com/mcp

  3. Complete the OAuth flow again in your browser.

See also​

Need help​

If you need assistance after trying these steps, contact Atlan Support.