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

# Use Monk with Windsurf

> Enable Monk MCP and make it available to Cascade in Windsurf

Monk and Cascade run in the same Windsurf window. The Monk MCP server is enabled automatically during [setup](/getting-started/installation) — you just need to allow it in Windsurf's MCP management UI.

## Prerequisites

Make sure you have completed the [Monk setup](/getting-started/installation) and the MCP server step shows as running in the setup screen.

## Setup

<Steps>
  <Step title="Open MCP management in Cascade">
    Click the **MCPs** icon in the top-right menu of the Cascade panel, or go to **Windsurf Settings → Cascade → MCP Servers**.
  </Step>

  <Step title="Enable Monk">
    Find Monk in the MCP list, click **Install** or enable it, and confirm its tools are turned on.

    <Note>
      Windsurf supports per-tool enablement and has a total tool limit. If you use many MCP tools, make sure Monk's are enabled.
    </Note>
  </Step>

  <Step title="Start using Monk">
    Ask Cascade to use Monk for deployment, infrastructure, or runtime tasks.

    <img src="https://mintcdn.com/monk-d20f97b6/iTVBwF9nbUUE5DjB/assets/Windsurf_IDE_agent_communication.gif?s=e6740647532600d96e5fa835b40192c5" alt="Windsurf agent communicating with Monk" height="200" className="rounded-lg" data-path="assets/Windsurf_IDE_agent_communication.gif" />
  </Step>
</Steps>

<Card title="Deploy your first app" icon="rocket" href="/getting-started/first-deployment" color="#3B82F6">
  Monk is connected — now deploy your project
</Card>

## Troubleshooting

If Monk does not appear, confirm it is installed and MCP is enabled for this workspace, then reopen the project. Enterprise users may need MCP enabled by an admin before servers become visible.

<Card title="More troubleshooting" icon="wrench" href="/getting-started/troubleshooting-installation">
  Common issues and how to fix them
</Card>
