McpManagedWindsurf

Windsurf

Copy page

Setup Steps

Step 1: Create an MCP Assistant

  1. Log in to the Inkeep Dashboard
  2. Navigate to Projects → Select your project
  3. Open the Assistants tab
  4. Click Create assistant → Choose MCP
  5. Enter a name and click Create

Step 2: Configure Your MCP Client

Note
Note

Important: Replace YOUR_MCP_SERVER_URL with the actual URL from your MCP Assistant page.

  1. Open Windsurf and navigate to the Cascade assistant sidebar.
  2. Click the hammer (MCP) icon, then Configure > View raw config to open the configuration file ~/.codeium/windsurf/mcp_config.json.
  3. Add the following configuration:
~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "inkeepMcp": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "YOUR_MCP_SERVER_URL"]
    }
  }
}
  1. Save the configuration file.
  2. Click the Refresh button in the Cascade sidebar next to "available MCP servers".
  3. Verify that the MCP server is listed in the "available MCP servers" section. When you click on it, you should see both the ask-question-about-inkeep and search-inkeep-docs tools.

Start Using MCP Features

  • Search documentation, GitHub issues, and release notes
  • Search community forums and discussions`
  • Ask for help with specific questions about our products, APIs, or implementation details.

Examples in Action

Basic Q&A

User: "How do I configure rate limiting?"
Assistant: [Uses ask-question-about-inkeep tool]
Response: "Rate limiting in Inkeep can be configured..."
User: "Find information about API authentication"
Assistant: [Uses search-inkeep-docs tool]
Response: "Here are the relevant sections about API authentication..."

Analytics & Insights

All interactions through the managed MCP server are automatically logged to your Inkeep Analytics tab, giving you insights into:

  • Usage patterns
  • Performance metrics

You can view a granular breakdown of what is being asked and how it is being answered in the Chat Sessions tab