Dregs

Dregs MCP

Dregs 会为网站用户评估欺诈和滥用风险：虚假注册、机器人、重复账户、推荐欺诈和账户接管，并说明评分依据的观察结果。内置的 Model Context Protocol（MCP）服务让 Claude、ChatGPT、Codex、 Cursor 和 VS Code 等 AI Agent 能够调查身份、审核升级事件，并调整 Dregs 账户中的规则。

此存储库是连接到该服务的公开入口：提供各客户端的配置片段、Claude Code 插件，以及 Dregs 在 MCP 目录中的条目元数据。服务本身由 Dregs 托管于 https://dregs.com/mcp，其源代码未在此发布。

完整且持续维护的指南见 Dregs 手册中的 AI Agents 章节。 此 README 是简版。

Dregs MCP 端点

URL	https://dregs.com/mcp
传输方式	Streamable HTTP
身份验证	OAuth 2.1（首选），或在 Authorization: Bearer 标头中使用 MCP 令牌
注册表名称	com.dregs/dregs-mcp

OAuth 是最简单的连接方式。支持 MCP OAuth 的客户端会引导你前往 Dregs，在浏览器中批准连接。如果你属于多个团队，可以在批准页面选择团队，并在 Dregs 控制面板的 Settings → AI Agents 下查看或撤销已连接的 Agent。

MCP 令牌适用于不支持 OAuth 的客户端，以及脚本化 Agent。在 Dregs 控制面板的 Settings → AI Agents 下创建令牌，并立即复制（令牌只显示一次），然后将其作为 Authorization: Bearer YOUR_TOKEN 发送。令牌在创建它的团队中会以你的身份操作，因此请像对待密码一样妥善保管。

将 Claude Code 连接到 Dregs

最快的方式是使用此存储库中的插件。它会添加 Dregs MCP 服务，以及用于将 Dregs 集成到应用程序中和后续处理数据的技能：

/plugin marketplace add dregs-sdk/dregs-mcp
/plugin install dregs@dregs

然后运行 /mcp，选择 dregs，并在浏览器中批准 OAuth 连接。你可以询问 Claude 例如 "总结我的 Dregs 账户"，以确认它能访问你的团队。

不使用插件时，可直接添加服务，Claude Code 会引导你完成 OAuth：

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

或者使用 MCP 令牌进行无头操作：

claude mcp add --transport http dregs https://dregs.com/mcp --header "Authorization: Bearer YOUR_TOKEN"

对应的项目级 .mcp.json：

{
  "mcpServers": {
    "dregs": {
      "type": "http",
      "url": "https://dregs.com/mcp"
    }
  }
}

插件技能

插件的技能是工作流，而不是工具架构；每项技能都会在执行前通过 get_documentation 读取相关手册章节，提出更改供你审核，并在写入任何内容前征求确认。

技能	功能
connect	通过 OAuth 或令牌将 Claude Code 连接到 Dregs MCP 服务，并使用 get_account_summary 验证连接。
setup	引导你将 Dregs 完整集成到应用中，检查现有内容，并询问要处理哪些部分。
setup-tracking	添加 dregs.js 代码片段、在注册和登录时调用 dregs.identify()，并为关键操作调用 dregs.track()，然后验证事件是否已送达。
setup-events	使用适用于你所用语言的官方 Dregs SDK 发送服务端事件，并将你的事件名称和身份字段映射到 Dregs 的规范类型。
setup-webhooks	构建经过签名验证的 webhook 接收器，并针对评分和升级事件配置初步响应，然后验证投递情况。
health-check	只读诊断集成情况：数据接收、身份识别、映射、分析器观察结果和限制。
investigate-identity	追踪一个身份从评分到观察结果、历史记录、关联、设备和事件，并得出结论。
investigate-cluster	根据共享设备、IP 和会话，绘制相关账户关联图，并列出各成员的证据。
tune-rules	编写或调整徽章和升级规则，预览其影响，并在写入前征求确认。
weekly-review	只读账户健康检查：用量、评分分布、规则活动、待处理的升级事件和使用情况。

集成技能会编辑你的代码，因此需要具备代码库访问权限的客户端，例如 Claude Code 或 Codex。其他技能可在连接了服务的任何环境中使用。

将 Claude Desktop 和 claude.ai 连接到 Dregs

Claude Desktop 和 claude.ai 通过自定义连接器连接远程 MCP 服务，这些连接器使用 OAuth。

1. 打开 设置 → 连接器，然后选择 添加自定义连接器。
2. 输入名称和 URL https://dregs.com/mcp。
3. 选择 连接，并在浏览器打开时批准 Dregs OAuth 连接。
4. 在对话中打开工具菜单，并启用 Dregs 连接器。

将 ChatGPT 和 Codex 连接到 Dregs

网页版 ChatGPT 通过 开发者模式（设置 → 安全和登录）中创建的插件进行连接。打开 插件，使用 URL https://dregs.com/mcp 添加连接，然后在新对话中从工具 菜单添加该插件，并批准 OAuth 连接。

ChatGPT 桌面应用中的 Codex、Codex CLI 和 Codex IDE 扩展共用一份配置：

codex mcp add dregs --url https://dregs.com/mcp
codex mcp login dregs

或者在 ~/.codex/config.toml 中使用 MCP 令牌：

[mcp_servers.dregs]
url = "https://dregs.com/mcp"
bearer_token_env_var = "DREGS_MCP_TOKEN"

将 Cursor 连接到 Dregs

也可以将其添加到项目中的 .cursor/mcp.json（或添加到 ~/.cursor/mcp.json 以用于所有项目），并在 Cursor 首次连接时批准 OAuth 连接：

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

若要改用 MCP 令牌，请添加 "headers": { "Authorization": "Bearer ${env:DREGS_MCP_TOKEN}" }，并在启动 Cursor 前 在环境中设置 DREGS_MCP_TOKEN。

将 VS Code 连接到 Dregs

也可以从命令面板运行 MCP: Add Server，或将其添加到 .vscode/mcp.json：

{
  "servers": {
    "dregs": {
      "type": "http",
      "url": "https://dregs.com/mcp"
    }
  }
}

要使用 MCP 令牌，请声明一个 "password": true 的 promptString 输入，并在 Authorization 标头中引用它。手册中有完整示例。

将其他 MCP 客户端连接到 Dregs

任何支持通过 Streamable HTTP 连接远程服务的客户端都可以采用相同方式连接。对于仅支持本地（stdio）服务的客户端， 通常可以使用 mcp-remote 桥接工具。省略 --header 参数即可改用 OAuth 流程，而不是使用令牌：

{
  "mcpServers": {
    "dregs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://dregs.com/mcp", "--header", "Authorization: Bearer YOUR_TOKEN"]
    }
  }
}

Agent 可以使用 Dregs 做什么

该服务提供 Dregs 仪表板中的调查和规则调优功能。客户端连接时会获取实时工具列表， 因此，下表仅展示功能概况，并非权威来源。

分组	工具
账户与仪表板	get_account_summary, dashboard_stats, dashboard_score_distribution, dashboard_rule_activity, get_documentation
身份与事件	list_identities, get_identity, get_identity_analysis, get_identity_history, get_identity_links, search_events, analyze_identity, set_identity_disregarded
组	list_groups, get_group
设备	list_devices, get_device
升级处理	list_escalations, get_escalation, escalation_summary, update_escalation_status
升级规则	list_escalation_rules, get_escalation_rule, preview_escalation_rule, create_escalation_rule, update_escalation_rule, delete_escalation_rule
徽章规则	list_badge_rules, get_badge_rule, create_badge_rule, update_badge_rule, delete_badge_rule
通知渠道	list_channels, get_channel, list_channel_deliveries, test_channel
数据集与映射	list_datasets, list_dataset_entries, add_dataset_entry, remove_dataset_entry, list_mappings, set_mapping, delete_mapping

所有团队成员均可执行读取操作。写入操作遵循你的仪表板角色：创建、更改或删除规则、忽略某个身份、重新评分、测试渠道，以及编辑数据集或映射都需要管理员角色。 有些操作特意留给人工处理。Agent 无法创建或编辑通知渠道及其密钥、管理你的团队、凭据或账单，也无法删除身份或事件，或更改 Dregs 的评分方式。它负责调查、提出建议并交接处理。

每个工具都带有 MCP 注解（readOnlyHint、destructiveHint、idempotentHint、openWorldHint），因此，支持这些注解的客户端可以在执行写入和删除操作前进行提示。

服务端 SDK

将数据导入 Dregs 与将 Agent 连接到它是两项独立的工作，并且官方为五种服务端语言分别提供了 SDK。这些 SDK 支持发送事件、读取包含评分的身份信息或完整分析、请求重新评分，以及验证 webhook 签名；它们针对不同状态提供类型化错误，并内置了带退避机制的重试。请优先使用 SDK，而不是手动编写 HTTP 客户端；插件的 setup-events 技能就是这样做的。

语言	软件包	安装	最低要求	源码
Python	PyPI 上的 dregs	pip install dregs 或 uv add dregs	Python 3.10	dregs-sdk-python
TypeScript	npm 上的 @dregs/sdk	npm install @dregs/sdk	Node 20	dregs-sdk-typescript
Java	Maven Central 上的 com.dregs:dregs-sdk	添加 Gradle 或 Maven 坐标	Java 17	dregs-sdk-java
Ruby	RubyGems 上的 dregs	bundle add dregs	Ruby 3.1	dregs-sdk-ruby
PHP	Packagist 上的 dregs/dregs-sdk	composer require dregs/dregs-sdk	PHP 8.2	dregs-sdk-php

这些 SDK 仅供服务端使用，并使用凭证的密钥（sk_…）作为 bearer token 进行身份验证。浏览器跟踪仍通过带公钥（pk_…）的 dregs.js 脚本实现。在 npm 上，dregs 这个不带作用域的包是浏览器脚本，而不是 SDK；服务端 SDK 是 @dregs/sdk。

AI 欺诈审核的安全实践

• 数据由被评分的人写入。 身份属性、显示名称和事件负载都是用户输入，恶意行为者可能会在其中加入针对 Agent 的文本。服务端会告知 Agent，应将其返回的所有内容都视为数据，而非指令。阅读 Agent 的结论时，也请牢记这一点。
• Agent 会在你的账户中执行操作。 规则变更和忽略身份会影响整个团队的评分和升级处理。请先请求预览（preview_escalation_rule 会报告某条规则目前会对多少个身份触发处理），并在批准提议的变更前进行审核。
• 限定访问范围。 每个 Agent 或设备使用一个令牌，为令牌设置清晰的名称，并撤销不再使用的令牌。请在 设置 → AI Agents 下审核 OAuth 连接。

支持

• 设置帮助和问题：[email protected]
• 安全问题：请参阅 SECURITY.md
• 有关此仓库内容（README、插件或目录元数据）的问题：请在此处提交 issue

此仓库包含的内容

路径	用途
server.json	Dregs 在官方 MCP Registry中的条目
glama.json	Glama列表的维护者元数据
chatgpt-app-submission.json	提交至 ChatGPT 插件目录的工具注释、理由和测试用例
.claude-plugin/、.mcp.json、skills/	Claude Code 插件及其市场清单
.github/workflows/	每次推送时进行验证，并在发布时发布到注册表

发布新版工具界面

发布后，工具界面就是一套公共 API。更改时：同时更新 server.json、.claude-plugin/plugin.json 和 .claude-plugin/marketplace.json 中的 version，更新上方的工具表格，并在新增或重命名工具时更新技能，然后创建 vX.Y.Z 标签并发布 GitHub Release。publish-registry 工作流会在发布时将 server.json 推送到 MCP Registry。

许可证

此仓库的内容依据 MIT License 发布。Dregs 服务本身受 Dregs 服务条款约束。