← 竞品监控中心  /  v9.7.0 Port Hope  /  产品规格
Gumloop · AI Agent 平台

Gumloop 功能规格 - MCP Artifacts

来源 v9.7.0 "Port Hope" | 2026-05-30 | 完整规格 已完成

初始上下文

产品/团队
Gumloop / AI Agent 平台
功能
MCP Artifacts — 通过 MCP 协议连接外部服务进行文件生成与交付
描述
将 Agent Artifacts（文件生成）能力与 MCP（外部服务连接）协议打通。此前 Agent 只能在沙箱内生成文件并在聊天窗口内预览——MCP Artifacts 让 Agent 可以通过 MCP 工具将生成的内容发布到外部服务，或通过 MCP 工具获取的数据直接生成 Artifact 文件
动机
Gumloop 有 100+ MCP 集成（Confluence、GitLab、Google Docs、Slack 等），但 MCP 工具的输出长期停留在文本回复层面。打通 MCP → Artifact 让 Agent 能将外部数据/内容以结构化文件形式交付
目标用户与痛点
(1) 需要将生成内容自动推送到外部平台的用户 (2) 需要从多个 MCP 数据源汇聚数据并生成统一报告的用户
平台范围
Web 端
关键成功指标
MCP Artifact 创建量、MCP→Artifact 的跨系统文件流数量

初始上下文

1. 概览

背景

Gumloop 的 Agent Artifacts 系统（官方文档）自 v8.2.0 以来一直是 Agent 内容生成的核心能力。Agent 在其沙箱中生成文件（HTML、CSV、PPTX、PDF 等），系统自动将这些文件导出到 Google Cloud Storage、生成缩略图预览、创建版本记录，并在聊天中以交互式卡片形式呈现。

同时，Gumloop 的 MCP 生态已扩展至 100+ 预构建集成（官方文档），覆盖 GitHub、GitLab、Confluence、Google Docs、Slack、Notion、Salesforce 等主流服务。Agent 可以通过 MCP 工具自动发现和调用这些服务的 API。

v9.7.0 发布的 MCP Artifacts 将这两大系统打通。[推断] 核心变化是：MCP 工具的输出可以不再是纯文本回复，而是以 Artifact 文件形式呈现——支持预览、版本管理、下载和分享。同时，Agent 生成的 Artifact 可以通过 MCP 工具发布到外部平台。

目标

  1. 打通文件流：让 Agent 生成的文件能通过 MCP 协议发布到任意外部服务
  1. 丰富内容来源：让 MCP 获取的外部数据能直接形成结构化 Artifact 文件
  1. 深化平台嵌入：每个 MCP Artifact 连接器都加深 Gumloop 在用户技术栈中的嵌入度

2. 竞品分析

竞品 功能/行为 优势 劣势 洞察/机会
Claude Artifacts + MCP Claude 可以生成 HTML/SVG Artifacts 并通过 MCP 连接外部服务 MCP 协议原生支持 Artifact 和 MCP 是两个独立功能，未深度打通 `[推断]` Gumloop 的打通更产品化
OpenAI GPTs + Actions GPT 可通过 Actions 连接外部 API 生态庞大 Actions 输出通常为文本，无结构化文件概念 Gumloop 的 Artifacts 文件类型更丰富
Zapier/Make 自动化工作流连接多平台 海量连接器 规则驱动而非 AI 驱动 AI 生成 + 自动分发 = 差异化
Notion API 通过 API 创建文档/数据库 直接集成 单点方案 MCP 的通用性优势

关键洞察：

  1. MCP 协议从"只读"到"读写"：当前 MCP 主要用于 Agent 从外部获取数据（读取），MCP Artifacts 将 MCP 扩展到"写入"方向——Agent 向外部发布内容
  1. 平台嵌入度 = 护城河：Agent 生成了你的 Confluence 文档、提交了你的 GitLab MR、更新了你的 Google Slides——每个集成都在加深对 Gumloop 的依赖

3. 用户场景与故事

场景 1 — 数据分析师：报告生成 + 自动发布到 Confluence `[推断]`

用户画像： 张敏，32 岁，电商数据分析师。每周需要生成分析报告并发布到团队 Confluence 空间。

用户故事： 作为数据分析师，我希望 Agent 生成分析报告后自动发布到 Confluence，以便我只需审核确认即可，无需手动下载→登录 Confluence→上传→排版。

场景 2 — 开发者：代码直接提交到 GitLab `[推断]`

用户画像： 王磊，35 岁，独立开发者。使用 Agent 编写数据管道脚本。

用户故事： 作为开发者，我希望 Agent 生成的代码可以直接提交到 GitLab 仓库，以便只需 Code Review 即可合并。

场景 3 — 运营经理：从多数据源汇聚后生成统一报告 `[文档已验证]`

用户画像： 陈立，28 岁，运营经理。需要从 Salesforce（CRM）、Notion（项目）和 Snowflake（数据库）三个数据源拉取数据生成周报。

用户故事： 作为运营经理，我希望 Agent 从多个 MCP 连接的数据源获取数据后，自动生成包含图表和表格的 HTML 报告（Artifact），以便我在聊天窗口内预览并分享。

4. Agent Artifacts 系统 `[文档已验证]`

以下是 Gumloop 官方文档中对 Artifacts 的记录——这是 MCP Artifacts 的基础设施。

文件生成

Agent 在沙箱中通过代码执行、数据处理或文件生成工具产出文件后，内置导出功能自动：

  1. 存储文件到 Google Cloud Storage
  1. 创建版本追踪的 Artifact 记录
  1. 生成缩略图预览
  1. 在对话中以交互式卡片展示

支持的文件类型

文件类型 预览方式
HTML (.html) 沙箱化交互预览，支持全屏模式
图片 (.png, .jpg, .gif, .webp, .svg) 原生图片查看器
PDF (.pdf) 专用 PDF 查看器
电子表格 (.csv, .xlsx, .xls) 电子表格查看器
演示文稿 (.pptx, .ppt) 幻灯片查看器或 PDF 预览
文本/代码 (.txt, .md, .py, .js, .json 等) 语法高亮文本查看器
其他类型 显示文件大小的下载提示

50MB 的文件不提供内联预览，仅显示下载卡片。

自动版本管理

当 Agent 同一对话中多次导出同名文件时，系统自动创建新版本（v1 → v2 → v3），而非覆盖。每个版本显示版本号、创建时间戳和文件大小。

交互式 Artifacts（HTML + 实时数据）

这是最接近"动态页面"的能力。Agent 可生成包含 JavaScript 的 HTML 文件，这些文件在打开时从已连接集成中拉取实时数据：

Workspace 文件（跨对话持久化）

保存到 /home/user/.workspace/ 的文件成为工作区级 Artifact，跨对话持久存在。项目成员共享工作区，非成员获得隔离的私有工作区。

5. MCP 与 Artifacts 的集成 `[推断]`

以下内容基于 MCP 工具能力和 Artifacts 系统的合理整合推断。

模块 A：MCP → Artifact（外部数据 → 文件）

ID 触发场景 系统行为 优先级
A1 Agent 通过 MCP 工具获取外部数据后生成报告 生成的文件自动作为 Artifact 展示（预览、版本、分享） P0
A2 Agent 从多个 MCP 数据源汇聚数据 合并数据生成统一 Artifact（如包含多数据源的 HTML 仪表盘） P0
A3 MCP 工具返回大体积数据 自动以 CSV/JSON Artifact 形式呈现，支持下载和预览 P1

模块 B：Artifact → MCP（文件 → 外部发布）

ID 触发场景 系统行为 优先级
B1 Agent 生成 Artifact 后用户要求发布到外部平台 Agent 调用对应 MCP 工具（Confluence/GitLab/Google Docs）将文件内容写入目标平台 P0
B2 发布需要用户确认 展示目标平台、操作类型、内容摘要，等待确认后再执行 P0
B3 发布失败 保留 Artifact 在聊天窗口，提示失败原因和建议修复方式 P0

模块 C：权限与安全

ID 触发场景 系统行为 优先级
C1 MCP 工具的写入操作 需要用户显式确认（不自动写入外部平台） P0
C2 MCP 工具权限 用户可配置不同 MCP 工具的读写权限级别 P1
C3 凭据选择 对于 Hosted/Proxied MCP 工具，用户可选择特定凭据而非默认凭据（v9.6.0 已支持） P1

6. 遥测

漏斗阶段 事件名称 触发条件 指标/KPI 目的 优先级
采用 `mcp_artifact_created` MCP 工具数据被导出为 Artifact 创建数/日 衡量 MCP→Artifact 流 P0
采用 `artifact_published_via_mcp` Artifact 通过 MCP 发布到外部 发布数/日 衡量 Artifact→MCP 流 P0
使用 `mcp_artifact_target_platform` 发布的目标平台类型 平台分布 了解用户技术栈 P1
质量 `artifact_publish_failed` MCP 发布失败 失败率+原因 监控可靠性 P0

7. 路线图与未来演进方向

阶段 时间线 里程碑 状态
Phase 1 — 基础打通 v9.7.0 MCP 工具输出可形成 Artifact，Artifact 可通过 MCP 发布 ✅ 已发布
Phase 2 — 格式智能适配 v10.x 自动检测目标平台最优格式、Markdown→Confluence Storage Format 自动转换 ⬜ 规划中
Phase 3 — 发布工作流 v11.x 定时发布、批量多平台发布、发布审批链 ⬜ 探索中
Phase 4 — MCP Artifact 生态 未来 MCP 服务器可直接声明"支持 Artifact 输出"作为协议能力、第三方 MCP 服务器可注册为 Artifact 目标 ⬜ 探索中

关键演进判断

  1. MCP 协议标准化是关键：当前每个 MCP 工具的写入能力不统一。如果 MCP 协议未来标准化"Artifact 目标"概念（类似 `tools` 和 `resources`），将极大降低集成成本
  1. 格式转换是隐性壁垒：不同平台要求不同格式（Confluence Storage Format、Google Docs JSON、GitLab API 格式）——自动格式转换的质量决定了"Agent 自动发布"是否实用
  1. 从"生成后发布"到"实时协作"：最理想的形态是 Agent 直接在外部平台创建内容，用户在外部平台修改后 Agent 自动同步更新——但这需要双向 MCP 支持

由 Claude spec-generate 系统生成 · 来源：Gumloop Agent Artifacts 文档 · MCP 集成文档 · Enterprise Hosted MCPs 文档