Connect your AI app

Create an agent on the Agents page in your Rukou workspace, then copy its MCP address. Use a separate agent for each app or instance that you want to manage independently.

Your app	Connection guide
Claude Code	Connect from the terminal
Claude.ai	Add a custom connector
Codex CLI or IDE extension	Connect Codex
Another app with remote MCP support	Connect using an API key

Sign-in lets you authorize the app in Rukou without copying an API key. A client that cannot complete sign-in can use a key made for the agent, if it supports authentication headers.

To have the agent add the connection itself, paste the setup prompt into your app.

An MCP address identifies the agent; it does not grant access by itself. Complete sign-in or configure a valid key before asking the agent to use Rukou.

Confirm the connection

In your AI app, ask:

Call Rukou's rukou_status and tell me which organization, workspace, and agent this connection uses. Do not start a browser yet.

Check the names against the Agents page. A successful status call confirms the connection; it does not start a browser. Next, follow your first task.

To manage an existing connection, see Agents and connections.