# Claude Code

## Add the remote server

Run this command from your project directory.

```bash
claude mcp add --transport http i2v https://i2v.ai/api/mcp
```

The default configuration is scoped to the current project for your user. For a user-wide entry, add `--scope user`. In Claude Code, open `/mcp`, select `i2v`, and complete authentication in the browser. Check status with `claude mcp list` or `claude mcp get i2v`.

## Verify and enable writes

Use `get_account` to check granted scopes and `list_models` to confirm the catalog. To explicitly request generation and upload access, merge this configuration into the active `i2v` server entry.

```json
{
  "type": "http",
  "url": "https://i2v.ai/api/mcp",
  "oauth": { "scopes": "mcp:read mcp:write" }
}
```

Authenticate again from `/mcp` and approve write access on i2v.ai. If a project entry does not take effect, run `claude mcp get i2v` and check which configuration scope owns the active entry. See [Claude Code MCP instructions](https://code.claude.com/docs/en/mcp) for scope precedence and client version requirements.

## Disconnect

Revoke the OAuth grant in [Connections](/settings/connections), then remove or disable the local entry in Claude Code. Run `claude mcp remove i2v` with the original `--scope` if you used a non-default scope. [API key setup](/docs/mcp/api-key) is available for token-based connections.