MCP 服务器

使用模型上下文协议 (MCP) 将 AI 助手连接到 Activepieces

Activepieces 内置了一个 MCP 服务器，让 AI 助手可以通过自然语言构建工作流、管理表格、测试自动化等。

快速开始

1. 获取服务器 URL

前往设置 → MCP 服务器
将服务器开关切换为开启
复制服务器 URL

2. 连接客户端

将 URL 添加到您的 MCP 客户端配置中。认证通过 OAuth 处理 —— 您的客户端会在首次使用时打开浏览器进行认证。

{
  "mcpServers": {
    "activepieces": {
      "url": "https://your-instance.com/mcp"
    }
  }
}

客户端	配置位置
Cursor	`.cursor/mcp.json`（项目）或 `~/.cursor/mcp.json`（全局）
Claude Desktop	`~/Library/Application Support/Claude/claude_desktop_config.json`（macOS）或 `%APPDATA%\Claude\claude_desktop_config.json`（Windows）
Windsurf	编辑器偏好设置中的 MCP 设置
Claude.ai	组织设置 → 连接器 → 添加 → 自定义连接器

3. 开始构建

连接后，您可以向 AI 助手提出以下请求：

“创建一个工作流，当 Google Sheets 中新增一行时发送 Slack 消息”
“在发布前检查我的工作流是否有问题”
“创建一个联系表格并添加 3 条记录”
“显示最近一次失败的运行以及出错原因”
“有哪些 Slack 触发器可用？“

工具分类

工具按类别组织。发现工具始终可用。其他类别可以在 MCP 服务器设置中按项目启用或禁用。

类别	描述
发现	用于探索工作流、Pieces、连接、表格、运行和验证的只读工具
工作流管理	创建、复制、重命名、发布以及启用/禁用工作流
工作流构建	添加、更新和删除步骤及触发器
路由与分支	添加、更新和删除条件分支
标注	管理画布笔记
表格	表格、字段和记录的完整 CRUD 操作
测试与运行	测试工作流、检查结果、重试失败项

查看工具参考获取包含输入模式的完整目录。

在反向代理后自托管

MCP 服务器及其 OAuth 端点可以在主机根路径（https://your-instance.com/mcp）和路径前缀（https://your-instance.com/<prefix>/mcp）下访问，当您的反向代理将 https://host/<prefix>/* 路由到 Activepieces 时。

要使子路径部署正常工作，请将 AP_FRONTEND_URL 设置为完整的公共 URL 包含前缀（例如 https://your-instance.com/activepieces）。然后 Activepieces 会在该前缀下发布其 OAuth 颁发者、授权/令牌端点、受保护资源元数据和 WWW-Authenticate 发现标头，使整个握手过程保持在您的代理规则内。

忽略 `WWW-Authenticate` 标头并在主机根路径（`https://host/.well-known/oauth-*`）探测 RFC 标准路径的客户端需要额外的代理规则，将这些主机根路径转发到 Activepieces —— 该命名空间由 RFC 8414/9728 锚定在主机根路径下，无法在前缀下重新定位。遵守标头的客户端（如 Claude）不需要此配置。

安全性

OAuth 认证 —— 安全的、基于令牌的认证，由您的 MCP 客户端自动处理
凭据永不暴露 —— 连接密钥、API 密钥和 OAuth 令牌不会通过任何工具返回
项目范围限定 —— 所有操作都限定在已认证的项目范围内
敏感配置 —— ap_setup_guide 返回供用户在 UI 中配置连接的说明，而不是通过 MCP 处理密钥