An astronaut overseeing a futuristic data hub
Download PDFMarkdown Version

Connect CircleCI to ChatGPT, Claude and Gemini

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Manage your software delivery pipelines through natural conversation.

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

A futuristic MCP client docking bay
V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 8 capabilities

We ship only the actions that matter.

Capability set01 / 02

01-04

4 capabilities in this set.

Part of 8 available through CircleCI.

  1. 01

    List cci contexts

    This capability lists the shared contexts available for your organization. Use it to see which environment data is available for your projects.

  2. 02

    List workflow jobs

    This capability retrieves all jobs within a specific workflow. It helps your agent see the individual steps inside a larger process.

  3. 03

    Trigger cci pipeline

    This capability starts a new pipeline for a specific project. You can use it to kick off builds on specific branches via chat.

  4. 04

    Get my cci profile

    This capability fetches the profile information for your authenticated user. It provides context about your identity within the CircleCI workspace.

Capability set02 / 02

05-08

4 capabilities in this set.

Part of 8 available through CircleCI.

  1. 05

    Get workflow details

    This capability pulls detailed information about a specific workflow. It is useful for getting a deep dive into a single execution run.

  2. 06

    List cci pipelines

    This capability shows a list of recent CI/CD pipelines. Use it to get a quick overview of recent activity across your projects.

  3. 07

    Get job details

    This capability retrieves specific metadata and execution status for a single job. It is the fastest way to debug a failed build step.

  4. 08

    List pipeline workflows

    This capability lists all workflows contained within a specific pipeline. It helps your agent map out the structure of a pipeline run.

Real work

What teams actually run

01

Rapid Debugging

When a build fails, ask your agent to get the job details to find the error immediately.

02

Manual Deployments

Trigger a new pipeline for a specific branch after a code review is complete.

03

Pipeline Auditing

Check the status of recent pipelines to ensure all deployments are proceeding as planned.

04

Environment Verification

List shared contexts to confirm that the correct environment variables are available.

Automate a task

Put CircleCI to work on one thing.

Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.

One connector, every AI

CircleCI works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

ClaudeClaudeChatGPTChatGPTGeminiGeminiPerplexityPerplexityGrokGrokMicrosoft CopilotMicrosoft CopilotCursorCursorVS CodeVS CodeWindsurfWindsurfJetBrainsJetBrainsClineClineLangChainLangChainVercel AI SDKVercel AI SDKLovableLovableZ.aiZ.aiRaycastRaycastQwen CodeQwen CodeKimi CodeKimi CodeLe ChatLe Chat

Building your own app? The connector is yours to use.

You don't need a client to put CircleCI to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Observed, not estimated

912ms average. Fast in production.

CircleCI is checked daily against the live service.

Daily averagePeak 1171ms
Oct 3Today
Fastest day
692ms
Slowest day
1171ms
14-day trend
Stable-2%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 8 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of CircleCI, so you can see the experience inside your AI.

It does not authenticate your account with CircleCI. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

CircleCI Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_RYNFniMxh53CKeYToBM2UNUbXRz4n2cftwtxDiON/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — CircleCI capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "circleci-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_RYNFniMxh53CKeYToBM2UNUbXRz4n2cftwtxDiON/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

Guided setup for Claude? Set up CircleCI in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work CircleCI owners hand off.

This MCP is built for engineering teams who want to manage deployments without leaving their development environment.

  • 01

    DevOps Engineers

    They use the agent to monitor pipeline health and trigger builds using natural language.

  • 02

    Software Developers

    They use it to audit job failures and check workflow progress directly in their IDE.

  • 03

    Release Managers

    They use the agent to verify release status and handle manual gates.

FAQ

Questions CircleCI owners ask.

  • 01

    How do I connect this MCP to my AI client?

    You subscribe to the MCP on Vinkius and then connect your client, such as Claude or Cursor, using the provided connection details. Vinkius handles the hosting and management for you.

  • 02

    What credentials do I need to provide?

    You will need to enter your CircleCI Personal API Token, which you can generate in your CircleCI User Settings.

  • 03

    Can I trigger builds through my agent?

    Yes, you can use the trigger capability to start new pipeline runs for specific projects and branches through your chat interface.

  • 04

    Which AI clients are compatible?

    This MCP works with any MCP-compatible client, including Claude, Cursor, and Windsurf.

  • 05

    Is my CircleCI data secure?

    Vinkius manages your credentials and hosts the MCP, ensuring your connection to CircleCI remains secure and managed.

  • 06

    Can I trigger a build for a specific branch through the agent?

    Yes! Use the trigger_cci_pipeline capability. You need to provide the project slug (e.g., gh/org/repo) and the branch name. The agent will instruct CircleCI to start the pipeline immediately.

  • 07

    How do I see why a specific job failed?

    Use the get_job_details capability with the project slug and job number. Your agent will fetch the execution status and metadata, which often points to the cause of failure.

  • 08

    Where do I find my CircleCI API Token?

    Log in to CircleCI, go to User Settings -> Personal API Tokens. You can generate and copy a new token from there.

Explore

More in Ship It

Suggestions

Connect CircleCI to Claude, Cursor, ChatGPT & more