--- title: Getting started with Windsurf and CircleCI | daily.dev description: A step-by-step guide to integrating Windsurf (an AI-native IDE with the Cascade agentic assistant) with CircleCI via the Model Context Protocol (MCP). Covers... canonical: https://daily.dev/posts/getting-started-with-windsurf-and-circleci-15a4qq8o6 twitter:card: summary_large_image twitter:site: @dailydotdev og:type: website og:site_name: daily.dev og:title: Getting started with Windsurf and CircleCI | daily.dev og:description: A step-by-step guide to integrating Windsurf (an AI-native IDE with the Cascade agentic assistant) with CircleCI via the Model Context Protocol (MCP). Covers... og:url: https://daily.dev/posts/getting-started-with-windsurf-and-circleci-15a4qq8o6 og:image: https://api.daily.dev/og/posts/15A4qq8O6.png og:image:alt: Getting started with Windsurf and CircleCI og:image:width: 1200 og:image:height: 630 og:locale: en --- [CircleCI](https://daily.dev/sources/circle) [Read post](https://api.daily.dev/r/15A4qq8O6) # [Getting started with Windsurf and CircleCI](https://api.daily.dev/r/15A4qq8O6 "Go to post") A step-by-step guide to integrating Windsurf (an AI-native IDE with the Cascade agentic assistant) with CircleCI via the Model Context Protocol (MCP). Covers setting up a CircleCI account, generating API tokens, configuring the CircleCI MCP server in Windsurf, and using Cascade to validate configs, trigger pipelines, analyze build failures, inspect test results, and identify flaky tests—all without leaving the editor. Also includes troubleshooting tips for common MCP connection and authentication issues. [#ai-assisted-development](/tags/ai-assisted-development "Check all #ai-assisted-development posts")[#cicd](/tags/cicd "Check all #cicd posts")[#circleci](/tags/circleci "Check all #circleci posts")[#mcp](/tags/mcp "Check all #mcp posts")[#windsurf](/tags/windsurf "Check all #windsurf posts") Feb 26•12m read time•From [circleci.com](https://api.daily.dev/r/15A4qq8O6 "circleci.com") [](https://api.daily.dev/r/15A4qq8O6 "Go to post") Table of contents [This tutorial covers:](https://api.daily.dev/r/15A4qq8O6?a=this-tutorial-covers "This tutorial covers:")[Before you start](https://api.daily.dev/r/15A4qq8O6?a=before-you-start "Before you start")[What makes Windsurf different](https://api.daily.dev/r/15A4qq8O6?a=what-makes-windsurf-different "What makes Windsurf different")[Finding your way around Windsurf](https://api.daily.dev/r/15A4qq8O6?a=finding-your-way-around-windsurf "Finding your way around Windsurf")[Why CI matters for AI-assisted development](https://api.daily.dev/r/15A4qq8O6?a=why-ci-matters-for-ai-assisted-development "Why CI matters for AI-assisted development")[Getting started with CircleCI](https://api.daily.dev/r/15A4qq8O6?a=getting-started-with-circleci "Getting started with CircleCI")[Setting up a CircleCI project](https://api.daily.dev/r/15A4qq8O6?a=setting-up-a-circleci-project "Setting up a CircleCI project")[Wiring up the CircleCI MCP server](https://api.daily.dev/r/15A4qq8O6?a=wiring-up-the-circleci-mcp-server "Wiring up the CircleCI MCP server")[Checking your configuration before you push](https://api.daily.dev/r/15A4qq8O6?a=checking-your-configuration-before-you-push "Checking your configuration before you push")[Starting pipelines from your editor](https://api.daily.dev/r/15A4qq8O6?a=starting-pipelines-from-your-editor "Starting pipelines from your editor")[Figuring out why builds fail](https://api.daily.dev/r/15A4qq8O6?a=figuring-out-why-builds-fail "Figuring out why builds fail")[Digging into test results](https://api.daily.dev/r/15A4qq8O6?a=digging-into-test-results "Digging into test results")[Using the CircleCI CLI through Cascade](https://api.daily.dev/r/15A4qq8O6?a=using-the-circleci-cli-through-cascade "Using the CircleCI CLI through Cascade")[Troubleshooting](https://api.daily.dev/r/15A4qq8O6?a=troubleshooting "Troubleshooting")[Pulling it all together](https://api.daily.dev/r/15A4qq8O6?a=pulling-it-all-together "Pulling it all together") 207 Impressions Comment Bookmark Copy Share your thoughtsPost [](https://daily.dev/sources/circle) [CircleCI](https://daily.dev/sources/circle "https://daily.dev/sources/circle") Circle is a platform for developers and software teams to collaborate, share knowledge, and streamli... Read more 51 Followers • 442 Upvotes #### Would you recommend this post? Copy link WhatsApp Facebook X New Squad Copy linkShare with your friends ```json {"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://daily.dev/#organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180},"sameAs":["https://twitter.com/dailydotdev","https://github.com/dailydotdev","https://www.linkedin.com/company/daily-dev-ltd"]},{"@type":"WebSite","@id":"https://daily.dev/#website","url":"https://daily.dev","name":"daily.dev","publisher":{"@id":"https://daily.dev/#organization"},"potentialAction":{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https://daily.dev/search?q={search_term_string}"},"query-input":"required name=search_term_string"}}]} {"@context":"https://schema.org","@type":"TechArticle","headline":"Getting started with Windsurf and CircleCI","url":"https://daily.dev/posts/getting-started-with-windsurf-and-circleci-15a4qq8o6","mainEntityOfPage":{"@type":"WebPage","@id":"https://daily.dev/posts/getting-started-with-windsurf-and-circleci-15a4qq8o6"},"datePublished":"2026-02-26T01:06:08.973Z","dateModified":"2026-03-30T02:18:21.867Z","description":"A step-by-step guide to integrating Windsurf (an AI-native IDE with the Cascade agentic assistant) with CircleCI via the Model Context Protocol (MCP). Covers...","image":"https://media.daily.dev/image/upload/f_auto,q_auto/v1/posts/0a67b6b4cdcb34a90deeb69e0f99a705?_a=AQAEuop","thumbnailUrl":"https://media.daily.dev/image/upload/f_auto,q_auto/v1/posts/0a67b6b4cdcb34a90deeb69e0f99a705?_a=AQAEuop","isAccessibleForFree":true,"articleSection":"CircleCI","inLanguage":"en","publisher":{"@type":"Organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180}},"author":{"@type":"Organization","name":"CircleCI","logo":"https://media.daily.dev/image/upload/t_logo,f_auto/v1/logos/661fc536429943fdb5426b9f33fd8e3c","url":"https://daily.dev/sources/circle"},"commentCount":0,"discussionUrl":"https://daily.dev/posts/getting-started-with-windsurf-and-circleci-15a4qq8o6","interactionStatistic":[{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":0},{"@type":"InteractionCounter","interactionType":{"@type":"CommentAction"},"userInteractionCount":0}],"keywords":"ai-assisted-development,cicd,circleci,mcp,windsurf","timeRequired":"PT12M"} {"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://daily.dev"},{"@type":"ListItem","position":2,"name":"CircleCI","item":"https://daily.dev/sources/circle"},{"@type":"ListItem","position":3,"name":"Getting started with Windsurf and CircleCI"}]} ```