MCP 权限控制

更新时间:
复制 MD 格式

MCP 工具通常包含查询、写入、删除等不同操作,让所有用户和 Agent 默认拥有相同的调用权限并不安全。通过 MCP 权限控制,可以在 AgentCore 控制台按授权规则为 Workspace 中的用户或 Agent 配置可调用的 MCP 工具范围。

功能介绍

MCP 权限控制用于管理 Workspace 中的用户或 Agent 可以调用哪些 MCP 工具。对于包含查询、写入、删除等不同操作的 MCP,可以按使用者配置不同的工具范围,避免所有用户和 Agent 默认拥有相同权限。

MCP 支持以下权限模式。

权限模式说明
公开不限制用户、Agent 和工具范围。适用于无需单独配置调用权限的 MCP。
权限控制根据授权规则控制用户或 Agent 可以调用的工具。没有授权规则时,所有用户和 Agent 都无法调用该 MCP。

权限控制支持以下授权对象。

授权对象说明
用户为当前 Workspace 中的一个或多个用户配置 MCP 工具权限。
Agent为当前 Workspace 中的一个或多个 Agent 配置 MCP 工具权限。

每条授权规则可以选择以下工具范围。

工具范围说明
全部工具允许授权对象调用当前 MCP 的全部工具。MCP 后续新增的工具也包含在授权范围内。
指定工具仅允许授权对象调用所选工具。适用于需要区分查询、写入、删除等操作权限的场景。

使用须知

开始操作前,请了解以下约束。

重要

选择 全部工具 后,授权范围会自动包含该 MCP 后续新增的工具。如果只希望授权当前明确允许的工具,请选择 指定工具。

重要

将权限模式修改为 公开 后,已有授权规则会继续保留,但不再参与访问控制。再次切换回 权限控制 模式时,请检查已有规则是否仍符合当前业务要求。

重要

删除最后一条授权规则后,MCP 仍保持 权限控制 模式,所有用户和 Agent 都无法调用该 MCP,系统不会自动切换为 公开。

前提条件

开始配置前,请确保满足以下条件:

  • 已在当前 Workspace 中创建 MCP 工具,且状态为可用。具体操作,请参见管理 MCP 工具。

  • MCP 工具列表可以正常读取。配置指定工具权限时,只能选择该 MCP 已发现的工具。

  • 为用户授权时,已在当前 Workspace 中创建或同步用户。具体操作,请参见管理用户。

  • 为 Agent 授权时,目标 Agent 已创建且状态正常。

设置权限模式

  1. 登录 AgentCore 控制台。

  2. 进入目标 Workspace。

  3. 在左侧导航栏选择 资产管理 > 工具管理。

  4. 在 我的工具 页签找到目标 MCP,单击 详情。

  5. 在工具详情页,进入权限配置区域。

  6. 将权限模式选择为 公开 或 权限控制。

  7. 单击 保存。

添加授权

  1. 参照设置权限模式的步骤 1~5,进入目标 MCP 的权限管理页面。

  2. 确认权限模式为 权限控制。

  3. 单击 添加授权。

  4. 配置以下参数。

    参数说明
    主体类型选择 用户 或 Agent。
    授权主体主体类型为用户时,选择当前 Workspace 中的用户;主体类型为 Agent 时,选择当前 Workspace 中的 Agent。
    工具范围选择 全部工具 或 指定工具。
    指定工具工具范围为指定工具时,从当前 MCP 的工具列表中选择允许调用的工具。
  5. 单击 确定。

授权完成后,规则列表会展示已添加的授权规则。

查看授权

进入目标 MCP 的权限管理页面,可以查看已有授权规则,也可以在搜索框中输入用户名称或 Agent 名称筛选授权记录。规则列表包括以下信息:

  • 主体类型

  • 主体名称

  • 工具范围

  • 已授权的指定工具

删除授权

  1. 参照设置权限模式的步骤 1~5,进入目标 MCP 的权限管理页面。

  2. 找到目标授权规则,单击 删除。

  3. 在确认对话框中单击 确定。

相关文档