# 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-code.md) |
| Claude.ai | [Add a custom connector](claude.md) |
| Codex CLI or IDE extension | [Connect Codex](codex.md) |
| Another app with remote MCP support | [Connect using an API key](other-clients.md) |

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](../agent-setup.md#connect-this-app) 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](../getting-started.md#try-your-first-task).

To manage an existing connection, see [Agents and connections](../agents.md).