How to Use the Confluence MCP in Windsurf

Q: How does Windsurf connect to my Confluence instance?

Add the Confluence MCP Server to your mcpconfig.json file under the mcpServers key. Cascade automatically discovers the tools and starts using them when you ask it to search or write wiki pages.

Q: Can Windsurf search Confluence using complex CQL queries?

Yes, Windsurf uses the searchconfluence tool to run Confluence Query Language queries. You can ask Cascade to find pages matching specific tags, dates, or authors, and it will build the query for you.

Q: How does Windsurf handle Confluence page formatting?

The createpage and addpagecomment tools require HTML storage format. Windsurf handles this translation behind the scenes, converting your markdown prompts into valid Confluence HTML before publishing.

Let Cascade read, write, and search Confluence wiki pages directly within your Windsurf workspace.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Confluence MCP to Windsurf

Create your Vinkius account to connect Confluence to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Confluence with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate documentation updates in Windsurf

The `create_page` tool lets Cascade build and publish new wiki pages directly from your workspace. This MCP Server gives Cascade the ability to write your wiki pages for you. When you finish a feature, just tell Cascade to document it. It will format the HTML correctly and post it to the right space. If the page already exists, Cascade doesn't just overwrite it blindly. It runs `get_page` to check the current version, then updates the content or appends what is missing.

Deep wiki search without leaving Cascade

The `search_confluence` tool lets Cascade run deep queries across your entire workspace. Stop opening browser tabs to find internal docs. Ask Cascade to search your team's wiki, and this MCP tool will pull up relevant pages, blog posts, and comments. Once Cascade gets the search results, it can list the files using `list_pages` or dive into a specific space with `list_spaces` to map out your team's knowledge structure.

Keep track of team feedback and comments

The `list_page_comments` tool pulls inline and footer discussions directly into your IDE. Cascade can monitor and respond to team discussions on your documentation pages. It pulls down all threads to let you read feedback. When you resolve an issue or need to answer a teammate, Cascade writes a response in storage HTML format and posts it using `add_page_comment`.

Setup guide

Set up Confluence MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Confluence MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Confluence payment history." If connected, Cascade will call the Confluence tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "confluence-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Confluence. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Confluence now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Confluence MCP in Windsurf

Add the Confluence MCP Server to your mcp_config.json file under the mcpServers key. Cascade automatically discovers the tools and starts using them when you ask it to search or write wiki pages.

Yes, Windsurf uses the search_confluence tool to run Confluence Query Language queries. You can ask Cascade to find pages matching specific tags, dates, or authors, and it will build the query for you.

The create_page and add_page_comment tools require HTML storage format. Windsurf handles this translation behind the scenes, converting your markdown prompts into valid Confluence HTML before publishing.

Access is determined by the API token you provide to the MCP Server. If your token only has read access to certain spaces, Cascade will only see those spaces when running list_spaces or get_space_details.

Your wiki pages, comments, and space details stay between Windsurf and your Confluence instance. Vinkius runs the MCP Server in a secure, ephemeral sandbox, meaning your raw corporate documentation is never stored or used for training.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript