Windsurf Setup

Configure Windsurf with Spala using the local installer and workspace project binding.

Windsurf Setup

Run the installer from the repository where Windsurf will work:

pnpm dlx @spala-ai/mcp-install init --client windsurf --yes --json

Execute the returned setup and status instructions. Complete browser auth only
if requested, then call account_status.

Apply the returned setup

Use the exact Windsurf configuration returned by the installer. Do not construct an MCP URL manually.

Verify the account

Run status, authenticate in a browser only when requested, and call account_status.

Connect one intended project

Reuse an existing project or create the intended project, then call project_connect exactly once.

Bind the workspace

Execute the returned workspace-only bind plan and use only the exact project details returned by Spala.

MCP endpoint

Do not configure api.spala.ai as MCP or derive project URLs from names. Use the installer output and project_connect response.

Spala Public MCP
/agents/mcp
Public MCP behavior and authentication
Public Agent Skills
/agents/skills
Agent workflow guidance
CORS and Security
/settings/cors-security
Frontend origin and security checklist