Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use CircleCI with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Manage CI/CD pipelines and workflows via CircleCI. track jobs, trigger pipelines, and monitor build status directly from any AI agent.

Included with plan

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

Complete set · 8 capabilities

The complete CircleCI capability set.

These are the exact actions your AI can choose when you ask it to work with CircleCI.

Capability set01 / 02

01-04

4 capabilities in this set.

Part of 8 available through CircleCI.

  1. 01

    List cci contexts

    List shared contexts for an organization

  2. 02

    List workflow jobs

    List all jobs within a specific workflow

  3. 03

    Trigger cci pipeline

    Trigger a new pipeline for a project

  4. 04

    Get my cci profile

    Retrieve information about the authenticated user

Capability set02 / 02

05-08

4 capabilities in this set.

Part of 8 available through CircleCI.

  1. 05

    Get workflow details

    Get detailed information for a specific workflow

  2. 06

    List cci pipelines

    List recent CI/CD pipelines

  3. 07

    Get job details

    Get detailed information for a specific job

  4. 08

    List pipeline workflows

    List all workflows within a specific pipeline

Observed, not estimated

880ms average. Fast in production.

CircleCI is checked daily against the live service.

Daily averagePeak 1079ms
Aug 20Today
Fastest day
683ms
Slowest day
1079ms
14-day trend
Slowing+17%

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

FAQ

Questions CircleCI owners ask.

  • 01

    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.

  • 02

    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.

  • 03

    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