主题
本地 AI 助手连接与权限
了解 MaskPilot 本地 MCP 的连接配置、Bearer Token、AI 助手权限与操作边界,以及连接、令牌或工具调用失败时的排查顺序。
6 篇内容MaskPilot 通过本地 MCP 把当前客户端允许的能力提供给 AI 调用方。服务默认只监听本机地址,调用方和 MaskPilot 客户端需要运行在同一台电脑上。
建立本地连接
先登录客户端并开启 MCP,再把当前 Bearer Token 配置到调用方。工具列表由当前客户端版本决定;更换账号或成员权限不会筛掉列表项,但会影响工具调用能否执行。
权限跟随当前账号
AI 调用不会绕过团队权限。成员只能使用当前登录账号已经获得的能力;缺少账号分配或功能权限时,应由所有者检查成员设置,而不是反复更换工具名。遇到 MCP permission required 时,按账号与团队权限排查步骤区分当前账号、目标资源权限和连接归属。
保护令牌并按顺序排查
不要把 Token 写入公开文档、截图或日志。连接失败时依次检查客户端是否运行、是否已登录、MCP 开关、本地地址与调用方配置;无效令牌应重新读取当前 Token,未知工具则应核对当前客户端版本和返回的工具名。
主题
本主题内容
使用指南
常见问题
01
AI 助手 · 问答 MCP 本地连接被拒绝怎么办?
→ 02 按健康检查、监听地址、调用方环境和访问令牌逐层定位 MaskPilot 本地 MCP 连接失败。
AI 助手 · 问答 MCP 无效令牌如何处理?
→ 03 重新核对 MaskPilot MCP 当前 Token、Bearer 认证、环境变量和调用方进程,在恢复连接的同时避免凭据进入日志。
AI 助手 · 问答 MCP 未知工具如何处理?
→ 04 以当前客户端返回的工具列表为准,检查工具名和客户端版本,并区分后续调用的权限拒绝。
AI 助手 · 问答 MCP 权限不足怎么办?
→ 遇到 MCP permission required 时,区分 MaskPilot 账号权限、登录状态、访问令牌和目标资源权限,恢复被拒绝的本地 AI 自动化调用。