> ## Documentation Index
> Fetch the complete documentation index at: https://docs.versuno.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code

> Connect Versuno MCP to Anthropic's Claude Code CLI.

Claude Code has a built-in `mcp add` command that handles the config for you.

## Install

```bash theme={null}
claude mcp add versuno -e VERSUNO_API_KEY=uk_live_xxx -- npx -y versuno-mcp
```

The `--` separates Claude Code flags from the command it will spawn. Everything after `--` is what Claude Code runs.

## Remote (hosted HTTP)

To use Versuno's hosted server instead of `npx`, add it as an HTTP transport with your key as a bearer token:

```bash theme={null}
claude mcp add --transport http versuno https://mcp.versuno.ai/mcp --header "Authorization: Bearer uk_live_xxx"
```

The hosted server provides the read/query tools only — `pull_asset` and `push_asset` need local disk access, so use the `npx` install above if you need them.

## Verify

```bash theme={null}
claude mcp list
```

You should see `versuno` in the list with a green status indicator.

## Scope

By default the server is added to the current project. To make it available globally, add `--scope user`:

```bash theme={null}
claude mcp add versuno --scope user -e VERSUNO_API_KEY=uk_live_xxx -- npx -y versuno-mcp
```

## Remove

```bash theme={null}
claude mcp remove versuno
```

## Using it

Start a chat session with `claude` and mention Versuno:

> *"Pull the 'onboarding context' asset from Versuno."*

Claude Code asks for approval on each tool call. Keep this setting on. See [Security](/mcp/security).

## Troubleshooting

Run `claude mcp logs versuno` to see stderr output from the server. The most common issues are a missing or invalid API key. See [Troubleshooting](/mcp/setup#troubleshooting).