Skip to content

From October 1, WhatsApp charges for every business reply. Read the migration playbook

AI agents

Connect SuperCognit to Gemini CLI

Gemini CLI loads MCP servers from settings.json and supports remote servers over streamable HTTP. Add your SuperCognit workspace and Gemini can list and edit agents, build knowledge bases, attach tools and read conversations — from the terminal, with a workspace API key or OAuth.

Connection details

Replace <workspace> with the workspace slug shown under Integrations → Platform MCP, and <api-key> with a workspace API key when your client does not sign in with OAuth. Published MCP servers connect the same way at their own URL.

// ~/.gemini/settings.json
{
  "mcpServers": {
    "supercognit": {
      "httpUrl": "https://mcp.supercognit.com/platform/<workspace>/mcp",
      "headers": { "x-api-key": "<api-key>" }
    }
  }
}

What you can do once it's connected

  • Scripted workspace changesUpdate instructions across several agents, rotate a knowledge source or attach a new tool — described once, applied by Gemini over MCP.
  • Knowledge from local filesGemini CLI reads your docs on disk and pushes them into a SuperCognit knowledge base as sources.
  • Daily usage checkAsk for this week's conversations, credit usage and top questions and have Gemini write the summary to a file.
  • Tools for Google-hosted APIsRegister your Cloud Run or Apps Script endpoints as SuperCognit tools so your customer agent can call them.

Gemini CLI

How to connect

Add your SuperCognit workspace to Gemini CLI via settings.json. Create agents, manage knowledge bases and tools from Google's terminal agent.

  1. Copy your workspace MCP URL

    Integrations → Platform MCP in the dashboard. One URL per workspace.

  2. Add the server to settings.json

    In ~/.gemini/settings.json (or the project's .gemini/settings.json) add a supercognit entry under mcpServers with httpUrl set to the workspace URL.

  3. Authenticate

    Simplest: a workspace API key in the headers object as x-api-key. Gemini CLI can also run the OAuth sign-in for remote servers if you enable it on the entry.

  4. Check with /mcp

    Run /mcp inside Gemini CLI to see the server and its tools, then ask it to list your agents.

Frequently asked questions

Still wondering? Ask our agent; it answers from these same pages.

More AI agents

Connect from the other AI agents you use.

Human ambition. SuperCognit intelligence.

Your workspace, one MCP URL away

Create a workspace, copy the MCP URL from Integrations → Platform MCP, paste it into your agent — free for 7 days.