Useful Work

Useful Work MCP 服务

用你自己的 AI 助手修复网站。Useful Work 会检查网站中的拼写错误、错误信息、过时文本、失效链接和图片、加载缓慢的页面，以及即将过期的安全证书和域名。只有至少两个 Agent 对同一问题达成一致时，才会报告该问题。

连接 Claude Code、Cursor、VS Code 或其他 MCP 客户端后，你的助手会读取线上网站的问题，在网站代码中进行修改，将问题标记为已修复，并在你发布后要求重新检查。

该服务托管在云端。连接地址：

https://usefulwork.app/mcp

通过 OAuth 登录的 Streamable HTTP：助手首次连接时，会打开一个 Useful Work 页面供你批准。它已列入 官方 MCP Registry ，名称为 app.usefulwork/useful-work。此仓库包含设置指南、注册表条目 (server.json) 和一个 Agent 插件；服务本身的代码未公开。

助手能做什么

工具	功能
list_sites	列出你的网站、各网站的状态，以及每个网站待修复的问题数量
site_health	查看网站的健康评分（满分 100 分）及扣分原因
get_fixes	查看所有待修复项、它们在页面上的位置以及建议的修改
mark_fixed	根据 get_fixes 返回的 ID，清除已修复项
ignore	清除实际上并非问题的项目
recheck	在你发布后重新读取网站；已修复项会自动确认
credit	查看你剩余的检查额度，以及如何增加额度
add_site	添加新网站（仅限你连接时已允许此操作的情况）

此外，还提供一个现成的提示词 fix_my_site，以及作为资源提供的每个网站的修复列表，地址为 usefulwork://fixes/{domain}。

设置

1. 登录 usefulwork.app/app 并添加你的网站。
2. 将此服务添加到你的助手。
3. 在首次连接时打开的 Useful Work 页面上批准连接。之后，你可以在仪表板的 连接 AI 下查看它，并随时断开连接。

Claude Code：运行以下命令，然后输入 /mcp 并选择 Authenticate。

claude mcp add --transport http --scope user useful-work https://usefulwork.app/mcp

Cursor：在 ~/.cursor/mcp.json 中添加配置，然后点击 Useful Work 旁边的 Needs login。

{
  "mcpServers": {
    "useful-work": { "url": "https://usefulwork.app/mcp" }
  }
}

VS Code：在 .vscode/mcp.json 中配置。VS Code 首次连接时会要求你登录。

{
  "servers": {
    "useful-work": { "type": "http", "url": "https://usefulwork.app/mcp" }
  }
}

Gemini CLI：将此仓库安装为扩展，然后运行 /mcp auth useful-work。

gemini extensions install https://github.com/dav3trad3r/useful-work-mcp

Cline：在 cline_mcp_settings.json 中配置，并使用 连接 AI 中的 API 密钥（参见 llms-install.md）。

{
  "mcpServers": {
    "useful-work": { "type": "streamableHttp", "url": "https://usefulwork.app/mcp", "headers": { "Authorization": "Bearer uwk_YOUR_KEY" } }
  }
}

Claude.ai、ChatGPT 和其他应用：添加自定义连接器，地址为 https://usefulwork.app/mcp。

无法登录的助手：在仪表板的 连接 AI 下创建 API 密钥，并将其作为标头 Authorization: Bearer uwk_… 发送。

然后打开你网站的项目并询问：“使用 Useful Work 修复我的网站。”在 Claude Code 中，也可以通过 /mcp__useful-work__fix_my_site 使用该提示词。

拉取请求检查

github-action 是一款面向网站维护团队的 GitHub Action：每次拉取请求提交时，它都会将预览部署与线上网站进行比较，并评论此改动可能导致上线的页面、链接、图片或启动问题。设置说明见其 README。

作为 Agent 插件使用

此仓库也是一个 Agent Plugin：包含 plugin.json、位于 mcp.json 的服务，以及一个技能 fix-website。该技能会获取修复列表、修改代码、将项目标记为已修复，并在你发布后要求重新检查。服务会自行登录，因此插件不包含任何密钥。

安全性

• 您网站上引用的文本在每条结果中都会标记为待编辑内容，而不是要遵循的指令。任何人都可以在网站上写内容（评论、留言），因此服务端会将其视为数据。
• 已连接的助手可以读取您的网站、将项目标记为已修复或已忽略，并请求重新检查。只有在您批准时勾选相应选项，它才能添加网站。它无法付款或更改您的设置。
• 您可以随时在控制面板中断开助手或撤销密钥；操作会立即生效。请勿将密钥放在项目文件和代码仓库中。

费用

连接免费。检查费用从预付卡余额中扣除，每次检查 $0.003：每个段落检查三次，每个链接或图片检查两次。检查一个包含 30 个页面的网站，费用约为 $3.37；此后只检查新增或更改的文本。重新阅读页面免费。没有订阅费。请参阅定价。

链接

• 网站：usefulwork.app
• 开发者设置：usefulwork.app/builders
• 条款：usefulwork.app/terms · 隐私：usefulwork.app/privacy
• 联系方式：[email protected]

Useful Work 由 Tokenise Pty Ltd. 制作。本代码仓库中的文档采用 MIT 许可证。