内容
# 桌面工作台 — MCP 服务器
> 代理原生帮助台。AI 代理通过 MCP 运行真实的支持工作,并通过 [x402](https://x402.org) 按操作付费(使用 USDC)—— 无需账户,无需 API 密钥。
[](https://glama.ai/mcp/connectors/io.deskcrew/desk-crew)
· [](https://smithery.ai/servers/deskcrew/support)
· MCP 注册表: **`io.deskcrew/support`** · [deskcrew.io](https://deskcrew.io)
DeskCrew 是一个为 AI 代理构建的多租户支持帮助台。人类拥有一个正常的仪表板、共享收件箱和电子邮件 —— 代理拥有一个付费的 MCP 门户。一个代理通过模型上下文协议连接,列出可用的工具,并运行真实的支持工作:搜索和创建工单,搜索知识库,草拟和发布回复,分类和解决线程 —— 在 USDC 中按操作付费。
## 连接
远程、可流式传输的 HTTP MCP 端点(无需安装):
```
https://deskcrew.io/api/mcp/{tenant}
```
客户端配置(Claude Desktop、Cursor 或任何 MCP 客户端):
```json
{
"mcpServers": {
"deskcrew": {
"type": "streamable-http",
"url": "https://deskcrew.io/api/mcp/YOUR_TENANT_SLUG"
}
}
}
```
测试公共演示租户 —— `initialize` 和 `tools/list` 是免费的:
```bash
curl -s https://deskcrew.io/api/mcp/deskcrew \
-H 'content-type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```
## 按操作付费(x402)
读取工具是 **免费** 的。操作工具是 **定价** 的:当代理调用一个工具时,服务器会以 `HTTP 402` 回复,并附上付款要求(USDC 中的金额 + 每个接受的网络)。代理支付并重试相同的调用,附带 `X-PAYMENT` 头 —— [x402](https://x402.org) 标准。无需账户,无需 API 密钥,无需人工干预。
结算是在 **Base、Polygon、Avalanche、Sei 和 Solana** 上的 USDC 中进行。条款在以下网址公布:
- `https://deskcrew.io/.well-known/x402` —— 平台发现
- `https://deskcrew.io/api/mcp/{tenant}/manifest` —— 每个租户的条款
## 工具
| 工具 | 级别 | 价格 |
|---|---|---|
| `search_kb` · `list_issues` · `list_changelog` | 读取 | 免费(匿名) |
| `list_tickets` · `search_tickets` | 读取 | 免费 —— **需要 API 密钥** (私有工单数据) |
| `get_ticket_context` | 读取 | $0.02 |
| `create_ticket` · `create_issue` | 草拟 | $0.02 |
| `triage` · `link_issue` | 草拟 | $0.03 |
| `draft_reply` · `propose_resolution` | 草拟 | $0.06 |
| `assign` · `resolve` · `send_reply` | 发送 | $0.06 |
发送级别的工具会降级为草拟(存入人工审批队列),直到付费钱包获得信任声誉 —— 因此,匿名代理无法在第一天向您的客户发送电子邮件。
## 管理您自己的内容(身份验证)
匿名的每个租户门户(`/api/mcp/{tenant}`)仅限读取/草拟 —— 它故意 **无法写入您的知识库或变更日志**,因此,通过提示注入的陌生人无法编辑您的文档。内容写入在一个单独的 **身份验证** 端点上进行:
```json
{
"mcpServers": {
"deskcrew": {
"type": "streamable-http",
"url": "https://deskcrew.io/api/mcp",
"headers": { "Authorization": "Bearer mcp_your_credential" }
}
}
}
```
在仪表板中铸造 `mcp_` 凭证 → **代理**,然后在其上启用内容工具(将 `create_kb` / `update_kb` / `create_changelog` 设置为 `draft` —— 默认情况下它们不会被授予)。这会在读取工具旁边解锁三个写入工具:
| 工具 | 输入 |
|---|---|
| `create_kb` | `title` (必填,≤200 个字符)· `body` (必填,Markdown,≤50k 个字符)· `status` (可选:`draft` | `published`,默认为 `draft`) |
| `update_kb` | `id` (必填,必须属于您的租户)· `title` / `body` / `status` (均为可选 — 发送至少一个) |
| `create_changelog` | `title` (必填,≤200 个字符)· `body` (必填,Markdown,≤50k 个字符)· `status` (可选:`draft` | `published`,默认为 `draft`) |
只有 **发布的** 知识库文章才会被代理检索;发布变更日志条目会触发 `changelog.published` 网络钩子。
### REST 等价项
更喜欢普通的 HTTP?在仪表板中铸造一个 `dk_` API 密钥 → **API 密钥**,并赋予所需的范围 —— `kb:read`、`kb:write`、`changelog:write` —— 然后访问:
- `GET` / `POST` `https://deskcrew.io/api/v1/kb`
- `GET` / `PATCH` / `DELETE` `https://deskcrew.io/api/v1/kb/:id`
- `GET` / `POST` `https://deskcrew.io/api/v1/changelog` · `GET` / `PATCH` / `DELETE` `…/changelog/:id`
```bash
curl -X POST https://deskcrew.io/api/v1/kb \
-H "Authorization: Bearer dk_your_key" \
-H "Content-Type: application/json" \
-d '{"title":"Getting started","body":"Write your article here.","status":"published"}'
```
与 MCP 工具相同的字段限制。`mcp_` 和 `dk_` 是独立的凭证家族 —— API 密钥无法打开 MCP 门户,反之亦然。
## 它如何组合在一起
人类和代理在同一个工作台工作。人类在仪表板中审查工单并通过电子邮件回复;代理访问 MCP 门户,按调用付费,其草拟内容会进入同一个审批队列。管理员发布的知识库同时回答人类访客(通过可嵌入的小部件)和为代理工具提供基础。
## 链接
- 首页 — https://deskcrew.io
- MCP 注册表 — `io.deskcrew/support`
- x402 清单 — https://deskcrew.io/.well-known/x402
- llms.txt — https://deskcrew.io/llms.txt
## 许可证
此存储库的内容 —— 技能、示例配置和此文档 —— 在 [MIT License](./LICENSE) 下发布。您可以复制、修改和分发它们。
这仅涵盖此存储库。DeskCrew 本身是一个托管的商业服务,由其自身的条款管辖,网址为 https://deskcrew.io,而“DeskCrew” 是其所有者的商标。连接到该服务仍然需要一个账户(免费账户足够)或 x402 付款。