> ## 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.

# Claude Code - Connect StackOne

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

For developers who add StackOne to their own Claude Code. Your team already added it? Follow [Organization User Setup](https://docs.stackone.com/ai-platforms/anthropic/claude-code/organization-user-setup.md) instead.

Recommended Set up with your agentPaste this into Claude Code. It walks you through each step and can run the commands for you.

Help me connect StackOne to Claude Code. I'm adding StackOne to Claude Code myself. Read the setup guide at [https://docs.stackone.com/ai-platforms/setup-guide.md](https://docs.stackone.com/ai-platforms/setup-guide.md) and guide me one step at a time.
Copy

Or follow the steps yourself

## Connect

**1. Add StackOne**

In your terminal, outside a Claude Code session, run:

```bash theme={null}
claude mcp add --transport http --scope user stackone https://mcp.stackone.com/mcp
```

`--scope user` makes StackOne available in all your projects. In VS Code, you can add it from the `/mcp` dialog in the Claude Code chat panel instead, with this MCP server URL:

```text theme={null}
https://mcp.stackone.com/mcp
```

Using Claude Code in the Claude desktop app? Connect StackOne in Claude instead, with [Organization User Setup](https://docs.stackone.com/ai-platforms/anthropic/claude-chat-cowork/organization-user-setup.md) or [Personal Setup](https://docs.stackone.com/ai-platforms/anthropic/claude-chat-cowork/personal-setup.md). The app's Code tab uses the same connectors.

**2. Sign in and authorize**

In Claude Code, run `/mcp`. Select the StackOne server (usually **stackone**), press Enter, and choose **Authenticate**. In VS Code, type `/mcp` in the Claude Code chat panel.

![Claude Code's /mcp panel on the StackOne server, which needs authentication, with Authenticate selected](https://mintcdn.com/stackone-60/RgaE_4ZxFuvAQ6gS/images/ai-platforms/anthropic/claude-code-mcp-authenticate.png?fit=max\&auto=format\&n=RgaE_4ZxFuvAQ6gS\&q=85\&s=9e20e26e9891b0b14ea44dd52a8aab2d)

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 Claude Code 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)

**3. Check it works**

Back in Claude Code, you see **Authentication successful**. To check it works, send:

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

The first time Claude uses StackOne, Claude Code asks for permission. Choose **Yes**.

> [accordion] If something goes wrong
>
> **Can't add StackOne.** If Claude Code says the server is blocked or not allowed by enterprise policy, your company controls which servers Claude Code can use. Ask the person who manages Claude Code to allow StackOne. If VS Code's terminal can't find `claude`, install the Claude Code CLI. The extension doesn't add that command.
>
> **The browser didn't open.** Copy the link Claude Code shows into your browser. If the browser shows an error after you click **Authorize**, copy the full address from the browser's address bar and paste it into Claude Code.
>
> **A system you need is missing.** Ask your StackOne admin, or see [Linking Accounts](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md). If it's linked but you didn't pick it when you signed in, run `/mcp`, choose **Re-authenticate** on StackOne and pick it.
>
> **It stopped working.** Run `/mcp`, select StackOne and sign in again with **Re-authenticate** or **Authenticate**. Access lasts 90 days from when you clicked **Authorize**.
>
> **It can't do something.** It can do only what your own StackOne access allows. Ask your StackOne admin.
>
> **You need it in CI or with `claude -p`.** Those runs can't open the sign-in. Use a [token app](https://docs.stackone.com/ai-platforms/mcp-server.md#client-setup-token-apps) instead.

> [accordion] Add or change accounts
>
> Claude Code 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 Claude Code 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**.

## Scope options

Control where the configuration is stored:

| Scope | Flag | Storage location | Use case |
| - | - | - | - |
| Local | (default) | `~/.claude.json`, under the current project's path | Project-specific |
| Project | `--scope project` | `.mcp.json` at project root | Team collaboration (version controlled) |
| User | `--scope user` | `~/.claude.json` | Personal tools across all projects |

To share the server with a team through a repository, see [Organization Admin Setup](https://docs.stackone.com/ai-platforms/anthropic/organization-admin-setup.md).

## Management commands

```bash theme={null}
claude mcp list              # View all configured servers
claude mcp get stackone      # Show details for a specific server
claude mcp remove stackone   # Remove a server
```


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