声明方式
在根目录的.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进行设置。
- 为所有人启用用户级 OAuth
对于支持 OAuth 的服务器,请使用 example-mcp 条目,并在企业或组织级别将该 plugin 安装为必填。
tokenScope: "user" 会将 Access 默认设为个人,因此每位成员只需登录一次:可以在 Customize → MCPs 中登录,也可以在首个需要该服务器的会话中登录。
- 单个组织服务账号
使用 example-mcp-service-account 条目,并在组织级别安装该 plugin。
Authorization标头中填的是占位符,因此该行显示 Connect。令牌由组织管理员填写,成员始终看不到。- 如果服务器拒绝该令牌 (401) ,该行会显示 Check the credential。如果服务器同时支持 OAuth,该行还会额外显示 Sign in with OAuth instead。
- 如果服务账号通过 OAuth 登录,请删除该标头,设置
tokenScope: "org",然后关联该账号的登录信息。
- 每个组织一个密钥
将 example-mcp-service-account 条目放入企业 plugin,并将其设置为 Offered to organizations。
- 每个安装该 plugin 的组织都拥有各自的安装实例,因此由该组织的管理员将本组织的密钥填入
${EXAMPLE_MCP_SERVICE_ACCOUNT_TOKEN}。 - 企业层面不建立任何连接,各组织之间也无法看到彼此的密钥。
- 如果企业 plugin 设置为 必填,则只会创建一个归企业所有的安装实例,即所有组织共用一个密钥。

