MCP 常见问题

高频问答

Q 客户端里看不到希爱设计的工具？

先确认 MCP 服务器地址、令牌粘贴无误，客户端重启后会重新拉取工具列表。本地模式还要确认启动命令与运行环境正常，查看客户端的 MCP 日志中是否有启动报错。

Q 显示已连接，但 AI 说找不到文件或画板？

智能体操作的是当前活动标签页打开的文件。请确认目标文件已在浏览器中打开且标签页处于活动状态，必要时刷新页面后重新建立连接。

Q AI 生成的元素没有使用团队组件？

在提示词中明确给出组件库名称与组件名（例如「使用基础组件库中的 button/primary」），并确认该文件已启用对应的共享库。

Q 生成结果不符合预期怎么办？

把大任务拆成小步骤（先建画板、再放组件、最后填内容），并在每步后检查。已产生的改动可在历史面板中撤销，或直接关闭文件不保存后重新打开。

Q 自托管环境能用 MCP 吗？

可以。内网或对数据有要求的团队推荐使用本地 MCP 模式，在自有机器上运行服务器连接内部实例，数据不经过公网。

Q AI 会不会误改其他文件？

不会。操作范围限定在当前打开并授权的文件中；团队与文件权限同样对 MCP 生效，智能体无法访问未授权内容。

Q 连接频繁中断？

检查网络与代理是否放行 MCP 通信地址，保持浏览器标签页不要休眠；本地模式下检查命令行进程是否仍在运行，被系统挂起后重新启动即可。