Skip to main content
For developers who add StackOne to their own Claude Code. Your team already added it? Follow Organization User Setup instead.

Recommended Set up with your agent

Paste 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 and guide me one step at a time.

Or follow the steps yourself

Connect

1

Add StackOne

In your terminal, outside a Claude Code session, run:
--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:
Using Claude Code in the Claude desktop app? Connect StackOne in Claude instead, with Organization User Setup or Personal Setup. 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
  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
3

Check it works

Back in Claude Code, you see Authentication successful. To check it works, send:
The first time Claude uses StackOne, Claude Code asks for permission. Choose Yes.
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. 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 instead.
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.
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: To share the server with a team through a repository, see Organization Admin Setup.

Management commands