Gemini CLI

​

Overview

​

Prerequisites

• A StackOne project you are a member of.
• A connector profile in the project for each provider the client should reach, with the actions you want exposed enabled.
• (Optional) A linked account for each provider. Accounts can also be linked during the consent flow.

​

Setup

1

Add the server to Gemini

gemini mcp add --transport http stackone https://mcp.stackone.com/mcp

Or add it to ~/.gemini/settings.json under mcpServers by hand:

{
  "mcpServers": {
    "stackone": {
      "httpUrl": "https://mcp.stackone.com/mcp"
    }
  }
}

2

Approve the browser prompt

Run gemini. The CLI discovers that StackOne uses OAuth and opens your browser. If it does not, authenticate from inside the session:

/mcp auth stackone

Sign in, pick the project and the linked accounts the connector should reach, then Authorize.

Walk through the consent screen

1. Sign in to StackOne. If you are already signed in to the dashboard you skip straight to the next step.
2. Select a project. Select the project you would like to associate the connection with.
3. Select accounts and actions. Existing linked accounts are shown. New accounts can be linked by clicking + Link Account. You can either select the whole account (all actions will be granted) or refine by toggling individual actions.
4. (Optional) Load tools when needed. On by default, and the toggle that puts the connection into Advanced Tool Search. Leave it on for large action sets. Turn it off to hand the agent every selected action up front.
5. Authorize. Completes the connection; you can return to your client.

If you see a sentence where the Load tools when needed toggle should be, an admin has already settled it for the whole project. See project settings.

3

Verify

Run /mcp to list connected servers and their tools.

https://api.stackone.com/mcp?token={session_token}

https://api.stackone.com/mcp?token={session_token}&tool-mode=search_execute

{
  "mcpServers": {
    "stackone": {
      "httpUrl": "https://api.stackone.com/mcp?token={session_token}"
    }
  }
}

​

Optimize and secure