5.5 企业级连接器:把客户系统接进来

约 15 分钟L2L3T4B3

课程来源

[来源] 腾讯云培训认证《腾讯云人工智能前沿部署工程师(FDE)》第 5 章 ·〈5.5 企业级连接器:把客户系统接进来〉

原文:https://cloud.tencent.com/edu/learning/course-4767-84813-84825(腾讯云在线学习中心)

[收录说明] 企业内部培训用途蒸馏收录:保留原课章节结构与要点,截图以图注转写、互动组件转写为要点清单;概念与事实以原课为准。

本课目录(4 节)

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 CodeClient 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 章第一条红线「不碰不该碰的数据」在配置层面的落点。

随堂测

逐题作答,即时反馈

0 / 3 已作答
  1. 1. 关于企业级连接器与第 3 章自己电脑上配的 mcp.json 的区别及权限边界,下列说法正确的是?

  2. 2. 在 Connector 管理页新建一个自定义连接器的正确三步顺序是?

  3. 3. 关于三种认证方式与连接器标识(name)的配置细节,正确的是?