> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex - Connect StackOne

> Use the StackOne MCP server to connect your work systems to Codex.

Codex connects to remote MCP servers over streamable HTTP natively and runs the OAuth flow itself, so no wrapper package is needed.

## Before you start

* A StackOne [project](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md) you are a member of.
* A [connector profile](https://docs.stackone.com/connect/managing-connectors/connector-profiles.md) in the project for each provider the client should reach, with the actions you want exposed enabled.
* (Optional) A [linked account](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md) for each provider. Accounts can also be linked during the consent flow.

## Connect StackOne

**1. Add the server to Codex**

```bash theme={null}
codex mcp add stackone --url https://mcp.stackone.com/mcp
```

Or add it to `~/.codex/config.toml` by hand:

```toml theme={null}
[mcp_servers.stackone]
url = "https://mcp.stackone.com/mcp"
```

**2. Sign in and authorize**

Run:

```bash theme={null}
codex mcp login stackone
```

1. Sign in to StackOne. In a desktop app or code editor, this opens in your browser.
2. If StackOne asks for a project, pick yours and click **Continue to Accounts**.
3. Pick the work systems Codex can use (your Linked Accounts).
4. If you see **Load tools when needed**, leave it on.
5. Click **Authorize**.

![StackOne's Select accounts screen with two Linked Accounts ticked, Load tools when needed on, and the Authorize button](https://mintcdn.com/stackone-60/RgaE_4ZxFuvAQ6gS/images/ai-platforms/oauth-consent-select-accounts.png?fit=max\&auto=format\&n=RgaE_4ZxFuvAQ6gS\&q=85\&s=66ef4eb4d8bf6e5246e5f01ec959c187)

Codex stores the tokens, so later runs start without a prompt.

**3. Check it works**

Run `codex` and ask:

```text theme={null}
Which of my Linked Accounts can you reach through StackOne?
```

> [accordion] Add or change accounts
>
> Codex reaches only the Linked Accounts you approved when you connected. To add one you link later, or one someone shares with you afterwards:
>
> **1. Open Connected Apps**
>
> In the StackOne dashboard, go to [**Connected Apps**](https://app.stackone.com/connected_apps).
>
> **2. Edit the connection**
>
> 1. Open the **⋮** menu on the row for Codex and select **Edit tool access**.
> 2. Select the Linked Account.
> 3. Click **Save changes**.
>
> To review or revoke the connection, use the same **⋮** menu in **Connected Apps**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.