<!-- mobian-agent-page publisher="dailydev" canonical="https://daily.dev/posts/getting-started-with-windsurf-and-circleci-15a4qq8o6" -->

---
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
---

> ## Documentation Index
> Fetch the complete documentation index at: https://daily.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting started with Windsurf and CircleCI

**[CircleCI](https://daily.dev/sources/circle)** · 12 min read · 0 upvotes · 0 comments

## Summary

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.

## Full article

daily.dev links to this article rather than hosting it. Read it at the original source: <https://circleci.com/blog/getting-started-with-windsurf-and-circleci/>

## Similar posts on daily.dev

- [Windsurf AI and SonarQube The Dream Team for AI Code Quality](https://daily.dev/posts/windsurf-ai-and-sonarqube-the-dream-team-for-ai-code-quality-bkavse7ea) · Foojay.io · 0 upvotes · 0 comments
- [Getting started with Claude Code and CircleCI](https://daily.dev/posts/getting-started-with-claude-code-and-circleci-c4ape84rf) · CircleCI · 0 upvotes · 0 comments

---

Tags: [#ai-assisted-development](https://daily.dev/tags/ai-assisted-development), [#cicd](https://daily.dev/tags/cicd), [#circleci](https://daily.dev/tags/circleci), [#mcp](https://daily.dev/tags/mcp), [#windsurf](https://daily.dev/tags/windsurf)

[View this post on daily.dev](https://daily.dev/posts/getting-started-with-windsurf-and-circleci-15a4qq8o6)

```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"}]}
```

