Skip to main content
AI agent here means an LLM client (Claude Code, Cursor, etc.) driving the control plane. This is not the install runner in customer clouds.
Use an LLM client to read and operate orgs, apps, installs, and workflows, or to scaffold app config from example repos.

MCP walkthrough

Connect Claude Code, Cursor, or Amp and run your first calls.

Tools

Read and write tools exposed on the control plane.

Sample queries

Prompts to paste into your client after MCP is connected.

AI and app building

Generate Nuon app config with Claude Code, Gemini, Amp, and skills.

​
Prerequisites

nuon agents context prints your auth, selected org/app/install, and MCP HTTP URL.

​
Connect

Recommended: register the stdio proxy so the client runs nuon agents mcp. Token and org stay in ~/.nuon. nuon agents mcp setup writes that stdio config for Claude Code, Cursor, or Amp. The proxy derives its URL from the configured API hostname (api.<hostname> becomes mcp.<hostname>/mcp) and registers as nuon.

​
Setup (stdio)

--platform claude is an alias for claude-code. nuon mcp setup is the same command. Existing servers in the file are kept. Cursor Agent: agent mcp enable <name> after setup.

​
Override the server

The proxy derives its upstream URL from api_url in your CLI config when the hostname starts with api. (https://api.nuon.co → https://mcp.nuon.co/mcp). To point somewhere else, pass --url; to change the name in the client’s MCP list, pass --name.
--url, --name, and --allow-writes pass through setup, so the generated client config keeps them:
A non-default CLI config (-C /path/to/config) carries its own token, org, and api_url. setup copies the -C into the command it writes, so the client keeps using that config. Run nuon agents context to confirm which MCP URL resolves before registering.

​
Client CLIs

You can also register stdio yourself. Read-only by default. The name you pass (nuon) is what appears in the client’s MCP list.
Cursor / Cursor Agent has no mcp add. Save the JSON above as ~/.cursor/mcp.json or project .cursor/mcp.json, then agent mcp enable <name> — or run nuon agents mcp setup --platform cursor. Pass --allow-writes in stdio args when you need writes. Your token must have create permission. You do not need select_org when the org is already in the CLI config (the stdio proxy sends X-Nuon-Org-ID). These apply to nuon commands, not MCP tools: See CLI commands for the full reference.