Windsurf

Configure Instructionly in Windsurf, Codeium's AI-powered IDE.

Prerequisites

Before you begin, make sure you have:

• Your MCP credentials
• The Instructionly CLI installed

Configuration

Add this to your ~/.codeium/windsurf/mcp_config.json file (create it if it doesn't exist):

{
  "mcpServers": {
    "instructionly": {
      "command": "instructionly",
      "env": {
        "MCP_KEY_ID": "YOUR_MCP_KEY",
        "MCP_SECRET": "YOUR_MCP_SECRET",
        "MCP_WORKSPACE": "YOUR_WORKSPACE_SLUG"
      }
    }
  }
}

Replace the placeholder values with your actual credentials:

• YOUR_MCP_KEY - Your MCP key (e.g., ion_xxx)
• YOUR_MCP_SECRET - Your MCP secret
• YOUR_WORKSPACE_SLUG - Your workspace slug (e.g., workspace-abc123)

Restart Windsurf

After saving the configuration, restart Windsurf for the changes to take effect.

Verify Installation

Test the connection by asking Windsurf a question that includes "ion":

ion, what instructions are available in my workspace?

If configured correctly, you'll see information about your workspace and available skills.