Skip to main content
Claude Desktop users: skip to Claude Desktop setup — Connectors + OAuth, no token required.Cursor and automation: follow the steps below to create a personal Bearer token.

1. Open MCP settings in Noux (Cursor / automation)

Sign in to noux.app and go to Integrations → MCP. You will see your organization’s MCP URL and controls to create personal read tokens. Production MCP URL:
https://mcp.noux.app/mcp

2. Create a personal read token (Cursor / automation)

  1. Click Create personal read token.
  2. Copy the token immediately — it is shown only once.
  3. Store it securely (password manager or your client’s secret storage).
Each token is personal. It acts as you in your organization, and only you can see or revoke tokens you created.
If you lose the token, revoke it and create a new one.

3. Note your MCP URL

Use https://mcp.noux.app/mcp in production, or the URL shown in Integrations → MCP if your environment differs.

4. Configure your MCP client

Choose the setup that matches your client:
ClientAuth methodGuide
Claude DesktopOAuth via Connectors (recommended)Claude Desktop
CursorPersonal Bearer tokenCursor
Other automationPersonal Bearer tokenURL + Authorization: Bearer <token> header
Claude Desktop — use Customize → Connectors → Add custom connector with URL https://mcp.noux.app/mcp, then Connect and sign in to Noux. No manual token required. Cursor and scripts — use your MCP URL from step 3 and header Authorization: Bearer <token-from-step-2>.

5. Verify the connection

Ask your client to call the get_info tool, or invoke it from a client that lists tools. A successful response includes:
  • organizationId — your Noux organization
  • userId — your user id (the token acts as you)
  • mcpVersion — current MCP API version
  • capabilities — includes read_only

Troubleshooting

IssueWhat to check
401 UnauthorizedToken copied correctly; Bearer prefix in the header
Connection refusedMCP URL matches the app exactly, including /mcp
Empty or wrong dataToken is yours — data is scoped to your organization as your user
Tool not foundClient supports Streamable HTTP MCP; restart the client after config changes

Revoking access

In Integrations → MCP, revoke any token you no longer need. Revocation is immediate.

Next steps

Browse the tool reference for available tools and pagination patterns.