Overboard Studio — MCP 服务器

Overboard Studio 是一个协作白板。这是官方的模型上下文协议 (MCP) 服务器：它允许任何 AI 智能体（Claude、ChatGPT、Cursor、Codex 等）创建和管理真实、可共享的白板——包括便签、形状、文本、框架、图表、流程图、表格、连接线——并实时显示在 Overboard Web 应用中。

托管端点（推荐）： https://overboard.studio/mcp（支持 OAuth，适用于 Claude.ai、ChatGPT、Cursor 等）

Stdio 模式： 适用于本地运行的 Claude Code / Cursor / Claude Desktop。

快速连接

Claude.ai (网页版)

设置 → 连接器 → 添加自定义连接器 → URL: https://overboard.studio/mcp → 完成 OAuth 流程。

Claude Code

claude mcp add --transport http overboard https://overboard.studio/mcp
/mcp auth

Claude Desktop (stdio)

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "overboard": {
      "command": "npx",
      "args": ["-y", "@overboard/mcp-server"],
      "env": {
        "SUPABASE_URL": "https://your-project.supabase.co",
        "SUPABASE_SERVICE_ROLE_KEY": "your-service-role-key"
      }
    }
  }
}

Cursor

添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "overboard": {
      "url": "https://overboard.studio/mcp"
    }
  }
}

工具 (16)

白板 (Boards)

工具	描述	注解
`get_current_user`	已认证用户的 ID、邮箱、显示名称	只读
`list_boards`	你拥有或被邀请加入的白板	只读
`get_board`	白板元数据 + 成员/元素数量	只读
`create_board`	创建新的空白白板，你将成为所有者	写入
`create_board_with_elements`	创建预填充元素的白板（推荐）	写入
`rename_board`	重命名你拥有的白板	写入，幂等
`delete_board`	级联删除白板、成员、元素	破坏性
`get_board_url`	在 Web 应用中打开白板的直接 URL	只读

元素 (Elements)

工具	描述	注解
`get_elements`	白板上的所有元素	只读
`create_element`	添加便签 / 形状 / 文本 / 框架 / 图表等	写入
`bulk_create_elements`	批量创建（>2 个元素时推荐）	写入
`update_element`	合并属性 — 移动/调整大小/重新着色/编辑文本	写入，幂等
`delete_element`	删除单个元素	破坏性

协作 (Collaboration)

工具	描述	注解
`get_collaborators`	拥有角色的白板成员	只读
`get_board_activity`	最近的元素更改（默认最近 24 小时）	只读
`invite_to_board`	生成可共享的邀请链接	写入

元素类型

sticky-note, text, path, shape, connector, frame, graph, chart, flowchart, table, timeline, kanban, doc, vote, timer, estimation

系统会自动应用位置、大小和样式的智能默认值——你只需指定想要自定义的内容即可。

身份验证

托管端点使用 OAuth 2.0。客户端（Claude.ai 等）会引导用户完成一次 Overboard 的认证流程；令牌有效期为 30 天。

Stdio 模式使用 Supabase 服务角色密钥 (service-role key) —— 通过环境变量传递。每个工具调用都会通过 Supabase 行级安全性 (RLS) 强制执行基于用户的白板访问权限；服务角色密钥仅在需要读取/写入多用户状态的工具中绕过 RLS。

从源码构建

npm install
npm run build
node dist/index.js

对于 HTTP 模式：

node dist/index.js --http --port=3002

使用 MCP Inspector 测试

SUPABASE_URL=... SUPABASE_SERVICE_ROLE_KEY=... \
  npx @modelcontextprotocol/inspector node dist/index.js

示例提示词

连接后，尝试：

"列出我所有的白板"
"创建一个冲刺规划白板，包含 5 个黄色便签，内容为：设计登录、设置 API、编写测试、部署到暂存环境、代码审查"
"显示白板 {id} 上的所有内容"
"将第一个便签移动到 (500, 300) 并将其颜色改为绿色"
"为白板 {id} 生成一个编辑者邀请链接"

许可证

MIT

Overboard Studio MCP Server