跳转到主要内容
plugin 可以包含 MCP 服务器 (例如问题跟踪器) ,这样每个安装该 plugin 的人都能获得相同的服务器配置,无需从零开始设置。安装后,你需要提供该服务器所需的凭据,例如 API 密钥或 OAuth 登录。连接可以是个人连接,也可以是共享连接,具体取决于 plugin 的安装位置以及该安装的 Access 设置。

声明方式

在根目录的 .mcp.json 中,以 mcpServers 映射的形式声明服务器。清单中的内联 mcpServers 字段使用相同的映射,只是不需要外层包装。
占位符。 url 或 headers 中的 ${NAME} 由安装者在服务器的 Connect 面板中填写。${NAME:-default} 用于在未保存任何值时提供回退值。plugin 服务器只读取其安装中保存的值,不会读取同名的会话 secrets。切勿在声明中写入真实令牌:声明内容会按原样存储。 服务器也可以改为运行本地命令 (command、args、env) ;这种情况下不使用上述任何 HTTP 凭据字段。
MCP 服务器页面介绍了独立服务器的 Customize 表单。plugin 中的服务器使用上述字段名称,其 URL、传输和标头会在已安装的条目行中以只读方式显示。

凭据由谁持有

配置

每种配置都将上述声明中的一个条目与plugin的安装位置和分发方式组合在一起:必填 会为作用域内的所有人安装该plugin,Offered 则允许各组织或成员自行安装。这两种方式均在 Customize 中针对该plugin进行设置。

  1. 为所有人启用用户级 OAuth

对于支持 OAuth 的服务器,请使用 example-mcp 条目,并在企业或组织级别将该 plugin 安装为必填。 tokenScope: "user" 会将 Access 默认设为个人,因此每位成员只需登录一次:可以在 Customize → MCPs 中登录,也可以在首个需要该服务器的会话中登录。

  1. 单个组织服务账号

使用 example-mcp-service-account 条目,并在组织级别安装该 plugin。
  • Authorization 标头中填的是占位符,因此该行显示 Connect。令牌由组织管理员填写,成员始终看不到。
  • 如果服务器拒绝该令牌 (401) ,该行会显示 Check the credential。如果服务器同时支持 OAuth,该行还会额外显示 Sign in with OAuth instead。
  • 如果服务账号通过 OAuth 登录,请删除该标头,设置 tokenScope: "org",然后关联该账号的登录信息。

  1. 每个组织一个密钥

将 example-mcp-service-account 条目放入企业 plugin,并将其设置为 Offered to organizations。
  • 每个安装该 plugin 的组织都拥有各自的安装实例,因此由该组织的管理员将本组织的密钥填入 ${EXAMPLE_MCP_SERVICE_ACCOUNT_TOKEN}。
  • 企业层面不建立任何连接,各组织之间也无法看到彼此的密钥。
  • 如果企业 plugin 设置为 必填,则只会创建一个归企业所有的安装实例,即所有组织共用一个密钥。

  1. 在一个 plugin 中同时提供两者

按照上文声明的方式同时提供这两个条目,然后发布该 plugin。每个安装该 plugin 的组织都会获得两行:一行供成员登录,另一行由组织管理员连接。为两者设置不同的服务器名称后,plugin 中的技能便可指明应使用哪个服务器。