Connect to Nolt's MCP Server

Table of contents

• Overview
• Claude (claude.ai / Claude Desktop)
• Claude Code
• ChatGPT
• Codex
• Visual Studio Code
• Cursor
• Troubleshooting

Overview

Nolt exposes a remote MCP server that lets AI assistants read and act on Nolt boards (posts, comments, statuses, votes, etc.) on a user's behalf.

• MCP URL (same for every client): https://nolt.io/mcp
• Auth: OAuth 2.0. The user signs in with their normal Nolt account and approves the connecting app.

Dynamic client registration is disabled — only pre-approved apps can obtain a token. Because of this, every client below needs both values entered explicitly during setup: the MCP URL and its own Client ID.

Claude (claude.ai / Claude Desktop)

1. Go to Settings → Connectors.
2. Click Add custom connector.
3. Enter the MCP URL: https://nolt.io/mcp.
4. Open Advanced settings and enter the Client ID: nolt-claude-web.
5. Save, then click Connect and complete the OAuth sign-in with your Nolt account.

Claude Code

Add the server, then supply the Client ID when prompted / via config — the exact flag or config field may vary by version, so check claude mcp add --help if the URL-only form below doesn't ask for it:

claude mcp add --client-id nolt-claude-code --transport http nolt https://nolt.io/mcp

Client ID: nolt-claude-code

Then start Claude Code and run /mcp to complete the OAuth sign-in with your Nolt account.

ChatGPT

1. Go to Settings → Connectors.
2. Click Create (or Add custom connector, depending on your workspace).
3. Enter the MCP URL: https://nolt.io/mcp.
4. Enter the Client ID: nolt-chatgpt.
5. Save, then authorize with your Nolt account when prompted.

Codex

Run the following command:

codex mcp add nolt-sd-staging \
  --url https://nolt-sd-staging.nolt.in/mcp \
  --oauth-client-id nolt-codex 

codex mcp login nolt-sd-staging

And authorize with your Nolt account when prompted.

Visual Studio Code

Add an entry to your user mcp.json (Command Palette → MCP: Open User Configuration) or to a workspace .vscode/mcp.json:

{
  "servers": {
    "nolt": {
      "type": "http",
      "url": "https://nolt.io/mcp",
      "auth": {
        "clientId": "nolt-vs-code"
      }
    }
  }
}

VS Code will prompt you to sign in with your Nolt account the first time an agent uses the server.

Cursor

Add an entry to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project-level):

{
  "mcpServers": {
    "nolt": {
      "url": "https://nolt.io/mcp",
      "auth": {
        "CLIENT_ID": "nolt-cursor"
      }
    }
  }
}

Reload MCP servers in Cursor's settings and authorize with your Nolt account when prompted.

Troubleshooting

• "unauthorized_client" / registration errors: each app must use its exact Client ID from the table above — a missing or mistyped Client ID looks like a generic auth failure in most of these apps. If you're using a client that isn't listed here, contact us and we'll get it added.