# Connect Claude Code

On Rukou's **Agents** page, create an agent or select **Connect an app** on one you own.
Choose **Claude Code** to get commands with that agent's address and a distinct server name.

## Add the connection

Run the generated commands in your project directory. Their shape is:

```sh
claude mcp add --transport http rukou-research "AGENT_MCP_ADDRESS"
claude mcp login rukou-research
```

Replace `AGENT_MCP_ADDRESS` with the complete address copied from Rukou. The example server
name is `rukou-research`; keep the same name in both commands, or use the name generated by
the app. Sign in to Rukou in the browser and allow the intended agent connection.

Claude Code's default MCP scope is the current project. To use the connection across your
projects, add `--scope user` to the add command. The `/mcp` panel inside Claude Code can also
start sign-in. See [Claude Code's MCP instructions](https://code.claude.com/docs/en/mcp).

## Check it

Ask Claude to call `rukou_status` and confirm the workspace and agent. Then try the
[first browsing task](../getting-started.md#try-your-first-task).

If the server needs authentication, run the login command again. If it is missing from another
project, check the scope you used. For connection status, run:

```sh
claude mcp get rukou-research
```

If you have several Rukou agents in Claude Code, give their server entries different names.
Use [Remove on the Agents page](../agents.md#replace-or-remove-access) when you want to revoke
one app's access.