源码快照 @ 2026-09-02 (source-only, 剔除非源码素材)

packages/docs/model-context-protocol/windsurf.mdx

@@ -0,0 +1,75 @@
+---
+title: "OpenWork MCP for Windsurf"
+sidebarTitle: "Windsurf"
+description: "Windsurf MCP setup for OpenWork Connect through mcp-remote and OAuth access to your org's shared capabilities."
+---
+
+The OpenWork MCP server ([OpenWork Connect](/cloud/run-in-the-cloud/cloud-mcp))
+enables Windsurf to use the OpenWork capabilities your organization has made
+available to you: Gmail read/search, Calendar list/create, Drive search/read,
+Gmail draft creation, shared MCP connections such as Notion, Linear, Slack,
+Stripe, Exa, and Context7, shared skills, and OpenWork Cloud resources like
+skills, plugins, Collections, workers, members, roles, teams, and LLM
+providers. The server exposes only `search_capabilities` and
+`execute_capability`, so Windsurf searches what you can access and runs exact
+capability names instead of loading hundreds of tool definitions into context.
+
+## Server URL
+
+```text
+https://api.openworklabs.com/mcp/agent
+```
+
+OAuth sign-in uses your OpenWork account, and the organization you pick is
+pinned into the token. If you do not have an account, create a
+[free OpenWork account](https://app.openworklabs.com?mode=sign-up).
+
+## Setup
+
+1. Open Windsurf `Settings` > `Cascade` > `MCP Servers`.
+
+2. Click `Manage MCP Servers`, then `View raw config`.
+
+3. Add this to `~/.codeium/windsurf/mcp_config.json`:
+
+   ```json
+   {
+     "mcpServers": {
+       "openwork": {
+         "command": "npx",
+         "args": ["-y", "mcp-remote@latest", "https://api.openworklabs.com/mcp/agent"]
+       }
+     }
+   }
+   ```
+
+`mcp-remote` handles the browser OAuth on an HTTP loopback callback, which
+OpenWork accepts.
+
+## Switch organizations
+
+Remove the stored MCP auth token for `openwork`, then restart the server and
+choose the organization you want during browser sign-in.
+
+<Note>
+This is a setup guide. These steps match OpenWork Connect's OAuth profile:
+HTTPS or HTTP loopback callbacks, PKCE S256, and dynamic client registration
+fallback. Windsurf is listed as setup only because native proof is not complete.
+See the
+[client support status](/cloud/run-in-the-cloud/cloud-mcp#client-support-status)
+table.
+</Note>
+
+## What you can ask
+
+- "Which OpenWork organization am I connected to?"
+- "Add omar@example.com to my organization."
+- "Create a skill that writes weekly status reports and share it with my whole organization."
+- "Find the Q3 launch page in Notion and summarize it."
+
+## What's next
+
+- Read the [hub overview](/cloud/run-in-the-cloud/cloud-mcp) for OAuth, token,
+  server exposure, and troubleshooting details.
+- Publish Notion, Linear, Slack, and other shared tools with
+  [shared MCP connections](/cloud/share-with-your-team/shared-mcp-connections).