> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alterhq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 通过 Remote MCP 连接 AI 代理

> 将 Alter 用作远程 MCP 服务器，以访问 Mac 上的会议、已保存操作和对话

MCP Gateway 允许兼容的 AI 代理通过私有 HTTPS URL 调用 Alter 工具。你可以搜索会议、阅读转录文本、运行获准的已保存操作，以及开始或继续 Alter 对话。

工具由 Mac 上的 Alter 执行。Alter 中继会将 AI 代理连接到正在运行的应用。你无需在 Mac 上开放端口，也无需运行单独的本地 MCP 命令。

> [!TIP]
>
> 使用 ChatGPT 桌面版？请参阅[在 ChatGPT 中使用 Alter](/zh/apps-tools/gateways-chatgpt.md)了解插件安装步骤。本指南介绍兼容代理使用的远程 MCP 连接。

## 开始之前

* 在 Mac 上登录 Alter。
* 使用支持添加**远程 HTTPS MCP 服务器 URL**的 AI 代理。仅接受本地命令的客户端无法直接使用此 URL。
* 使用连接期间，请保持 Mac 联网并让 Alter 运行。

> [!NOTE]
>
> 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 开关并显示连接控件](https://mintcdn.com/alter-95c0cbf0/Hy1s62bRsMvpVH6C/images/gateways/chatgpt/alter-mcp-connection.png?fit=max\&auto=format\&n=Hy1s62bRsMvpVH6C\&q=85\&s=4b8b77cf9de2094d96a8b0b3cdfad0f9)

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

**3. 复制连接 URL**

在 **Connection** 部分选择 **Copy connection URL**。

这是你的私有远程 MCP 端点。请保密整个 URL，包括末尾的密钥。

## 将 Alter 添加到 AI 代理

打开代理的 MCP 或集成设置，并使用以下值添加远程服务器：

| 字段 | 值 |
| - | - |
| 名称 | **Alter** |
| 服务器 URL | 粘贴 **Copy connection URL** 复制的完整 URL。 |
| 身份验证 | **No authentication** 或客户端中的等效选项。访问权限已包含在私有 URL 中。 |

保存连接并刷新或发现工具。具体标签取决于客户端。此连接无需额外 API 密钥或 OAuth 登录。

先尝试只读请求：

> 列出我在 Alter 中最近的会议。

代理可能会要求你批准工具调用。如果没有显示会议，请确认 Alter 中已保存会议并启用了转录访问权限。

## 选择允许的访问权限

![Alter MCP Gateway 的 Allowed access 部分，显示会议、操作、聊天和历史记录开关](https://mintcdn.com/alter-95c0cbf0/Hy1s62bRsMvpVH6C/images/gateways/chatgpt/alter-mcp-access.png?fit=max\&auto=format\&n=Hy1s62bRsMvpVH6C\&q=85\&s=ed9df89e68ddf7d65d5debac27cbffec)

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

| 设置 | 可用工具和行为 |
| - | - |
| **Read meeting transcripts** | `list_meetings`、`search_meetings` 和 `get_meeting_transcript` 可列出并搜索已保存会议，然后读取选定的转录文本。 |
| **Run saved actions** | `list_actions` 和 `run_action` 可发现并运行允许此网关使用的已保存操作。 |
| **Chat with Alter** | `create_conversation` 和 `send_message` 可使用获准的操作开始和继续对话。 |
| **Read conversation history** | `list_conversations`、`search_conversations` 和 `get_conversation` 可查找并阅读其操作已获准使用的对话。 |
| **Notify when transcripts are ready** | 为支持且已建立事件订阅的客户端启用转录就绪事件。当前限制请参阅[事件支持](#事件支持)。 |

关闭的功能会从可用工具中移除，无法通过直接调用绕过限制。更改访问权限后，选择 **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 会议中搜索定价相关内容，并总结匹配的讨论。” |
| 查看近期会议 | “列出我在 Alter 中最近的会议，然后读取最新转录文本。” |
| 查找已保存操作 | “通过此连接，你可以运行哪些 Alter 操作？” |
| 开始 Alter 聊天 | “请让 Alter 检查当前 workspace 中的最新文件，但不要修改它们。” |
| 搜索过往对话 | “查找我之前关于入职流程的 Alter 对话。” |

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

### 问题和权限

聊天和操作在 Alter 工作期间可能会返回任务 ID。代理会使用 `get_task` 获取结果，也可以使用 `cancel_task` 停止运行中的任务。

Alter 任务可能暂停并提出问题或请求文件访问权限。代理应向你显示问题和选项，等待你的回答，然后将回答发回 Alter 再继续。

权限选项可能包括 **Allow once**、**Always allow** 或拒绝访问。此连接不会自动批准这些请求。如果代理一直等待却没有显示问题，请让它检查任务中的待答问题，并在你作出回答后使用可用的 `answer_questions` 工具。

## 事件支持

远程工具访问不会自动创建事件订阅。事件支持还取决于 AI 代理及其所选模式。

目前 Alter 只接受指向 ChatGPT/OpenAI 域名的转录就绪 Webhook。其他 MCP 代理可以使用兼容工具，但不支持任意第三方事件目标。请参阅[ChatGPT 会议通知](/zh/apps-tools/gateways-chatgpt.md#接收新会议通知)了解受支持的订阅设置。

## 隐私和可用性

连接 URL 会授予你为此网关启用的访问权限。请像密码一样保管，只存储在可信客户端中。

工具在 Mac 上的 Alter 中运行。请求和结果会经过 Alter 中继；代理请求时，转录文本也会传递。已保存的会议和对话仍保存在 Alter 中，连接的代理会收到其获准工具调用返回的数据。

请保持 Alter 运行并让 Mac 联网。禁用网关会停止访问并取消其活动任务。删除并重新创建网关会生成新的连接 URL；请在每个已连接客户端中替换旧 URL。

## 故障排除

| 问题 | 检查事项 |
| - | - |
| 客户端只提供命令或可执行文件字段 | 选择支持远程 HTTPS MCP URL 的客户端或连接类型。 |
| 服务器无法连接 | 确认 Alter 正在运行且 MCP Gateway 已启用并连接。尝试在 Alter 的 **Connection** 部分选择 **Reconnect**，然后刷新客户端。重新连接会取消活动网关任务。 |
| 缺少工具 | 启用对应的 **Allowed access** 开关，保存并刷新代理的工具列表。对于操作，还需检查 **Action Editor → Gateways**。 |
| 任务一直等待 | 检查 Alter 是否需要明确回答或文件访问决定。 |
| 工具可用但事件不可用 | 检查客户端和模式。目前事件目标仅限 ChatGPT/OpenAI 域名，并且需要有效订阅。 |
| 更改 Alter 账户或重新创建网关后访问中断 | 复制当前连接 URL，并在代理中替换旧 URL。 |

## 相关页面

* [在 ChatGPT 中使用 Alter](/zh/apps-tools/gateways-chatgpt.md)
* [Gateways 概览](/zh/apps-tools/gateways.md)
* [Alter Actions](/zh/workflows/alter-actions.md#8-gateways)
* [本地数据与隐私](/zh/references/local-data-and-privacy.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.