> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Devin 中的 plugin MCP 服务器

> 在 Devin plugin 中声明 MCP 服务器，并决定由谁持有凭据：各成员、组织服务账号或企业。

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

## 声明方式

在根目录的 `.mcp.json` 中，以 `mcpServers` 映射的形式声明服务器。清单中的内联 `mcpServers` 字段使用相同的映射，只是不需要外层包装。

```json theme={null}
{
  "mcpServers": {
    "example-mcp": {
      "url": "https://mcp.example.com/mcp",
      "tokenScope": "user"
    },
    "example-mcp-service-account": {
      "url": "https://mcp.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${EXAMPLE_MCP_SERVICE_ACCOUNT_TOKEN}"
      }
    }
  }
}
```

| 字段 | 类型 | 作用 |
| - | - | - |
| `url` | string | 服务器的端点。必填。 |
| `transport` | string | 旧版 SSE 端点请设为 `"sse"`。使用可流式传输的 HTTP 时省略此字段。 |
| `headers` | object | 随每个请求发送的 HTTP 标头。值中可包含占位符。 |
| `oauthClientId` | string | pre-registered 的 OAuth 客户端，适用于不支持动态客户端注册的提供商。设置此项后，无论标头如何配置，该服务器都会使用 OAuth。 |
| `oauthClientSecret` | string | plugin 中不接受此字段：包含它的声明会被拒绝。由执行安装的管理员在服务器设置中输入该 secret。 |
| `oauthScopes` | string\[] | 要请求的作用域。需同时设置 `oauthClientId`。 |
| `oauthResource` | string | 覆盖 RFC 8707 的 `resource` 参数 (默认值：服务器 URL) 。设为 `""` 时省略该参数；其他任何值都必须能标识此服务器。 |
| `tokenScope` | string | 在组织或企业级别安装 OAuth 服务器时的默认 **Access**：`"user"` (每个成员各自登录) 或 `"org"` (使用同一个共享连接) 。未设置时，采用 MCP Marketplace 条目的作用域；若条目也未指定，则使用共享连接。每次协调该 plugin 时都会重新应用声明的值。个人安装始终使用成员自己的连接。 |
| `disabled` | boolean | 设为 `true` 时跳过该服务器。 |
| `disabledTools` | string\[] | 此服务器上对 Devin 隐藏的工具名称。 |
| `description` | string | 在 Customize 中随服务器一同显示。 |

**占位符。** `url` 或 `headers` 中的 `${NAME}` 由安装者在服务器的 Connect 面板中填写。`${NAME:-default}` 用于在未保存任何值时提供回退值。plugin 服务器只读取其安装中保存的值，不会读取同名的[会话 secrets](https://docs.devinenterprise.com/zh/product-guides/secrets.md)。切勿在声明中写入真实令牌：声明内容会按原样存储。

服务器也可以改为运行本地命令 (`command`、`args`、`env`) ；这种情况下不使用上述任何 HTTP 凭据字段。

> [!NOTE]
>
> [MCP 服务器](https://docs.devinenterprise.com/zh/work-with-devin/mcp.md#configuration-format)页面介绍了独立服务器的 Customize 表单。plugin 中的服务器使用上述字段名称，其 URL、传输和标头会在已安装的条目行中以只读方式显示。

## 凭据由谁持有

| 安装方 | 凭据归属 | 由谁连接 |
| - | - | - |
| 成员 (个人范围) | 该成员 | 该成员，在 Customize → MCPs 中连接 |
| 组织 | 组织 (`Access: Organization`) 或每位成员 (`Access: Personal`) | 组织管理员或每位成员 |
| 企业 | 企业 (`Access: Enterprise`) 或各组织中的每位成员 (`Access: Personal`) | 企业管理员或每位成员 |

## 配置

每种配置都将上述声明中的一个条目与plugin的安装位置和分发方式组合在一起：**必填** 会为作用域内的所有人安装该plugin，**Offered** 则允许各组织或成员自行安装。这两种方式均在 [Customize](https://docs.devinenterprise.com/zh/product-guides/plugins.md#mcps) 中针对该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 设置为 **必填**，则只会创建一个归企业所有的安装实例，即所有组织共用一个密钥。

### 在一个 plugin 中同时提供两者

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.