Skip to content
API Reference

Connect Claude or Codex

Version: unreleased · Docs: 3c6ab9f2Download Markdown

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.

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:

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.

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

  1. Open 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:

Terminal window
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.

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:

Terminal window
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.

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.

For scripts and servers, an AI app can send a Redbelt API key instead of signing in. Create one in API Key Management and keep it in the app’s secret storage:

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.

  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 and the list of Tools for AI Apps.