Getting Started

Setup instructions for AI assistants using MCP

Connect your AI assistant to Reaudit using the MCP server. This guide covers setup for Claude Desktop, Cursor, VS Code, Windsurf, and other MCP clients.

Prerequisites: Node.js 18+ (required to run the MCP server), an active Reaudit subscription, and an MCP-compatible client. To check if Node.js is installed, run node --version in your terminal.

Authentication uses OAuth 2.0 with PKCE -- sign in with your Reaudit account through your browser.

Claude Desktop

Add the following to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "reaudit": {
      "command": "npx",
      "args": ["@reaudit/mcp-server"],
      "env": {
        "REAUDIT_BASE_URL": "https://reaudit.io"
      }
    }
  }
}

npx not found? If you get a "Failed to spawn process" error, replace "npx" with the full path from which npx in your terminal (e.g. /usr/local/bin/npx). See Troubleshooting below.

Restart Claude Desktop after saving the file.

Cursor

Open Cursor Settings → Tools & MCP → New MCP server
Add the configuration:

mcp.json

{
  "mcpServers": {
    "reaudit": {
      "command": "npx",
      "args": ["@reaudit/mcp-server"],
      "env": {
        "REAUDIT_BASE_URL": "https://reaudit.io"
      }
    }
  }
}

npx not found? If the server fails to connect, replace "npx" with the full path from which npx in your terminal. See Troubleshooting below.

Click Connect to authenticate

VS Code (Copilot)

Open Settings (Ctrl/Cmd + ,)
Search for "mcp" and click Edit in settings.json
Add:

settings.json

{
  "mcp": {
    "servers": {
      "reaudit": {
        "command": "npx",
        "args": ["@reaudit/mcp-server"],
        "env": {
          "REAUDIT_BASE_URL": "https://reaudit.io"
        }
      }
    }
  }
}

npx not found? Replace "npx" with the full path from which npx. See Troubleshooting.

Windsurf

Open Windsurf Settings → Cascade → MCP Servers
Click Add Server → Add custom server
Add:

MCP Server Config

{
  "mcpServers": {
    "reaudit": {
      "command": "npx",
      "args": ["@reaudit/mcp-server"],
      "env": {
        "REAUDIT_BASE_URL": "https://reaudit.io"
      }
    }
  }
}

npx not found? Replace "npx" with the full path from which npx. See Troubleshooting.

Claude Code

Run in your terminal:

claude mcp add reaudit -- npx @reaudit/mcp-server

Then authenticate:

Run /mcp in Claude Code
Select the Reaudit server
Choose Authenticate
Complete sign-in in your browser

Other Clients

Most MCP clients support stdio transport:

Command: npx
Arguments: ["@reaudit/mcp-server"]
Environment: REAUDIT_BASE_URL=https://reaudit.io

HTTP/SSE Transport

For web-based clients or remote connections, you can run the server with HTTP/SSE transport:

npx @reaudit/mcp-server --http --port=8090

This starts an HTTP server with SSE at http://localhost:8090/sse. For clients that support mcp-remote:

npx -y mcp-remote http://localhost:8090/sse

Authentication

The MCP server uses OAuth 2.0 with PKCE. On first use, it will:

Open your default browser to the Reaudit login page
Ask you to authorize the MCP server
Store tokens securely in ~/.reaudit/credentials.json (encrypted with AES-256-CBC)

Tokens auto-refresh. No API keys to manage.

Revoking access: Go to Reaudit Settings → Connected Apps → Revoke.

Troubleshooting

Authentication

Connection

Clear Cached Authentication

Remove the server and add it again:

# Claude Code
claude mcp remove reaudit
claude mcp add reaudit -- npx @reaudit/mcp-server

Other clients: Delete ~/.reaudit/credentials.json and restart.

Next Steps

Use Cases -- Reporting and optimization examples
Tools Reference -- All 40+ available tools
FAQ -- Common questions

Was this page helpful?

On this page

Getting Started

Setup instructions for AI assistants using MCP

Connect your AI assistant to Reaudit using the MCP server. This guide covers setup for Claude Desktop, Cursor, VS Code, Windsurf, and other MCP clients.

Prerequisites: Node.js 18+ (required to run the MCP server), an active Reaudit subscription, and an MCP-compatible client. To check if Node.js is installed, run node --version in your terminal.

Authentication uses OAuth 2.0 with PKCE -- sign in with your Reaudit account through your browser.

Claude Desktop

Add the following to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "reaudit": {
      "command": "npx",
      "args": ["@reaudit/mcp-server"],
      "env": {
        "REAUDIT_BASE_URL": "https://reaudit.io"
      }
    }
  }
}

npx not found? If you get a "Failed to spawn process" error, replace "npx" with the full path from which npx in your terminal (e.g. /usr/local/bin/npx). See Troubleshooting below.

Restart Claude Desktop after saving the file.

Cursor

Open Cursor Settings → Tools & MCP → New MCP server
Add the configuration:

mcp.json

{
  "mcpServers": {
    "reaudit": {
      "command": "npx",
      "args": ["@reaudit/mcp-server"],
      "env": {
        "REAUDIT_BASE_URL": "https://reaudit.io"
      }
    }
  }
}

npx not found? If the server fails to connect, replace "npx" with the full path from which npx in your terminal. See Troubleshooting below.

Click Connect to authenticate

VS Code (Copilot)

Open Settings (Ctrl/Cmd + ,)
Search for "mcp" and click Edit in settings.json
Add:

settings.json

{
  "mcp": {
    "servers": {
      "reaudit": {
        "command": "npx",
        "args": ["@reaudit/mcp-server"],
        "env": {
          "REAUDIT_BASE_URL": "https://reaudit.io"
        }
      }
    }
  }
}

npx not found? Replace "npx" with the full path from which npx. See Troubleshooting.

Windsurf

Open Windsurf Settings → Cascade → MCP Servers
Click Add Server → Add custom server
Add:

MCP Server Config

{
  "mcpServers": {
    "reaudit": {
      "command": "npx",
      "args": ["@reaudit/mcp-server"],
      "env": {
        "REAUDIT_BASE_URL": "https://reaudit.io"
      }
    }
  }
}

npx not found? Replace "npx" with the full path from which npx. See Troubleshooting.

Claude Code

Run in your terminal:

claude mcp add reaudit -- npx @reaudit/mcp-server

Then authenticate:

Run /mcp in Claude Code
Select the Reaudit server
Choose Authenticate
Complete sign-in in your browser

Other Clients

Most MCP clients support stdio transport:

Command: npx
Arguments: ["@reaudit/mcp-server"]
Environment: REAUDIT_BASE_URL=https://reaudit.io

HTTP/SSE Transport

For web-based clients or remote connections, you can run the server with HTTP/SSE transport:

npx @reaudit/mcp-server --http --port=8090

This starts an HTTP server with SSE at http://localhost:8090/sse. For clients that support mcp-remote:

npx -y mcp-remote http://localhost:8090/sse

Authentication

The MCP server uses OAuth 2.0 with PKCE. On first use, it will:

Open your default browser to the Reaudit login page
Ask you to authorize the MCP server
Store tokens securely in ~/.reaudit/credentials.json (encrypted with AES-256-CBC)

Tokens auto-refresh. No API keys to manage.

Revoking access: Go to Reaudit Settings → Connected Apps → Revoke.

Troubleshooting

Authentication

Connection

Clear Cached Authentication

Remove the server and add it again:

# Claude Code
claude mcp remove reaudit
claude mcp add reaudit -- npx @reaudit/mcp-server

Other clients: Delete ~/.reaudit/credentials.json and restart.

Next Steps

Use Cases -- Reporting and optimization examples
Tools Reference -- All 40+ available tools
FAQ -- Common questions

Was this page helpful?