NORNDOCS
⌕
MCP Server / Claude Code

Claude Code

Claude Code is Anthropic's terminal-based AI coding assistant. This guide walks through adding Norn's MCP server to it. If you haven't yet, read the MCP overview first.

Setup

  1. Install Claude Code if you haven't already. Follow the instructions at docs.claude.com/en/docs/claude-code.

  2. Add the Norn MCP server. Either method works — pick whichever you prefer.

    Option A — in-session

    code
    /mcp
    command (recommended). Start Claude Code in any project directory and type:

    code
    /mcp

    In the MCP management interface, choose "Add server" and enter:

    • Name:
      code
      norn
    • URL:
      code
      https://norn-data.com/mcp
    • Transport:
      code
      HTTP
      (streamable)

    Option B — CLI command. From your shell:

    bash
    claude mcp add --transport http norn https://norn-data.com/mcp

  3. Authenticate. Claude Code opens a browser window to Norn's login page the first time it needs the connection. Sign in with your Norn credentials and approve the requested scopes (

    code
    mcp:read
    ,
    code
    mcp:write
    ). The browser hands the session back to Claude Code automatically.

  4. Verify. Type

    code
    /mcp
    inside a session, or run
    code
    claude mcp list
    in the shell. Norn should appear as
    code
    connected
    .

  5. Try it out. In a Claude Code session, ask:

    "Using the norn MCP server, list the organizations I'm a member of."

Config file reference

To commit the server config to a repo (so teammates get it automatically), add this to

code
.mcp.json
at your project root (or
code
~/.claude.json
for a global config):

json
{
  "mcpServers": {
    "norn": {
      "type": "http",
      "url": "https://norn-data.com/mcp"
    }
  }
}

OAuth still runs through the browser on first use — the config file just tells Claude Code where the server lives.

TIP

Committing

code
.mcp.json
to a repo means every teammate who opens the project in Claude Code will be prompted to authenticate against Norn on first use — no manual configuration needed.

Next steps

← PREVIOUS
Claude Desktop
NEXT →
Available tools