Windsurf (Codeium)

Codeium’s agentic IDE. Use OAuth when the client offers it; use a token as the fallback.

One-click connect (recommended)

Open or create:

~/.codeium/windsurf/mcp_config.json

Add Popcorn without headers (Windsurf will handle the OAuth sign-in):

{
  "mcpServers": {
    "popcorn": {
      "serverUrl": "https://api.popcorn.co/mcp"
    }
  }
}

Save the file. If Windsurf opens a browser sign-in, approve Popcorn there. In Cascade, refresh the tools list.

Security token

First, generate a security token.

{
  "mcpServers": {
    "popcorn": {
      "serverUrl": "https://api.popcorn.co/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_POPCORN_API_KEY"
      }
    }
  }
}