MCP 访问权限由已认证钱包、获授权限范围以及域名或 Bag 限制共同决定。
权限范围组
| 权限 | 允许的操作 |
|---|---|
wallet:read | 读取钱包所有者/执行者上下文 |
sites:read, deployments:read | 查看网站、内容、版本和历史 |
sites:write | 发布并管理获准的关联 |
sites:rollback, sites:delete | 恢复或删除符合条件的网站 |
dns:read, subdomains:read | 读取受支持的名称、条目和控制状态 |
storage:read | 查看 Bag、提供商、报价和操作 |
storage:write, storage:delete | 创建、导入或移除平台 Bag 引用 |
media:write | 上传模板图片 |
transactions:request | 准备手动钱包确认 |
mcp:read, mcp:revoke | 查看访问/审计记录或撤销授权 |
资源限制
域名允许名单使用完整名称,并保留 .ton 和 .t.me 命名空间。父名称不代表对所有子名称的通配授权。Bag 限制适用于确切的 BagID。
资源限制也会筛选工具返回的列表。
到期和刷新
访问令牌有效期为 15 分钟,通常由客户端刷新。标准权限范围的授权及刷新访问最长为 30 天;包含敏感权限范围时为 24 小时。敏感范围包括交易请求、回滚、网站/Storage 删除和撤销授权。
客户端通常自动刷新访问权限。授权到期或被撤销后,需要重新登录。
撤销访问
使用 mcp.access.list 查看当前授权和会话。使用确切的确认标识符撤销目标授权。撤销当前授权可能会阻止通过同一连接继续读取。
审计工具显示客户端请求的脱敏事件和摘要。
连接问题
收到未认证响应时,让客户端刷新令牌;如果授权已到期或撤销,则重新登录。对于禁止访问的资源,检查已授予的权限范围及完整名称或 Bag 限制。
工具列表中缺失的资源可能被这些限制排除。