> ## 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 whose team already added StackOne to Claude Code. Adding it yourself? Follow [Personal Setup](https://docs.stackone.com/ai-platforms/anthropic/claude-code/personal-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. My team already set up StackOne in Claude Code. 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. Approve StackOne**

1. In your terminal, open your project and run `claude`.
2. If Claude Code says **New MCP server found in this project**, choose **Use this MCP server**.

![Claude Code asking to approve the stackone MCP server found in the project, with Use this MCP server selected](https://mintcdn.com/stackone-60/RgaE_4ZxFuvAQ6gS/images/ai-platforms/anthropic/claude-code-project-approval.png?fit=max\&auto=format\&n=RgaE_4ZxFuvAQ6gS\&q=85\&s=d3b399bf186230e17444ee43a6ae377c)

No prompt means your team added StackOne another way, and it's already in `/mcp`. It may be under **Managed MCPs**, or named **claude.ai StackOne** if your team added it in Claude. If you haven't signed in to it yet, select **Show unused connectors** to find it. If your team shares it as a plugin, install that plugin with `/plugin` first.

> [accordion] StackOne isn't there
>
> Ask the person who manages Claude Code at your company to add it. Send them this:
>
> ```text theme={null}
> Can you add StackOne to Claude Code for our team? The steps are at https://docs.stackone.com/ai-platforms/anthropic/organization-admin-setup
> ```
>
> To add it just for yourself instead, follow [Personal Setup](https://docs.stackone.com/ai-platforms/anthropic/claude-code/personal-setup.md).

**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.
>
> **StackOne from Claude isn't in `/mcp`.** Claude Code loads Claude connectors only when you are signed in with a Claude account. If you use an API key, Amazon Bedrock or Google Cloud, or a token from `claude setup-token`, they do not load. Run `/status` to see the method, remove the API key variable or provider setting, then run `/login` and choose your Claude account.
>
> **You skipped the approval.** Run `claude mcp reset-project-choices` in your project, then run `claude` again.
>
> **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**.


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