自定义代理的 MCP 连接

MCP（大模型上下文协议）连接让你的自定义代理能够安全地连接到外部应用。通过 MCP 连接，你的代理可以使用与 Linear、Ramp、Figma 等应用的预配置连接来读取信息并执行操作，或者通过设置自定义 MCP 连接来连接到任何应用。

注意： MCP 连接仅适用于商业和企业版

MCP 连接让自定义代理能够通过大模型上下文协议与外部工具和服务进行交互。MCP 工具适用于所有触发类型，包括定时运行、基于 Notion 或 Slack 事件的触发运行，以及来自对话或 @提及的手动运行。

主要功能：

• 预配置服务器：无需任何额外配置即可快速连接到常用应用。

• 自定义服务器：使用公开可用的 URL 连接到任何支持托管 MCP 服务器的工具。

• 自定义：每个连接的工具都可以切换启用或禁用，你可以选择在运行前是否需要确认、自动运行或永久允许来自服务器的所有工具。

每个 MCP 连接对于单个自定义代理而言都是唯一的，并使用对其进行验证的人员的资格。即使连接到同一服务，连接也不会在代理之间共享。

这意味着：

• 如果你为代理 A 设置了 Figma 连接，代理 B 将需要其自己独立的 Figma 连接。

• 你必须为你配置的每个代理登录到每个 MCP 服务器。

• 撤销一个代理中的连接不会影响其他代理。

你可以连接到以下应用，无需任何额外配置：

• Amplitude

• Attio

• 框

• ClickHouse

• Figma

• Github

• HubSpot

• Intercom

• Linear

• Mercury

• Miro

• Mixpanel

• n8n

• Ramp

• Stripe

• Sentry

• Wiz

1. 打开你的自定义代理的 Settings。

2. 前往 Tools & Access。

3. 点击 Add connection → Add。

4. 选择一个预配置的服务器。

5. 按照身份验证提示连接你的帐号。

6. 选择你希望代理使用的服务器工具。这些工具会根据你选择的服务器而有所不同。

7. 点击 Connect。

要连接到不在预配置列表中的 MCP 服务器，工作空间管理员必须首先开启此选项。有两个独立的设置：一个用于允许自定义 MCP 服务器，另一个用于决定成员是可以安装任何连接，还是只能安装你批准的连接。

要允许自定义 MCP 服务器：

1. 作为工作空间管理员，前往 Settings → Connections。

2. 在 Manage 选项卡中，将 Enable custom MCP servers 切换为已启用。

要选择成员是可以安装任何连接，还是只能安装管理员批准的连接：

1. 作为工作空间管理员，前往 Settings → Connections。

2. 在 Manage 选项卡中，找到 Manage permissions 部分。

3. 在 Limit which connections members can install 旁边，选择一项：

   • 已批准并推荐：自动批准 Notion 推荐的所有连接。

   • 仅已批准：手动选择成员可以安装的每个连接。

4. 选择 已批准的连接 以查看成员可以安装的内容。

5. 选择 添加已批准的连接，然后选择你想要允许的内容：

   • 连接：按名称或 ID 搜索连接，并将其添加到已批准列表中。

   • 自定义 MCP 服务器：添加你想要允许的特定自定义 MCP 服务器 URL。

6. 点击 保存。

设置完成后，工作空间中的任何人都能在设置自定义代理时连接到已批准的选项。他们将使用自己的资格进行验证。

要将自定义 MCP 添加到自定义代理：

1. 打开你的自定义代理的 设置。

2. 前往 Tools & Access。

3. 点击 添加连接 → 自定义 MCP 服务器。

4. 你需要输入要连接的工具或提供商提供的 MCP 服务器 URL（例如：你公司的内部工具团队）。

5. 为该连接提供一个显示名称（可选）。

6. 添加任何所需的身份验证详细信息。

7. 点击 连接。

自定义 MCP 服务器可能支持以下一种或两种登录方式：

• OAuth

• 基于页首的身份验证

  （例如，API 密钥或持有者令牌）

某些 OAuth 服务器不支持 动态客户端注册 (DCR)。这意味着在 OAuth 登录生效之前，Notion 必须先向第三方服务预注册客户端应用程序。如果你要使用的服务器不支持 DCR，请查看其文档，了解是否可以使用 API 密钥或持有者令牌代替。如果这两种选项都不可用，则该 MCP 服务器无法与自定义代理一起使用。

你可以在自定义代理的 设置 下的 Tools & Access 中决定它应如何使用 MCP 连接。展开 MCP 连接条目以查看可用工具并确定它们的运行方式。可以使用旁边的开关启用或禁用工具。

读取和写入工具

• 读取工具（例如：快速查找/搜索、获取、列表、视图）允许自定义代理获取或查看信息，而无需对外部系统进行更改。

• 写入工具（例如：创建、更新、删除、发送、发布）会对外部系统中的数据进行更改。默认情况下，这些需要确认后，代理才会执行操作。

自动运行或始终询问

• 自动运行允许工具在无需用户确认的情况下执行。此设置最适合读取工具（搜索、获取、列表、视图），因为它们不会修改数据。

• 始终询问要求用户在操作执行前批准或取消操作。这是写入工具（创建、更新、删除、发送）的默认设置，以防止意外更改。

• 始终允许永久批准来自服务器的所有工具，并移除未来的确认提示。

要移除 MCP 连接

1. 打开代理的 设置。

2. 前往 工具与访问权限。

3. 找到 MCP 连接并点击 解除连接。

4. 点击 解除连接 以确认。

5. 进行更改后，请务必测试你的代理。你可以随时通过重新验证来重新连接。

注意： 如果你移除连接，代理将无法再访问该服务，且依赖于该服务器的计划运行可能会失败。你的代理工作流程可能会在你解除连接后立即中断。你可以随时通过重新验证来重新连接。

MCP 连接遵循为你的自定义代理设置的用户权限级别。以下是每个权限级别对 MCP 连接工具的操作权限。

拥有自定义代理全部权限和允许编辑权限的用户可以：

• 向自定义代理添加新的 MCP 连接。

• 与代理聊天并使用所有已连接的工具，即使他们在代理之外没有该工具的访问权限。

• 查看代理的活动日志和 MCP 工具使用情况。

• 删除现有的 MCP 连接。

• 重新连接或更新 MCP 服务器资格。

对于他们设置的 MCP 连接，拥有“全部权限”和“允许编辑”权限的用户可以：

• 配置启用或禁用的工具，并更改工具执行设置（自动运行与始终询问）。

提示： 一旦建立了 MCP 连接，只有验证该 MCP 连接的人员才能配置和更新工具设置——即使其他人对该自定义代理拥有“全部权限”或“允许编辑”权限。代理在访问外部服务时会使用该人员的资格和权限。

拥有“允许查看和交互”权限的自定义代理用户可以：

• 与自定义代理聊天并使用所有已连接的工具，即使他们在自定义代理之外没有这些工具的访问权限。

• 通过代理触发读取和写入操作。

• 在需要确认时批准或取消写入操作。

• 查看已连接的 MCP 服务器（在自定义代理设置中）。

拥有“允许查看和交互”权限的用户不能：

• 添加或删除 MCP 连接。

• 更改已启用的工具。

• 修改工具执行设置。

• 查看代理的完整活动日志。

提示： 写入操作（如创建或更新项目）默认需要确认，以防止意外更改。你在代理执行操作前会看到一个（文字）指令，显示代理即将采取的具体操作。

如果连接后工具未显示：

• 刷新代理设置页面。

• 检查 MCP 服务器是否已成功验证（查找绿色复选标记或“已连接”状态）。

• 验证服务器是否在线并返回工具元数据。

• 尝试重新连接服务器，或断开连接并重新添加。

提示：如果自定义代理运行失败并出现 MCP 错误：

• 检查 活动选项卡以获取具体的错误消息。

• 验证你的连接是否仍然有效（令牌可能已过期）。

• 确保该连接在代理的设置中仍然启用。

• 尝试重新连接 MCP 服务器以刷新资格。

• 更新你的自定义代理的指令，提及你想要使用的服务器或工具名称。例如：“使用 Linear MCP 检索此 mock 的元数据。”