https://mcp.noonum.ai/mcp. This page covers the Claude Code CLI, Claude Desktop and claude.ai, Cursor, and generic MCP clients, with both authentication methods:
- API key (static
Authorizationheader), for automation and server-side use. - OAuth, for interactive apps that sign you in to your Noonum account through a browser.
Before you start
You need one of the following, depending on the method you choose:
- For the API-key flow: a Noonum API key. See Authentication to request one.
- For the OAuth flow: a Noonum user account you can sign in to. The client handles the OAuth handshake, so no key is required.
Option A: Claude Code CLI
If you use Claude Code, a single command registers the server:/mcp. To use OAuth instead, omit --header. Then run /mcp in Claude Code, pick noonum, and sign in with your Noonum account.
Option B: Claude Desktop and claude.ai
Claude Desktop and claude.ai add remote MCP servers as custom connectors.claude_desktop_config.json is for local servers only, so do not add Noonum there.
1
Add a custom connector
Open Customize → Connectors and choose Add custom connector. Enter
Noonum as the name and https://mcp.noonum.ai/mcp as the server URL.On a Team or Enterprise plan, an owner adds the connector for the organization under Organization settings → Connectors. Each member then connects to it from Customize → Connectors.2
Choose how to authenticate
- OAuth
- API key
Keep the default authentication settings and click Add. Then click Connect next to Noonum. Your browser opens the Noonum sign-in page. After you approve, Claude keeps you signed in and renews access on its own.
Option C: Cursor
Cursor connects to MCP servers over HTTP. Add Noonum through Settings → MCP → Add new MCP server, or by editing Cursor’s MCP config (~/.cursor/mcp.json, or .cursor/mcp.json for a single project). The config looks like this:
- API key
- OAuth
Option D: A generic MCP client
Any MCP client that supports the MCP Streamable HTTP transport can connect to Noonum. Configuration field names vary by client; the values stay the same.1
Point the client at the MCP URL
Set the server URL to:Select the HTTP transport (MCP Streamable HTTP). No SSE or custom-protocol options are required.
2
Configure authentication
- API key
- OAuth
Add a static request header:If your client uses a JSON config, the shape generally mirrors Cursor’s:
3
Reload and connect
Reload the client so it picks up the new server. With OAuth, expect a browser prompt on first connect; with an API key, the connection is established immediately.
Named examples
The steps above cover any HTTP-transport client. Two specifics:- Codex CLI: register Noonum as an MCP server in your Codex config, pointed at
https://mcp.noonum.ai/mcpover HTTP, with theAuthorization: Bearerheader for the API-key flow. - ChatGPT and other connectors: point the connector at
https://mcp.noonum.ai/mcp, select the HTTP transport, and set theAuthorization: Bearerheader, or leave it unset to use OAuth.
Verify it works
Once the client has reloaded:- Check the server is connected. In Claude Desktop or claude.ai, open Customize → Connectors and confirm Noonum shows as connected. In Claude Code, run
/mcp. In other clients, check the MCP server or tools panel. - Confirm the tools loaded. You should see the Noonum tools available, for example
list_strategies,search_companies, andget_usage. The tool list means the client handshook with the server. - Make a real call. Ask the client to run a low-risk, read-only tool. Good first calls:
- “List my Noonum strategies” → runs
list_strategies. - “Show Noonum’s public strategies” → runs
list_strategieswithscopeset topublic. - “How many Noonum credits do I have left?” → runs
get_usage.
- “List my Noonum strategies” → runs
Troubleshooting
401 Unauthorized (API key)
An API-key authentication failure returns a standard401 Unauthorized. Check that:
- The header is exactly
Authorization: Bearer YOUR_API_KEY, with a single space afterBearerand no extra quotes or whitespace around the key. - You pasted the full key and it has not been revoked. If in doubt, request a fresh key from hello@noonum.com.
- The URL is
https://mcp.noonum.ai/mcp(note themcp.host and the/mcppath, with no version).
OAuth re-authentication
OAuth failures do not surface as a401 you handle yourself. Instead, the client restarts the authorization flow and opens the browser so you can sign in again. An expired access token alone does not cause this, because the client renews it with its refresh token. You sign in again only when your sign-in has expired or been revoked, or when the client has lost its saved tokens. If the browser prompt does not appear or the loop repeats:
- Complete the browser sign-in fully, including any consent screen.
- Make sure your client is configured without an
Authorizationheader. A stray header forces the API-key path. - Remove any issuer, audience, or client ID you set by hand. The client discovers what it needs from the MCP server, and the MCP server rejects a token you get from Auth0 directly.
409: email already belongs to another account
If you connected with OAuth,submit_strategy and get_usage can fail with 409 and the message “This email already belongs to another Noonum account”. This usually means you signed in with a different method than the one you first signed up with. Disconnect the server, connect again, and sign in the way you first signed up. If that does not work, contact hello@noonum.com.
Tools do not appear
- Re-check the JSON is valid (no trailing commas, balanced braces) and fully restart the client.
- Verify the
urland transport are HTTP and point athttps://mcp.noonum.ai/mcp.
A run seems stuck
submit_strategy does not wait for the run to finish. It returns right away with the version and its run state. A live run usually takes a few minutes. A historical run with priority below 5 can take hours. Poll get_strategy_version until completed is true. A status of -1 is a temporary error that is retried automatically. A status of -2 means the run failed, and a failed run is not charged. See Runs.
Still stuck
If the problem persists, or the server returns a5xx or other server-side error, contact hello@noonum.com.
Next steps
- Build a strategy: define an objective and run a strategy end to end.
- Browse the full MCP tool catalog and see how runs work.
- Review the Authentication page for API keys and the shared REST auth model.