MCP

The nunu MCP server is a remote MCP with dynamic client registration and OAuth.

Each project has its own MCP endpoint:


https://nunu.ai/mcp/{projectId}

You can get the projectId from the nexus url https://nunu.ai/nexus/{projectId}

How Auth and Permissions Work

You authenticate through OAuth when connecting from your MCP client.
The MCP session uses your Nexus user identity.
The MCP can do everything you are allowed to do in that project, and nothing beyond your project permissions.

Verified vs Unverified Apps

We maintain a list of verified OAuth apps (Claude, Cursor, Codex, etc.) that we have reviewed and tested.

If an app is not on our verified list, you will see an “Unverified OAuth App” warning. Only authorize unverified apps if you are the developer or you trust the developer. Unverified apps could potentially be used for phishing attacks to gain access to your Nexus account.

Claude (Custom Connector)

Open Connector Settings

In Claude, go to Settings → Connectors.

Add Connector

Click Add custom connector.

Enter Details

Use any connector name, then paste your project MCP URL (for example, https://nunu.ai/mcp/my-project).

Claude Add Custom Connector dialog

Connect

Click on Connect and complete the OAuth flow in the browser window.

OAuth consent screen

After OAuth, the connector is ready to use with your project-scoped Nexus MCP tools.

Claude Code

Claude Code automatically syncs MCPs from your Claude desktop app. If you prefer to add the MCP only to Claude Code, run:


claude mcp add --transport http my-mcp-name https://nunu.ai/mcp/my-project

Then start the CLI, enter the /mcp command, select the newly added MCP, and choose 1. Authenticate.

Codex CLI

Run:


codex mcp add my-mcp-name --url https://nunu.ai/mcp/my-project
codex mcp login my-mcp-name

MCP JSON Clients (Generic)

For clients (cursor, windsurf, zed…) that use MCP JSON config, add a remote server entry with your project URL.


{
  "mcpServers": {
    "nunu-my-project": {
      "url": "https://nunu.ai/mcp/my-project"
    }
  }
}

Then click Connect (or equivalent) in your client and complete OAuth.

Field names may vary by client, but the only required value is your project MCP URL.

API Key Authentication

For bots and CI pipelines, use an API key instead of OAuth.


{
  "mcpServers": {
    "nunu-my-project": {
      "url": "https://nunu.ai/mcp/my-project",
      "headers": {
        "x-api-key": "your-nunu-project-api-key-here"
      }
    }
  }
}

API keys are for automation and building apps. If you’re just using Nexus in your favorite LLM for daily work, use OAuth. It tracks who did what.

Manage Connected Apps in Nexus

You can review and revoke OAuth access at any time:

Open Account Settings

In Nexus, click your profile icon (top-right) and open account settings.

Open Connected Apps

Go to the Connected Apps tab.

Revoke Access

Find the app and click Revoke to remove its OAuth access.

Connected Apps in Nexus

Revoking access immediately disconnects that app until it completes OAuth again.