连接器（Connector）使用教程

连接器（Connector）是 AceData Cloud / Nexior 平台为 AI 助手提供的「外部能力总线」。它把 GitHub、Google Drive、Notion、Slack、Linear 等 Web 应用，以及社区里所有遵循 MCP（Model Context Protocol）的工具，统一收编到对话窗口里 —— 你不需要切换页面，就能让模型读你的 PR、查日历、写 Issue、跑数据库查询。

谁会用到：使用 Nexior / Studio 等基于平台的对话产品的最终用户；以及希望在自己的 Subsite 中预集成第三方工具的站长。

接入入口：登录 studio.acedata.cloud → 顶部「Connector」标签。

三种连接器

类型	来源	配置方式	典型例子
Web Connector	平台预置 OAuth	一键 OAuth 授权	GitHub、Google Drive、Notion、Linear、Atlassian
Built-in MCP	平台托管的 MCP Server	一键开启，无需密钥	Suno、Sora、Veo、Flux、Midjourney、Nano-Banana、SERP
Custom MCP	你自己的 MCP 服务器	手动填 URL + 认证头	公司内网工具、Self-hosted MCP

5 分钟实操

第 1 步：进入 Connector 中心

第 2 步：连接 GitHub（Web Connector 示例）

在「Not Connected」分组中找到 GitHub 卡片，点击它；
右侧详情面板出现 Connect 按钮，点击；
浏览器弹窗跳转到 GitHub OAuth 同意页，确认授权；
回到 Studio 后，卡片移动到「Web」分组，状态变为 Connected。

第 3 步：调整工具权限

点击已连接的卡片，向下滚动到「Tool Permissions」：

Read-Only Tools（只读工具，例如 list_issues / get_pull_request）：默认允许；
Write Tools（写入工具，例如 create_issue / merge_pr）：默认每次询问；
你也可以为单个工具切换 Always allow / Always ask / Never use。

第 4 步：在对话中使用

回到任意聊天，输入：

1	帮我看一下 acedatacloud/Nexior 上 main 分支最近 10 个 PR 的标题和合入状态。

模型会自动调用 GitHub Connector 暴露的 list_pull_requests 工具，把结果格式化后发回给你。

添加自定义 MCP Server

如果你已经有一个对外暴露的 MCP HTTP Server（例如公司内部的数据库代理），可以这样接入：

Connector 页右上角 Add → Add Custom Connector；
填写：
- Name：Internal DB
- Endpoint URL：https://mcp.example.com/mcp
- Headers：Authorization: Bearer xxx（如有）；
保存后，平台会拉一次 tools/list，把扫描到的工具罗列在权限面板里。

协议要求：自定义 Connector 必须遵循 MCP HTTP/SSE 规范。直接的纯 REST API 暂不支持，请考虑用 MCPs 仓库里的脚手架包一层。

常见问题

Q：Connector 授权后立即显示 Coming Soon？
A：表示该提供商的 OAuth 应用本站点还未配置。请联系站点管理员（白标场景）或换用 studio.acedata.cloud 主站，主站已为常用 OAuth 全部开通。

Q：Built-in 和 Custom 有什么区别？
A：Built-in 由平台运行（你只用为模型 Token 付费），Custom 由你自己运行（消耗你自己的服务器资源 + 凭证）。两者对模型来说都是普通工具调用。

Q：能在 API 里使用 Connector 吗？
A：能。/openai/chat/completions 接口支持 tools 字段，平台会把已连接的 Connector 自动注入；详见 OpenAI Chat Completions 工具调用章节。

静觅崔庆才的个人站点 - Python爬虫教程