跳转到主要内容
MCP Gateway 允许兼容的 AI 代理通过私有 HTTPS URL 调用 Alter 工具。你可以搜索会议、阅读转录文本、运行获准的已保存操作,以及开始或继续 Alter 对话。 工具由 Mac 上的 Alter 执行。Alter 中继会将 AI 代理连接到正在运行的应用。你无需在 Mac 上开放端口,也无需运行单独的本地 MCP 命令。
使用 ChatGPT 桌面版?请参阅在 ChatGPT 中使用 Alter了解插件安装步骤。本指南介绍兼容代理使用的远程 MCP 连接。

开始之前

  • 在 Mac 上登录 Alter。
  • 使用支持添加远程 HTTPS MCP 服务器 URL的 AI 代理。仅接受本地命令的客户端无法直接使用此 URL。
  • 使用连接期间,请保持 Mac 联网并让 Alter 运行。
ChatGPT 是首个经过测试的集成。其他客户端必须支持 Alter 的远程 MCP 端点;其兼容性尚未经过端到端验证。同一客户端中的工具支持和事件订阅支持可能不同。

启用 MCP Gateway

1

在 Alter 中打开 Gateways

按 ⌘, 打开 Settings,然后在 Integrations 下选择 Gateways。选择 Add gateway → MCP Gateway,或打开现有的 MCP Gateway。
2

选择访问权限并保存

打开 Enabled。在 Allowed access 下,启用代理需要使用的功能。只读会议测试可先启用 Read meeting transcripts。选择 Save and restart,等待连接就绪。
Alter MCP Gateway 设置,已启用 Enabled 开关并显示连接控件

启用 MCP Gateway 并保存连接,然后再将其添加到 AI 代理。

3

复制连接 URL

在 Connection 部分选择 Copy connection URL。这是你的私有远程 MCP 端点。请保密整个 URL,包括末尾的密钥。

将 Alter 添加到 AI 代理

打开代理的 MCP 或集成设置,并使用以下值添加远程服务器: 保存连接并刷新或发现工具。具体标签取决于客户端。此连接无需额外 API 密钥或 OAuth 登录。 先尝试只读请求:
列出我在 Alter 中最近的会议。
代理可能会要求你批准工具调用。如果没有显示会议,请确认 Alter 中已保存会议并启用了转录访问权限。

选择允许的访问权限

Alter MCP Gateway 的 Allowed access 部分,显示会议、操作、聊天和历史记录开关

仅启用连接代理需要使用的功能。

关闭的功能会从可用工具中移除,无法通过直接调用绕过限制。更改访问权限后,选择 Save and restart,然后刷新代理中的工具。重启网关会取消正在运行的网关任务。

默认操作和已保存操作

在 Behavior 下为新聊天选择 Default action。通常使用 Ask Anything。 若要使用其他已保存操作,请打开 Action Editor → Gateways 并启用 MCP Gateway 或 All。网关的 Available actions 列表会显示获准的操作。代理还需要 Run saved actions 权限才能发现并运行这些操作。 新的 Ask Anything 对话使用默认 Alter workspace。其他操作使用各自配置的 workspace。继续现有对话时,会保留该对话的 workspace 和操作权限。

试试这些请求

会议搜索会匹配已索引会议内容中的词语。对话搜索会匹配已索引的对话标题和消息。需要更多细节时,请让代理读取匹配的转录文本或对话。

问题和权限

聊天和操作在 Alter 工作期间可能会返回任务 ID。代理会使用 get_task 获取结果,也可以使用 cancel_task 停止运行中的任务。 Alter 任务可能暂停并提出问题或请求文件访问权限。代理应向你显示问题和选项,等待你的回答,然后将回答发回 Alter 再继续。 权限选项可能包括 Allow once、Always allow 或拒绝访问。此连接不会自动批准这些请求。如果代理一直等待却没有显示问题,请让它检查任务中的待答问题,并在你作出回答后使用可用的 answer_questions 工具。

事件支持

远程工具访问不会自动创建事件订阅。事件支持还取决于 AI 代理及其所选模式。 目前 Alter 只接受指向 ChatGPT/OpenAI 域名的转录就绪 Webhook。其他 MCP 代理可以使用兼容工具,但不支持任意第三方事件目标。请参阅ChatGPT 会议通知了解受支持的订阅设置。

隐私和可用性

连接 URL 会授予你为此网关启用的访问权限。请像密码一样保管,只存储在可信客户端中。 工具在 Mac 上的 Alter 中运行。请求和结果会经过 Alter 中继;代理请求时,转录文本也会传递。已保存的会议和对话仍保存在 Alter 中,连接的代理会收到其获准工具调用返回的数据。 请保持 Alter 运行并让 Mac 联网。禁用网关会停止访问并取消其活动任务。删除并重新创建网关会生成新的连接 URL;请在每个已连接客户端中替换旧 URL。

故障排除

相关页面