# Claude Code Setup

Official source: https://docs.anthropic.com/en/docs/claude-code/mcp

Claude Code can add remote MCP servers from the command line and complete OAuth through the app's MCP UI.

Claude Code is different from Claude Desktop. Use this page only for Claude Code.

## Recommended Setup

Run the guided installer:

```bash
npx -y @gradien/core-agent-setup install --base-url https://core.gradien.ai --yes --harness claude-code
```

The installer creates a short-lived Core signup/login session, registers Core for Claude Code, and prints any agent-specific next steps.

Core MCP server URL:

```text
https://core.gradien.ai/mcp
```

## Authentication

Claude Code may not show a newly added MCP server inside `/mcp` until the app restarts.

Use this order:

1. Finish the installer.
2. Fully quit and reopen Claude Code, or start a fresh Claude Code session.
3. Run `/mcp`.
4. Select Core.
5. Choose Authenticate or Connect if prompted.
6. Approve Core in the browser.

If Core is missing from `/mcp` before a restart, treat that as a stale Claude Code session rather than a failed install.

## Verify

After authentication, Core should appear as a connected MCP server and expose Core tools in a fresh Claude Code session. If tools are still missing, restart Claude Code once more before reinstalling.