# Connect Claude or Codex

Redbelt is one MCP server per deployment. Add it once and your AI app can use
the Redbelt tools you allow: Knowledge, threads, tasks, databases and your
connected apps. The AI app acts as you, with your current permissions.

## Find your address

Open **Settings → MCP**. Under **Connect an app**, copy the server URL, or
the terminal command for your AI app. Both already contain your deployment's
address, which looks like:

```text
https://YOUR_REDBELT_ORIGIN/mcp
```

The page also gives the server its name: `redbelt` on redbelt.ai, and
`redbelt-` plus your deployment's name elsewhere, such as `redbelt-acme`. Use
that name in the steps below, so each Redbelt you use keeps its own entry.

Before you connect, turn on the plugins you want in **Settings → Plugins** and
connect any apps they need. An AI app only sees tools that already work for you.
If your organization limits AI apps, an AI app only sees the plugins it allows,
and if an admin turned AI apps off, signing in is refused with a message that
says so. See [Organization limits](/mcp/access/#organization-limits).

## Claude

Add Redbelt as a connector to use it in the Claude apps, Cowork and Claude Code:

1. Open [Connectors](https://claude.ai/customize/connectors) in Claude and
   choose **Add custom connector**.
2. Name it Redbelt, paste the server URL, and add it.
3. Select **Connect** and sign in to Redbelt.

On Team and Enterprise plans, an owner adds the connector once for the
organization, and everyone else selects **Connect**. Claude Code uses the
connector when you sign in to it with your Claude account.

To add Redbelt to Claude Code alone from a terminal, run:

```bash
claude mcp add --transport http --scope user redbelt https://YOUR_REDBELT_ORIGIN/mcp && claude mcp login redbelt
```

It adds Redbelt for every folder and opens your browser to sign in. Use the
connector or the command, not both: Claude Code prefers the command's server and
hides the connector. See the [Claude Code MCP guide](https://code.claude.com/docs/en/mcp).

## Codex

In the Codex app, open **Settings → MCP servers** and choose **Add server**.
Name it redbelt, choose **Streamable HTTP**, paste the server URL and save, then
select **Authenticate** and sign in to Redbelt.

Or run this in a terminal:

```bash
codex mcp add redbelt --url https://YOUR_REDBELT_ORIGIN/mcp
```

Codex opens Redbelt in your browser to sign in. To sign in again later, run
`codex mcp login redbelt`. The Codex app, CLI and IDE extension share this
setup. See the [Codex MCP guide](https://learn.chatgpt.com/docs/extend/mcp?surface=cli).

## Sign in and choose tools

Signing in opens Redbelt in your browser. Check the AI app's name, the
organization it will act in and the address it returns to, then choose its tools:

* **Off:** the AI app sees none of this plugin's tools.
* **Read:** tools that only look things up.
* **Read & act:** every tool, including ones that create, change, send or run
  something. Your approval settings still apply.

**All plugins** sets the starting point, and covers plugins you add later. Choose a
different level for any single plugin. New AI apps start with **Read**.

The AI app connects to the organization that is active in your browser. To use
another organization, switch to it in Redbelt first, then sign in again.

You can change an AI app's tools or disconnect it at any time; see
[Manage Connected AI Apps](/mcp/access/).

## Connect without a browser

For scripts and servers, an AI app can send a Redbelt API key instead of signing
in. Create one in [API Key Management](/api/keys/) and keep it in the app's
secret storage:

```text
Authorization: Bearer YOUR_API_KEY
```

A key sees every tool you can use, so prefer signing in for interactive AI apps.
Calls that need your approval are not run with a key; they return **blocked**.

## Check the connection

1. Ask the AI app to list its Redbelt tools.
2. Ask for a small read, such as a Knowledge search, and check the answer. Each
   result links to its file in Redbelt.
3. Try an action only once you know where it will go.

Next: [Approvals and Results](/mcp/results/) and the list of
[Tools for AI Apps](/mcp/availability/).
