连接您的 AI 助手
将 Claude、ChatGPT 或其他 MCP 客户端连接到您的客户门户。助手可以读取您的项目、发票、支持工单、网站状态和文件。在 Pro 和 Ultra 套餐中，它还可以开启工单或发送变更请求，但只有在您确认准确的预览后才会执行。
工具与限制
每个套餐都有自己的限制。服务器会对每个客户端密钥执行密钥数量和每分钟请求数限制，并对整个账户执行每月单位限制。
基础版 (Basic)
免费仅读取。此套餐不支持写入
查看项目、账单、工单、站点状态、项目文件及月度报告。
专业版 (Pro)
每月 3,000,000 托曼读取和确认后的写入
所有读取工具，以及经确认的写入：开启和回复支持工单、提交变更请求和 Farr 消息、上传文件、创建和更新内容草稿，以及接受或拒绝提案。每项写入都会先显示预览，只有在您同意后才会执行。
旗舰版 (Ultra)
每月 5,000,000 托曼包含 Pro 的全部功能，并支持批量操作和 Webhook
包含 Pro 的全部功能，并增加工单批量操作（bulk_ticket_reply、bulk_ticket_close 和 bulk_actions，每次调用最多 20 张工单）、Webhook（webhook_list、webhook_create 和 webhook_delete）以及定时月度报告（scheduled_reports 和 scheduled_reports_get）。
安全机制：无支付或所有权操作
助手 API 不包含任何支付账单、转移资金、修改账户所有权或管理密钥的工具。账单仅供只读查看，付款由您在客户门户中亲自完成。
如何创建助手密钥
只需三步即可在客户门户中创建密钥。
1. 登录客户门户
登录客户门户并在菜单中打开“助手访问权限”。
2. 创建密钥
点击“创建密钥”。输入 3 到 60 个字符的名称（例如“Claude Code - 笔记本”），选择权限范围及有效期。创建密钥需再次确认登录。
3. 立即复制密钥
完整密钥仅在创建后显示一次。服务器仅保存其机密部分的 SHA-256 哈希值。如若遗失，请注销后重新创建。
如何连接 Claude 与 ChatGPT
通过 MCP Streamable HTTP 传输协议连接，支持 Bearer 密钥或 OAuth 登录授权。
Claude Code 及其他 MCP 客户端
在支持服务器 URL 和请求头的工具中（例如 Claude Code 的 .mcp.json 文件），添加此配置并将占位符替换为您的密钥：
{
"mcpServers": {
"sajjad-portal": {
"type": "http",
"url": "https://sajjad.blog/api/client/mcp",
"headers": {
"Authorization": "Bearer <YOUR_AGENT_KEY>"
}
}
}
}ChatGPT 及 Web 助手
将此地址添加为自定义连接器，并在提示时完成登录授权 (OAuth)。此方式无需密钥。菜单名称可能因助手版本而异。
写入操作的“预览而后确认”机制
变更绝不会在第一次调用时直接生效。
当助手调用写入工具时，服务器会暂存该请求并返回预览内容及一个有效期为 10 分钟的一次性确认令牌。只有在助手征得您同意并使用该令牌调用确认工具后，变更才会正式执行。每个令牌仅可使用一次，且仅对创建它的密钥和账户有效。所有暂存写入均有日志记录。
已验证工具参考
客户端端点提供的主要工具，以及预览后使用的确认工具。不在您套餐内的工具会被拒绝，并返回 plan_required 消息。
| 工具名称 | 访问类型 | 功能说明 |
|---|---|---|
| projects_list | 只读 | 列出多达 50 个项目：代码、名称、状态、进度和交付日期。 |
| invoices_list | 只读 | 列出多达 25 张账单：包含到期日、总额、已付金额、余额和状态。使用 openOnly 仅查看待付账单。草稿和支付链接始终排除。 |
| tickets_list | 只读 | 列出多达 50 个支持工单：包含状态、优先级和最近回复时间。 |
| ticket_get | 只读 | 获取单个工单的消息记录（最多 100 条消息）。内部备注已排除。 |
| ticket_create | 需确认写入 | 拟定低或普通优先级的新工单。仅在您确认预览后创建。 |
| ticket_reply | 需确认写入 | 拟定对开启工单的回复。已关闭工单无法回复。仅在您确认后发送。 |
| change_request_create | 需确认写入 | 为您的项目拟定变更请求。仅在您确认预览后正式提交。 |
| site_status | 只读 | 展示绑定站点的域名状态、访客数与页面浏览量（24 小时和 7 天）、运行时间百分比及未解决错误数。数据来自最新遥测同步。 |
| files_list | 只读 | 列出项目存储中的文件，每页最多 100 个，可按文件夹筛选。 |
| file_link | 只读 | 为存储的文件生成下载链接。链接有效期为 15 分钟。 |
| report_monthly | 只读 | 获取月度报告摘要（最多回溯 12 个月）：项目进展、工单开闭情况、站点快照、应付账单及 15 分钟有效的 PDF 链接。 |
常见问题解答
关于客户助手、安全机制及使用限额的常见问题。
AI 助手可以自动支付或结清账单吗？
不可以。助手 API 中没有任何支付账单或转账资金的工具。账单仅供查询，付款需由您在客户门户中亲自完成。
当月度用量达到上限时会怎样？
每个套餐为整个账户提供每月单位额度。读取消耗 1 个单位，写入预览消耗 3 个单位。当账户当月用量达到套餐额度时，后续调用会在工具结果中返回 quota_exceeded 错误（HTTP 200，而非 429），直到 UTC 日历月切换。
如果助手密钥泄露，如何注销？
在客户门户中打开“助手访问权限”，选择“注销密钥”并确认。此后使用该密钥的所有请求都会立即被拒。通过 OAuth 连接的助手也可以在此页面解绑。
连接 ChatGPT 需要运行本地桥接程序吗？
不需要。服务端点是标准 HTTPS 地址：客户端通过 POST 发送 JSON-RPC 消息并接收 JSON 响应。云端托管的助手可直接连接，无需任何本地软件。
准备好启用您的专属助手了吗？
选择合适的方案立即开始，或登录客户门户创建助手密钥。