MCP walkthrough

Connect an LLM client to Nuon and run your first queries.

Prerequisites

• Nuon CLI installed and authenticated (nuon auth login, nuon orgs select)
• An LLM client that supports MCP (Cursor, Claude Code, etc.)

Steps

1. Register the MCP server

   Add the stdio proxy. Token and org stay in ~/.nuon.

   Claude Code

   claude mcp add --transport stdio nuon -- nuon agents mcp --allow-writes
   

   Cursor has no mcp add. Save the JSON as ~/.cursor/mcp.json or project .cursor/mcp.json, then agent mcp enable nuon.

   Examples include --allow-writes so mutating tools are available. Your token must have create permission.

   The proxy derives its URL from the configured API hostname (api.<hostname> becomes mcp.<hostname>/mcp). Override it with --url (and --name for the client’s MCP list) on the registered command. Full examples: Connect and Override the server.

2. Verify context

   nuon agents context
   

   Confirm you are authenticated and an org is selected. If not, run nuon auth login and nuon orgs select.

3. Ask a first question

   In the LLM client, paste:

   Who am I, and what installs are in this org?
   

   The client should call whoami and list_installs. You do not need select_org when using the stdio proxy (org is already in X-Nuon-Org-ID).

   More prompts: Sample queries.

Tool catalog: Tools. Prompts to paste: Sample queries.