MCP server

Connect your client

Paste the URL, sign in to your account and authorize. There is nothing to install and no key to copy. The Pro plan is required.

Server URL

It is the same in every client.

MCP server URL

https://noctralspy.com/api/mcp

Choose your client

On the first connection, your browser opens so you can sign in to Noctral and authorize the app.

Open Settings, then Connectors.
Add a custom connector and paste the URL.
Click Connect, sign in to Noctral and authorize.

This applies to Claude on the web and on desktop.

Terminal

claude mcp add --transport http noctral https://noctralspy.com/api/mcp
# then run /mcp inside Claude Code and choose Authenticate

.cursor/mcp.json

{
  "mcpServers": {
    "noctral": {
      "url": "https://noctralspy.com/api/mcp"
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "noctral": {
      "type": "http",
      "url": "https://noctralspy.com/api/mcp"
    }
  }
}

Terminal

codex mcp add noctral --url https://noctralspy.com/api/mcp
codex mcp login noctral

settings.json

{
  "mcpServers": {
    "noctral": {
      "httpUrl": "https://noctralspy.com/api/mcp"
    }
  }
}

mcp_config.json

{
  "mcpServers": {
    "noctral": {
      "serverUrl": "https://noctralspy.com/api/mcp"
    }
  }
}

Connect with a key

For automations with no browser, or clients without OAuth, create a key in API & MCP inside the app and send it in the Authorization header.

Terminal

claude mcp add --transport http noctral https://noctralspy.com/api/mcp \
  --header "Authorization: Bearer nk_YOUR_KEY"

.cursor/mcp.json

{
  "mcpServers": {
    "noctral": {
      "url": "https://noctralspy.com/api/mcp",
      "headers": {
        "Authorization": "Bearer nk_YOUR_KEY"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "noctral": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://noctralspy.com/api/mcp",
        "--header",
        "Authorization:${NOCTRAL_AUTH}"
      ],
      "env": {
        "NOCTRAL_AUTH": "Bearer nk_YOUR_KEY"
      }
    }
  }
}

In Claude Desktop, the NOCTRAL_AUTH variable keeps the space in the header from splitting the arguments.

Troubleshooting

Authentication failed

Remove the server and add it again. Check that the account you signed in to has the Pro plan.

You see PRO_REQUIRED

The authorized account has no active Pro plan. Subscribe and try again.

You see a quota error

The account quota ran out. The message says which limit was reached.

You want to disconnect an app

Go to API & MCP, Connect tab, and click Disconnect.