配置用户级凭证连接

用户级凭证是指管理员统一配置连接器，每位用户分别填写自己的凭证。这种方式适用于每个人拥有独立密钥、Token、authCode 或个人专属地址的服务。

业务示例：共用销售分析技能，通过个人凭证访问数据库

销售团队共用一个销售分析技能，用于查询订单、分析客户采购情况和生成销售报表。由于每位销售负责的客户和业务范围不同，各自的数据库账号也有不同的访问权限。如果将固定的账号密码写入共享 Skill，所有人都会以同一身份查询数据，无法按个人权限访问。

通过支持用户级凭证的应用连接，团队可以共享分析流程，同时保留每个人独立的数据访问身份。管理员在管理后台创建公共数据库连接器，销售人员在前台配置自己的数据库用户名和密码。使用技能查询数据时，平台将当前用户配置的凭证提供给 MCP，由 MCP 使用对应账号访问数据库，再将查询结果交给技能分析并生成报表。

后台管理员怎么配置

以下以创建“销售数据库”连接器为例，名称、地址及配置内容均为示例。管理员填写公共配置，将每个人不同的凭证部分写成 ${参数名}，由用户在前台填写自己的实际值。

方式一：手动配置 MCP

1. 进入创建页面。在管理后台的「能力中心-应用连接」中，点击「新建连接」，选择「手动配置 MCP」。
2. 填写连接信息。传输类型按服务方说明选择，其他页面字段按需设置。

本例假设服务方要求通过 X-DB-Username 和 X-DB-Password 两个 Header 传递数据库用户名和密码；这些名称仅为示例，实际需按服务方说明填写。

配置项	示例内容	填写说明
连接器地址	https://mcp.example.com/sales-db/mcp	替换为实际 MCP 服务地址，不是数据库的直连地址
Headers（第一行）	Name：X-DB-Username；Value：${dbUsername}	声明个人用户名参数，由用户在前台填写
Headers（第二行）	Name：X-DB-Password；Value：${dbPassword}	声明个人密码参数，由用户在前台填写

系统会识别出 dbUsername、dbPassword 两个凭证参数。

方式二：通过 JSON 配置 MCP

点击「新建连接」，选择「通过 JSON 配置 MCP」，粘贴以下配置，并替换实际服务地址及服务方要求的 Header 名称：

{
  "mcpServers": {
    "销售数据库": {
      "type": "streamable-http",
      "url": "https://mcp.example.com/sales-db/mcp",
      "headers": {
        "X-DB-Username": "${dbUsername}",
        "X-DB-Password": "${dbPassword}"
      }
    }
  }
}

其中：

• 销售数据库是连接器名称，可以修改。
• url替换为实际 MCP 服务地址。
• type按服务方说明填写；本例为streamable-http，如果使用 SSE 则填写sse。
• headers中的字段名对应 Header Name，字段值对应 Header Value。Header 名称按服务方要求填写，个人值保留为${参数名}。

如果服务要求其他个人凭证格式

以下是其他服务可能要求的写法，不需要与数据库示例一起填写。手动配置时替换对应的 Headers；JSON 配置时同步替换headers中的名称和完整值。

服务要求	Header Name	Header Value
Bearer Token	Authorization	Bearer ${userToken}，保留Bearer后的一个空格
API Key	服务方指定的名称，例如X-API-Key	${apiKey}
Key/Secret 分别作为 Header 值传递	按服务方指定名称分行填写，例如X-API-Key和X-API-Secret	分别填写${apiKey}和${apiSecret}；仅适用于直接传值的服务
Basic Auth	Authorization	Basic ${basicValue}，用户需填写已完成 Base64 编码的凭证值，不支持将分别输入的用户名、密码自动编码

如果服务提供个人专属 URL

例如，CRM 服务为每位销售提供一条带个人 authCode 的地址。管理员保留公共地址，只将个人凭证部分替换为 ${authCode}：

• 手动配置：在“连接器地址”中填写https://mcp.example.com/crm/mcp?authCode=${authCode}。可点击「+凭证参数」辅助插入，再修改参数名。
• JSON 配置：将url填写为同一地址，即"url": "https://mcp.example.com/crm/mcp?authCode=${authCode}"。
• 如果凭证位于 URL 路径中，同样在原位置替换，例如https://mcp.example.com/${accessKey}/mcp。

这类服务的 Headers 按其接入说明填写；如果只需 URL 凭证，则留空，JSON 中不添加headers，不要保留上方数据库示例中的两行 Header。用户在前台只需填写对应参数值，不需要填写完整 URL。

测试并保存

完成任一种配置后，点击「测试连接」，确认系统识别为“自定义凭证（用户级凭证）”，并核对参数名。后台测试只验证服务器可达，不代表个人凭证已验证成功。测试通过后，按页面提示保存，并确认连接器已启用、列表认证方式显示为“用户级凭证”。

前台用户怎么使用

1. 找到应用连接。 在「能力中心-应用连接-企业应用连接」中找到“销售数据库”。尚未配置时，状态显示为“待配置凭证”。
2. 填写自己的凭证。 点击「凭证配置」，进行个人凭证配置即可。
3. 连接与使用。 成功后状态变为“已连接”，即可使用。