5.5 企业级连接器:把客户系统接进来
第 3 章你在自己电脑上配了 mcp.json——那只对你生效。要让全公司都能读客户的 CRM,得由管理员在后台建企业连接器:配一次,组织内可用,成员无需单独配置。注意:连接器扩展的主要是读的边界;对生产系统的写操作,必须叠加最小权限账号与人工门禁(见第 10 章三类护栏)。
三步建一个自定义连接器
第一步:填基础信息
Connector 管理页点 + 新建连接器。标识(name)仅支持英文、数字、中划线、下划线,创建后不可修改,系统会自动加 enterprise_ 前缀(填 my-tool 实际存为 enterprise_my-tool)。
第二步:配认证方式(三选一)
| 认证类型 | 要填什么 |
|---|---|
| MCP OAuth 2.1 | 最省事。只需第三步填 MCP Server URL,凭据通过标准 OAuth 流程自动建立,无需手填 Client ID / Secret |
| OAuth 2.0 Authorization Code | Client ID、Client Secret、Authorization URL、Token URL、Scopes、User Info Endpoint、User Info Name Path。还需把后台给的 Redirect URL 填进第三方应用的回调白名单 |
| API Key | 最简单。只填 Header Name(默认 X-API-Key,也可设为 Authorization) |
第三步:填 MCP Server URL
面向第三方 API 的 MCP 协议接入地址,由服务方原生提供、平台托管、或企业自行部署均可。填完系统自动生成 Gateway 与 MCP 配置。
示例
MCP Server URL: https://docs.qq.com/openapi/mcp
# 系统自动解析生成:
Transport streamable_http
Upstream Host docs.qq.com
Path Prefix /openapi/mcp
Injector Type default
提示
进场谈接入时该说的三句话: ① 「先确认你们的系统支持哪种认证」——选错认证类型会显著增加调试成本,官方明确建议创建前先确认。 ② 「我们用只读凭据先跑一轮」——最小权限原则,写入权限等业务确需时再开。 ③ 「连接器不会定时抓你们的数据」——它仅在 Agent 通过成员对话触发调用时才发起请求,这句话能解掉客户安全部门一半的疑虑。 一条容易忽略的权限事实:连接器以配置的认证凭据所对应的第三方账号身份执行操作,访问范围不超出该账号在第三方服务中的已有权限。所以「给连接器配了谁的账号」等价于「AI 能看到谁能看到的东西」。这是第 8 章第一条红线「不碰不该碰的数据」在配置层面的落点。
随堂测
逐题作答,即时反馈
1. 关于企业级连接器与第 3 章自己电脑上配的 mcp.json 的区别及权限边界,下列说法正确的是?
2. 在 Connector 管理页新建一个自定义连接器的正确三步顺序是?
3. 关于三种认证方式与连接器标识(name)的配置细节,正确的是?