Supasidebar MCP

SupaSidebar MCP服务器

让AI助手与您的 SupaSidebar 书签、空格、标签等。

适用于Claude Code、Claude Desktop、Cursor、Codex、VS Code Copilot和任何兼容MCP的客户端。

文档: docs.supasidebar.com/features/mcp

运作原理

AI Client --stdio--> MCP Server --localhost:9847--> SupaSidebar App
(Claude,              (this package,                 (your Mac,
 Cursor)               open source)                   your data)

MCP服务器是一个瘦桥。它将AI工具调用转换为对Mac上运行的SupaSidebar应用程序的本地HTTP请求。你的数据永远不会离开你的机器。

信任与隐私

1. 零网络请求 -仅与通信 127.0.0.1 （本地主机）。主机是硬编码的，不能更改。
2. 零数据存储 -没有写入文件，没有数据库，没有缓存。
3. 零遥测 -没有分析，没有跟踪，没有使用情况报告。
4. 一个运行时依赖项 - @modelcontextprotocol/sdk （协议库）。

先决条件

你需要 Node.js 18或更新版本 （提供 npx).请检查：

node --version    # should print v18.x or higher
npx --version     # should print a version number, not "command not found"

如果 npx 找不到，请安装Node。选择你喜欢的：

• 与Homebrew合作 （最简单的，如果你已经有了 brew):

  brew install node

• 没有自制 -从下载LTS安装程序 并运行它。macOS .pkg 安装程序放置 node 和 npx 自动在PATH上；之后只需重新启动终端即可。

SupaSidebar应用程序必须正在运行-MCP服务器与位于的本地网桥API进行通信 127.0.0.1:9847.

兼容性： supasidebar-mcp@0.2.3 需要 SupaSidebar应用程序0.17.2或更高版本。较旧的应用程序版本缺少36个工具中的一些工具使用的网桥端点。

macOS权限

SupaSidebar需要两个macOS权限，MCP工具才能端到端工作（尤其是任何涉及浏览器、选项卡或窗口的内容）。在中打开相关窗格 系统设置→ 隐私和安全:

• 无障碍 -窗口/侧边栏控制、全局快捷方式和选项卡管理所需。

打开： 隐私和安全→ 无障碍

• 自动化 -浏览器集成所需（阅读实时标签，通过AppleScript在特定浏览器/配置文件中打开URL）。

打开： 隐私和安全→ 自动化

确保 SupaSidebar 在两个窗格中都已选中。如果您在应用程序运行时授予权限，请退出并重新启动SupaSidebar，以便它获取新的权限。

设置

克劳德代码

推荐的方法是在用户范围内注册，以便在每个项目中都可用：

claude mcp add -s user supasidebar -- npx -y supasidebar-mcp

验证它是否已注册：

claude mcp list
# expected: supasidebar    ✓ Connected

在会话内， /mcp 显示连接的服务器和工具数量。

仅仅为了一个项目？ 掉落 -s user: ``bash claude mcp add supasidebar -- npx -y supasidebar-mcp ``

⚠️ 不要将MCP配置放入 ~/.claude/settings.json. 该文件仅用于钩子、权限和环境变量——Claude Code会默默地忽略其中的未知密钥，因此服务器似乎会“注册”，但不会加载任何工具。正确的位置是 ~/.claude.json 在...之下 mcpServers （其中 claude mcp add 自动写入）。

更喜欢手工编辑？ 添加 ~/.claude.json （注： .claude.json，不 .claude/settings.json): ``json { "mcpServers": { "supasidebar": { "type": "stdio", "command": "npx", "args": ["-y", "supasidebar-mcp"] } } } `` 编辑后重新启动Claude Code。

克劳德桌面版

添加 claude_desktop_config.json (Claude>设置>开发人员>编辑配置):

{
  "mcpServers": {
    "supasidebar": {
      "command": "npx",
      "args": ["-y", "supasidebar-mcp"]
    }
  }
}

光标

添加 .cursor/mcp.json:

{
  "mcpServers": {
    "supasidebar": {
      "command": "npx",
      "args": ["-y", "supasidebar-mcp"]
    }
  }
}

法典

1. 确保Codex CLI已安装并且SupaSidebar正在运行
2. 注册MCP服务器：

   codex mcp add supasidebar -- npx -y supasidebar-mcp

1. 证实 codex mcp list 和 codex mcp get supasidebar
2. 在食品法典委员会会议中，要求代理人 *“列出您可以访问的每个SupaSidebar工具-至少应该有35个”* 确认所有工具都已连接好。食品法典委员会 /mcp 面板有时在报告下，但工具仍然可以调用-请参阅 故障排除 在......下面

故障排除

npx: command not found / command failed: npx 您尚未安装Node。要么跑 brew install node，或从下载LTS安装程序 如果你不使用Homebrew。之后重新启动终端和AI客户端。

**工具未出现在Claude代码中(mcp__supasidebar__* 失踪）**

• 跑 claude mcp list -如果 supasidebar 不是吗，注册失败。重新运行 claude mcp add 上面的命令。
• 确认配置已在 ~/.claude.json, 不 ~/.claude/settings.json.
• 在任何MCP更改后重新启动Claude Code——服务器在会话开始时生成一次。
• 有关详细的握手日志： claude --mcp-debug.

“无法连接到SupaSidebar”/ fetch failed MCP服务器无法访问SupaSidebar应用程序。确保SupaSidebar正在运行，然后检查网桥：

curl http://127.0.0.1:9847/api/v1/health
# expected: {"app":"SupaSidebar","status":"ok",...}

“生成进程失败”（游标/版本管理器） 如果你使用Node版本管理器（fnm、nvm、volta），AI客户端可能看不到你的shell PATH。将命令/args替换为：

"command": "/bin/zsh",
"args": ["-lc", "npx -y supasidebar-mcp"]

食品法典委员会 /mcp 面板显示的工具比预期的少 已知显示错误(openai/codex#17021)-Codex CLI /mcp 在报告MCP工具下查看，即使所有这些工具都已注册并可调用。要验证实际可用的内容，请直接向代理询问，并给出如下提示：

列出您可以访问的每个SupaSidebar工具——至少应该有35个。

如果食品法典委员会返回的食品较少，请向下面的MCP检查员求助，以了解基本情况。

查看暴露的工具

不同的客户对MCP工具有不同的看法，一些（特别是Codex）报告了实际注册的内容。使用其中一个来查看地面真相：

• 内部克劳德代码： 类型 /mcp -可靠地列出每个连接的服务器及其工具数量。
• 食品法典内部： 类型 /mcp （通常在报告下——见上文条目；更喜欢询问代理人或使用检查员）。
• 通用-MCP检查器 （无需任何AI客户端即可工作；启动本地web UI）：

  npx @modelcontextprotocol/inspector npx -y supasidebar-mcp

在浏览器中打开打印的URL，单击“连接”，然后单击“列出工具”-您将看到所有36个工具及其模式，并可以测试调用其中任何一个。这是确认工具计数问题是在服务器还是在客户端的最快方法。

可用工具（36）

浏览和搜索

创建和组织

行动

设置和快捷方式

自定义网络搜索快捷方式

空中交通管制

指南

许可证

麻省理工学院