Skip to main content

​
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 to your MCP client. It injects your token and org from ~/.nuon:
Claude Code:
For a direct HTTP connection instead, see Connect.
2

Verify context

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

First tool calls

In the LLM client, call:
  1. whoami — confirm account and org
  2. list_installs — list installs in that org
You do not need select_org when using the stdio proxy (org is already in X-Nuon-Org-ID).
4

Writes (optional)

Restart the proxy with --allow-writes only when you need to mutate (approve steps, run actions, preview branches, and so on):
Your token must also have create permission.
Tool catalog and prompt → tool examples: Agents.