Whimsical

Whimsical MCP 服务

官方 Whimsical MCP 服务。请 Claude、ChatGPT、Cursor 或任何 MCP 客户端创建流程图、思维导图、时序图、线框图或架构图，它就会在你的工作区中创建一个可编辑的 Whimsical 白板。你获得的是团队可以打开、编辑和评论的真实文件，而不是静态图片。该服务还可以搜索、读取、编辑和评论你已有的白板和文档。

• 端点： https://mcp.whimsical.com/mcp（由 Whimsical 托管，使用 Streamable HTTP，无需安装）
• 身份验证： OAuth 2.1 with PKCE。无需管理 API 密钥。
• 套餐： 所有工具均可在免费套餐中使用，每月最多包含 50 个白板对象。付费套餐没有对象数量限制。
• 客户端： Claude、Claude Code、ChatGPT、Cursor、支持 GitHub Copilot 的 VS Code、Grok、Codex，以及任何支持远程 MCP 服务的客户端。

快速开始

在 Claude Code 中：

claude mcp add --transport http whimsical https://mcp.whimsical.com/mcp

在其他支持远程 MCP 服务的客户端中，使用此 URL 添加服务，并在出现提示时登录 Whimsical：

https://mcp.whimsical.com/mcp

然后试试：“在 Whimsical 中创建一张用户注册流程图。”每个客户端的设置步骤见下文。

可以创建的内容

下面的每个示例都是可尝试的提示词。Agent 会在你的 Whimsical 工作区中创建文件，并回复一个链接。支持此功能的客户端还会在聊天中显示预览。

流程图

在 Whimsical 中创建一张用户登录流程图：登录页面、验证凭据；如果凭据有效，则进入控制面板；如果无效，则显示错误并重试。

你会得到一张自动排版的流程图，其中包含决策节点、带标签的连接线，以及清晰的自上而下布局。要求从左到右排列，Agent 就会重新排版。

时序图

在 Whimsical 中绘制一张 OAuth 授权码流程时序图，展示浏览器、我们的 Web 应用、授权服务器和 API 之间的交互。

Agent 会为每个参与者创建一条生命线，并按顺序展示他们之间的消息。

架构图

在 Whimsical 中绘制一张我们的系统技术图：React 前端调用 API 网关，网关再将请求路由到身份验证、计费和通知服务，每个服务都有自己的数据库。

Agent 会在白板上排布各个组件，用服务边界和连接线展示请求与数据的流向。

思维导图

在 Whimsical 中创建一张思维导图，为移动应用集思广益，分支包括新手引导、核心功能、盈利模式和增长。

你会得到一张包含中心主题及其分支的思维导图，并以水平方式排布。要求垂直布局，即可获得自上而下的树状结构。

线框图

在 Whimsical 中为设置页面创建一张线框图，包含侧边栏导航、带头像和表单字段的个人资料区域，以及底部的危险操作区域。

Agent 会使用线框图元素（容器、输入框、按钮、图标）构建页面，并采用 flexbox 布局。因此，后续要求（例如“让主按钮占满整行宽度”）也能保持所有元素对齐。

便利贴

在 Whimsical 中为我们上一个冲刺周期的回顾创建便利贴，按做得好的地方、做得不好的地方和可以尝试的新想法分组。

你会在白板上得到一组便利贴，按你要求的类别分组并自动排布，团队可以直接补充内容并投票。

文档和表格

将新 API 的技术规范整理成 Whimsical 文档，并用表格比较我们讨论过的三个选项。

文档支持标题、列表、链接、代码块和表格。表格也可以放在画布上。

使用工作区中的现有内容

在我的 Whimsical 工作区中搜索与“API 设计”相关的内容，并总结搜索结果。

在 API 流程图中添加一个速率限制步骤，然后留言请团队审核。

Agent 可以搜索工作区、读取白板和文档（包括白板的 PNG 快照）、编辑现有图表、在文件夹之间移动文件，以及读取、撰写和解决评论串。

工具

工具	功能
search	按文本、创建日期或更新日期搜索工作区
fetch	按 ID 读取白板、文档或文件夹，或获取白板的 PNG 快照
file_tree	浏览 Private、Shared 和团队版块及其中的文件夹
how_to	在创建流程图或线框图前查阅 Whimsical 语法指南（Agent 会自行调用此工具）
create_file	创建白板、文档或文件夹；除非选择文件夹，否则会创建在 Private 版块中
add_board_content	向白板添加流程图、思维导图、时序图、便利贴、表格或线框图
add_doc_content	将 Markdown 追加到文档中
edit	在白板上添加、更新或删除形状、文本和连接线，编辑思维导图和时序图节点，或更改文档中的内容块
wireframe_edit	重新排列或编辑线框图元素
auto_layout	重新对流程图应用自动布局，可选择从上到下、从左到右或其他方向
delete	将文件、文件夹或文档移至回收站
move	将文件、文件夹或文档移至其他文件夹
comment_read	读取白板或文档上的评论串
comment_edit	创建、回复、编辑、解决、重新打开或删除评论

详情及更多提示词示例，请参阅工具参考。

设置

Claude

Whimsical 是 Claude 连接器目录中的已验证连接器。打开 Whimsical 连接器，点击 Connect，然后登录 Whimsical。

Claude Code

claude mcp add --transport http whimsical https://mcp.whimsical.com/mcp

在 Claude Code 中运行 /mcp 以登录。

ChatGPT

使用 ChatGPT 版 Whimsical 应用：

1. 在 ChatGPT 中打开 Settings → Plugins。
2. 搜索 Whimsical，或使用上面的链接。
3. 点击 Connect 并完成授权。

然后在任意聊天中输入 @Whimsical。更多信息请参阅 ChatGPT 指南。

Cursor

或者从 Cursor 插件目录安装 Whimsical 插件，也可以手动添加：打开 Cursor → Settings → Cursor Settings → Tools & MCP，添加新的 MCP 服务，并保存以下配置：

{
  "mcpServers": {
    "whimsical": {
      "url": "https://mcp.whimsical.com/mcp"
    }
  }
}

更多信息请参阅 Cursor 的 MCP 文档。

VS Code（GitHub Copilot）

1. 按 ⌘ Shift P（或 Ctrl Shift P），然后运行 MCP: Add Server。
2. 选择 HTTP。
3. 粘贴 https://mcp.whimsical.com/mcp，然后按 Enter。
4. 系统提示输入服务 ID 时，输入 whimsical。
5. 选择将服务添加到全局范围，还是仅添加到当前工作区。

Grok

1. 前往 grok.com/connectors。
2. 点击 New Connector，然后选择 Custom。
3. 输入 https://mcp.whimsical.com/mcp，然后登录 Whimsical。

更多信息请参阅 Grok 指南。

其他客户端

任何支持通过 Streamable HTTP 连接远程 MCP 服务的客户端，都可以使用以下配置进行连接：

{
  "mcpServers": {
    "whimsical": {
      "url": "https://mcp.whimsical.com/mcp"
    }
  }
}

身份验证

该服务使用带 PKCE 的 OAuth 2.1。首次连接时，客户端会打开浏览器窗口，让你登录 Whimsical 并批准访问你的工作区。之后，Agent 会以你的身份在 Whimsical 中工作，并使用你批准的访问权限。

远程和桌面 MCP

本仓库介绍的是 远程 MCP 服务，由 Whimsical 托管，也是 Whimsical 推荐大多数人使用的服务。Whimsical 还提供 桌面 MCP 服务，在 Whimsical 桌面应用内运行，并可处理你当前打开的文件。如需设置，请联系支持团队。

常见问题

这是 Whimsical 官方 MCP 服务吗？ 是的。该服务由 Whimsical 构建、托管和维护，并以 com.whimsical/mcp 的名称列在官方 MCP Registry 中。也有社区构建的 Whimsical MCP 服务；这是由 Whimsical 维护的版本。

我需要安装或运行什么吗？ 不需要。该服务运行于 https://mcp.whimsical.com/mcp。只需将该 URL 添加到客户端并登录即可。

我需要 API 密钥吗？ 不需要。登录使用 OAuth，因此无需创建、存储或轮换密钥。

它能生成图像或可编辑图表吗？ 能生成可编辑图表。Agent 创建的所有内容都是工作区中的普通 Whimsical 文件，你和团队成员都可以打开、修改和评论。fetch 工具还可以返回画板的 PNG 快照。

它能读取和更新我已有的图表吗？ 可以。它可以搜索你的工作区、读取画板和文档、编辑内容、重新运行布局，并处理评论。

故障排除

• 登录页面未打开或登录失败。 在 Claude Code 中运行 /mcp，或使用客户端的重新连接操作再次登录。登录 Whimsical 后，浏览器会重定向回客户端。
• 安装后未显示工具。 在 Claude Code 中运行 /reload-plugins，或在其他客户端中重启编辑器。
• 出现 401 或“Missing Bearer token”。 会话已过期。通过 /mcp 或客户端的重新连接操作再次登录。
• 没有 Whimsical 账户。 前往 https://whimsical.com 免费注册。该服务会让你登录现有工作区。

链接

• 概览： https://whimsical.com/mcp
• 设置指南： https://whimsical.com/learn/integrations/mcp
• 工具参考： https://whimsical.com/learn/ai/mcp-tools
• 支持： [email protected]
• 隐私政策： https://whimsical.com/terms/privacy