Skip to content

Rukou documentation · Current

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.

Check it ​

Ask Claude to call rukou_status and confirm the workspace and agent. Then try the first browsing 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 when you want to revoke one app's access.

Download MarkdownReport a docs issue