---
title: "Install in Codex"
description: "Add the Spinrun gateway to Codex for run and Build surfaces."
url: https://docs.spinrun.ai/install/codex
markdown_url: https://docs.spinrun.ai/install/codex.md
---

# Install in Codex

{/* GENERATED from @spinrun/clients stepsFor() — do not edit by hand. */}

## Run surface [#run-surface]

### 1. Send this to your agent [#1-send-this-to-your-agent]

It registers the gateway and opens a browser to authorize — no key to copy.

```text
Add the Spinrun MCP server at https://spinrun.ai/mcp and complete the browser authorization it prompts for, then list the tools you can now reach.
```

### 2. Or register it yourself [#2-or-register-it-yourself]

Run this in the same terminal as Codex.

```bash
codex mcp add spinrun --url https://spinrun.ai/mcp
```

### 3. Authorize in your browser [#3-authorize-in-your-browser]

Codex opens a window the first time it reaches the gateway. Sign in and choose which workspace it may reach — you can revoke it any time from Settings → Applications.

## Build surface [#build-surface]

### 1. Send this to your agent [#1-send-this-to-your-agent-1]

This is the Build surface — it authors agents and workflows rather than running tools, and it accepts browser authorization only. It registers the endpoint and opens a browser to authorize — no key to copy.

```text
Add the Spinrun Build MCP server at https://spinrun.ai/mcp/build and complete the browser authorization it prompts for, then list the agents and workflows you can now author.
```

### 2. Or register it yourself [#2-or-register-it-yourself-1]

Run this in the same terminal as Codex.

```bash
codex mcp add spinrun-build --url https://spinrun.ai/mcp/build
```

### 3. Authorize in your browser [#3-authorize-in-your-browser-1]

Codex opens a window the first time it reaches the Build endpoint. Sign in and choose which workspace it may author in. Tick "Build authorization" on the consent screen, or enable it later under Settings → Applications (workspace owners only). You can revoke it any time from Settings → Applications.

## Related [#related]

* [Install](https://docs.spinrun.ai/install.md)
* [Build vs run](https://docs.spinrun.ai/getting-started/build-vs-run.md)