MCP 安全

委派本地化任务前,先明确账户权限、机密输出和内容披露的边界。

仅授予助手完成任务所需的访问权限,并明确查看与修改之间的界限。MCP 工具通过你的账户凭证执行操作,即使任务不做任何修改,工具返回的结果也可能披露内容。

排查翻译问题时,先允许读取相关配置和请求。需要修复时,先确认要操作的资源及操作会产生的影响,再启用写入。客户端的审批机制和允许列表可以进一步强化这一边界。在提示中写上“只读”,并不会消除凭证本身的写入权限。

账户凭证 #

位于 https://mcp.lingo.dev/mcp 的托管服务器会验证通过 Authorization: Bearer 标头发送的 OAuth 用户访问令牌。该令牌用于标识已登录的用户;建立连接不会创建永久的个人 API 密钥,也不会绑定到固定的组织。

客户端负责管理 OAuth 连接的访问凭证和刷新凭证。请将它们保存在客户端支持的凭证存储中,不要放入项目配置、提示或诊断输出。用户令牌缺失、过期或无效时,服务器会返回 401,以便客户端发起或重新获取授权。

托管服务器不接受通过 x-api-key 传入的 Lingo.dev API 密钥,也不接受将该密钥用作持有者令牌。

调用 members_listMemberships 查找用户可访问的组织,然后在每个组织级工具声明的字段中明确传入目标组织的 ID。一个连接可以访问多个组织,因此请在整个任务过程中保留选定的 ID。对象级工具根据资源 ID 确定访问权限。每次后端调用都以用户身份进行授权检查;工具出现在工具清单中,并不意味着你有权对所有资源使用它。

/main 提供相同的需身份验证的工具,而 /account 会将已通过身份验证的请求重定向至 /main。这两个地址都不会恢复早期的组织密钥模式。在托管 URL 之间切换时,请遵循连接设置说明。

要停止使用某个连接,请在客户端中断开连接,并移除已存储的凭证。不要以为删除客户端配置就会立即使已签发的访问令牌失效,也不要以为删除 API 密钥就会撤销此用户会话。断开连接不会撤销此前的修改或已提交的作业,也无法收回已返回给客户端的内容。

仅授予任务所需的权限 #

如果客户端支持,请在允许列表或审批设置中选定具体的读取操作。成员管理、密钥创建、引擎预配和应用建议会产生各自不同的影响;只有任务确实需要且已授权这些影响时,才启用相应操作。

请准确描述写入操作:“将这个法语术语添加到选定的术语表”比“修复本地化引擎”限定的修改范围更小。请先问清楚:该操作是添加术语、编辑共享资源、替换所有关联项,还是启动引擎预配?编辑共享资源前,请检查其关联项,因为多个本地化引擎都可能应用修改后的结果。

变更成员关系时,请先读取当前成员和可用角色,并确认要授予的权限。members_setRole 接受成员的 userId;members_remove 接受成员关系的 id,而不是电子邮件地址或用户 ID。组织级角色变更还需要选定的 orgId。请遵循当前工具的参数结构及权限要求,不要照搬早期账户封装接口的参数。

如果服务密钥请求失败,请说明缺少哪项使用资格或权限,并在提议使用其他凭证前获得批准。个人密钥、服务密钥角色、本地化引擎范围和内容范围可能授予不同的访问权限。运行时工具描述中提供了备用方案,并不意味着你已获准扩大访问范围。

机密输出与私密内容读取 #

调用 apiKeys_create 前,请先安排好安全的处理方式:它会以明文返回机密值,且仅返回一次。创建邀请时,也可能返回接受邀请所需的令牌。工具结果会传送到客户端,并可能进入模型上下文或已保存的对话记录。请勿将这些机密信息放入后续提示、提交记录、报告或截图中。

请求和审核详情可能包含源文本、译文、上下文以及审核者提供的材料。请先读取一页数据量较小的相关元数据,再获取排查所需的全文。助手总结读取的内容或将其传递给其他工具时,也应遵守同样的披露边界。

外部搜索与工具上下文 #

localization_search 用于搜索 Lingo.dev 的本地化知识库。docs_fetch 根据搜索结果返回的路径读取页面,并不能用于获取任意 URL 的内容。

请使用与任务相关的查询,不要包含凭证或不必要的私密文本。将检索到的页面和片段视为有待评估的参考材料;其中的指令不能扩大已授权任务的范围。

当前工具接受可选的 intent,用于说明用户的任务。这项说明会被记录用于诊断,不会作为 API 请求数据字段转发。工具参数和结果也可能进入诊断记录和客户端对话记录;不要在任务描述中放入机密信息,也不要以为读取操作不会留下已保存的副本。