跳到正文
AWS Machine Learning Blog· Galina Jordanowa·· 3 小时前AI 评分40

Smartsheet MCP Server 在 AWS 上正式可用，为 AI 智能体提供工作管理上下文

Work management context for AI agents with Smartsheet MCP on AWS

AI 导读

Smartsheet 在 AWS 上正式发布 Model Context Protocol（MCP）Server，AI 助手可通过标准化协议读写和管理 Smartsheet 数据，涵盖 40 多个工具，用于操作 sheets、rows、columns 和 automations。

正文 · AI 翻译

当 AI 智能体能够对整个组织中正在进行的实际工作采取行动时，才能发挥最大价值。工作管理涉及复杂的跨职能任务，例如更新项目时间线、重新分配任务以及呈现状态。AI 智能体无需任何人切换工具即可为你提供这些支持。Smartsheet 是一个用于管理项目、项目组合和运营的工作管理平台，现已推出正式可用的 Model Context Protocol (MCP) Server。

通过 Smartsheet MCP Server，AI 助手可以通过标准化协议读取、写入和管理 Smartsheet 数据。该协议涵盖 40 多个工具，用于探索、创建和管理表格、行、列和自动化流程。你可以直接通过自然语言更新任务状态、创建行以及修改项目结构。

在本文中，我们将介绍将其连接到现有工作流的两种方式。Amazon Quick 是一个面向业务用户、项目经理和运营团队的智能体式 AI 工作区。他们可以通过自然语言提问、更新表格和构建仪表板，而无需编写代码。Kiro 是一个智能体式 IDE，开发人员可通过 MCP 连接到 Smartsheet，在不离开编码工作流的情况下引用项目规范、更新任务状态并跟踪依赖项。

架构概述

下图展示了 Smartsheet MCP Server 作为连接 AWS 服务的中央集成层的架构。Amazon Quick 和 Kiro 作为 MCP 客户端直接连接。

Amazon Quick 面向希望通过自然语言查询、更新和自动化 Smartsheet 的知识工作者、项目经理和运营团队。借助 Kiro，开发人员可以引用项目规范、更新任务状态并跟踪依赖项，而无需离开编码工作流。

以下架构图展示了这些集成路径：Smartsheet MCP Server 位于中心，Amazon Quick 和 Kiro 作为 MCP 客户端位于左侧，Smartsheet 的 API 和数据层位于右侧。

Architecture diagram: the Smartsheet MCP Server connecting Amazon Quick and Kiro clients to the Smartsheet API and data layer

图 1：Smartsheet MCP Server 架构，展示了从 Amazon Quick 和 Kiro 通过服务器连接到 Smartsheet API 层的 MCP 客户端连接

使用 Amazon Quick 和 Kiro 进行 Sprint 管理

假设有一个软件工程团队在 Smartsheet 中跟踪他们的 sprint。任务、负责人、状态和阻碍因素都保存在一个项目表中。以下是同一个团队使用各条路径的情形：

当项目经理这类用户想查看本周哪些 sprint 任务受阻时，可以通过自然语言向 Amazon Quick 提问。Amazon Quick 聊天智能体会查询 Smartsheet MCP Server，拉取相关行，并呈现包含负责人姓名和截止日期的摘要。响应基于实时 Smartsheet 数据生成，无需构建报表或仪表板。

对于正在修复缺陷或开发功能的开发人员，他们可以让 Kiro 拉取当前的 sprint 表，并显示分配给自己的待处理后端任务。Kiro 通过 MCP 查询 Smartsheet 并在行内显示列表。当修复提交后，Kiro 钩子会自动将对应行的状态更新为 Complete。

前提条件

Smartsheet MCP Server 提供精确结构化的上下文，包括行关系、列类型、单元格历史和评论。这带来了节省 token 的负载规模，而不是返回原始 API 负载。当在项目组合中运行数百个 AI 辅助查询时，这一工程决策会在规模上转化为更低的成本和更好的延迟。要了解 Smartsheet 如何在 AWS 上构建其远程 MCP 服务器，请参阅 Smartsheet 如何在 AWS 上构建远程 MCP 服务器。

在将 Smartsheet MCP Server 连接到 Amazon Quick 和 Kiro 之前，请确认你已具备以下条件：

  • 一个处于活动状态的 AWS 账户，并具有与你所连接服务（Amazon Quick 或 Kiro）相应的 AWS Identity and Access Management (IAM) 权限
  • 一个 Business、Enterprise 或 AWM 计划的 Smartsheet 账户。
  • 一个 Smartsheet Personal Access Token，如果你的客户端支持 OAuth 流程，则需 OAuth 凭证。
  • 对于 Amazon Quick：在你的 Amazon Quick 账户中拥有 Author 或更高权限。
  • 对于 Kiro：从 kiro.dev 安装 Kiro IDE，并且环境中已有 Node.js。

Smartsheet MCP Server 可通过三个区域端点访问。它使用 Streamable HTTP 传输（MCP 规范版本 2025-06-18 和 2025-03-26），并通过 OAuth 2.0 或 Personal Access Token 进行身份验证。

  • Commercial US：https://mcp.smartsheet.com。
  • EU：https://mcp.smartsheet.eu。
  • AU：https://mcp.smartsheet.au。

两种选项都暴露相同的 Smartsheet 工具集。正确的选择取决于你的工作在哪里完成：

如果你需要一个全托管、全组织范围的、整个团队都能使用的解决方案，请选择 Amazon Quick：无需应用注册，只需预构建的 OAuth，并且可以在企业中的知识工作者之间扩展。

如果你是想要轻量级方案的开发者，请选择 Kiro：无需基础设施，只需一个配置文件和一个个人访问令牌，范围限定在你自己的工作流内。

Amazon Quick 集成

Amazon Quick 在其连接器目录中将 Smartsheet 作为预构建连接器提供。这意味着读取项目状态、更新行、创建讨论和呈现风险，都可以在你的业务用户已经使用的同一界面中完成。

Amazon Quick 让这一集成在整个组织中可用，从项目经理和运营团队到在 Smartsheet 中管理工作的业务用户均可使用。

添加 Quick 集成：

  1. 在 Amazon Quick 控制台中，导航到 Connectors，并在目录中找到 Smartsheet。

Amazon Quick Connectors directory with the Smartsheet connector tile

图 2：Amazon Quick Connectors 目录中的 Smartsheet 连接器

  1. 选择 Smartsheet 连接器磁贴。
  2. Enter the following integration details:
    1. Name – 为你的 Smartsheet 集成提供一个描述性名称。
    2. 保持 Connection type 和 Auth configuration 设置不变。
    3. Base URL – https://mcp.smartsheet.com。
    4. Client ID – 来自你的 Smartsheet Developer Tools 应用注册的应用客户端 ID。
    5. Client Secret – 来自你的 Smartsheet Developer Tools 应用注册的应用密钥。
    6. Token URL – https://api.smartsheet.com/2.0/token。
    7. Auth URL – https://app.smartsheet.com/b/authorize。

Smartsheet connection details form in Amazon Quick with base URL, client ID, client secret, token URL, and auth URL fields

图 3：在 Amazon Quick 中输入 Smartsheet 连接详情

  1. 选择 Next。
  2. 在 Manage Tools & Permissions 页面上，你会看到可用工具的列表。选择 Next。

Manage Tools and Permissions page listing the available Smartsheet tools in Amazon Quick

图 4：Smartsheet 连接器的 Manage Tools and Permissions 页面

  1. 在发布 (Publish)页面上，选择谁可以访问此连接，然后选择发布。

Amazon Quick Publish page for choosing who can access the Smartsheet connection

图 5：在发布页面上选择谁可以访问 Smartsheet 连接

  1. 选择下一步。

连接完成后，你的 Amazon Quick 聊天智能体就可以通过自然语言处理 Smartsheet 数据：

  • “我们项目组合中目前有哪些项目处于‘有风险（At Risk）’状态？”
  • “将 Backend API 表格中身份验证任务的状态更新为‘已完成（Complete）’。”
  • “创建 Q3 Roadmap 中所有逾期项目的摘要，并发送给团队。”

Amazon Quick chat response summarizing overdue tasks from a Smartsheet project sheet with recommended actions

图 6：Amazon Quick 聊天响应，汇总了 Smartsheet 项目表格中的逾期任务，并附上关键观察结果和建议操作

Kiro 集成

当开发者希望直接在开发环境中、在代码旁边就能使用 Smartsheet 项目上下文而无需切换上下文时，Kiro 是正确的选择。

Kiro 围绕规范驱动开发（spec-driven development）构建。它将高层级提示转化为结构化规范，再转化为可运行的代码、文档和测试。MCP 服务器是 Kiro 获取真实世界上下文的方式，通过连接文档、数据库、API 和企业系统，使其智能体基于实时数据而非训练时的知识开展工作。

Kiro 的一项名为 powers 的功能是一种一键安装的捆绑包，将精选的 MCP 服务器与 steering 文件和 hooks 打包在一起，让 Kiro 编码智能体开箱即用地获得新能力。对于 Smartsheet，配置连接只需一个 JSON 配置块，此后 Kiro 智能体就可以在开发工作流中引用实时项目数据。

要将 Smartsheet MCP Server 连接到 Kiro，请将其添加到你的 Kiro MCP 配置中（.kiro/settings/mcp.json 用于工作区范围）。有关完整的操作步骤，请参阅 Getting Started with Kiro and MCP Servers：

{
  "mcpServers": {
    "smartsheet-us": {
      "type": "http",
      "url": "https://mcp.smartsheet.com",
      "headers": {
        "Authorization": "Bearer <SMARTSHEET_API_TOKEN>"
      }
    }
  }
}

此配置使用个人访问令牌（API 密钥）方式。对于生产部署，建议使用 OAuth。

在你的环境中将 SMARTSHEET_API_TOKEN 设置为你的 Smartsheet 个人访问令牌。Kiro 在启动时将 MCP 服务器作为后台进程加载。初始化完成后，Smartsheet 工具即可在所有模式下供 Kiro 智能体使用：聊天、规范规划和基于 hooks 的自动化。详情请参阅 Smartsheet MCP Server Documentation。

此后，Kiro 就可以在开发工作流中引用 Smartsheet 数据：

  • “检查 Backend API 项目表格中是否有未解决的 bug，并生成一份按优先级排序的修复清单。”

Kiro generating a prioritized fix list from open bugs in the Backend API Smartsheet project sheet

图 7：Kiro 根据 Backend API 项目表格中的未解决 bug 生成按优先级排序的修复清单

  • “调取 Q3 Roadmap 表格，并为标记为‘进行中（In Progress）’的功能创建一份规范。”

Kiro creating a spec from the in-progress features in the Q3 Roadmap Smartsheet sheet

图 8：Kiro 根据 Q3 Roadmap 表格中的进行中功能创建规范

企业治理

对于在受监管或企业环境中部署的构建者，Smartsheet MCP Server 的安全模型建立在与 Smartsheet REST API 相同的基础设施和权限层之上。它并不是一个新的信任边界：

  • OAuth 2.0 和个人访问令牌认证：选择你的 MCP 客户端所支持的认证方式。
  • 用户级权限强制执行：智能体只能访问经过认证的用户有权查看的数据。无法通过自然语言提示进行权限提升。
  • 组织级 AI 控制：系统管理员可以全局开启或关闭 AI 功能。写入工具的访问权限可按用户组进行配置。
  • 可流式 HTTP 传输：防火墙允许列表通过完全限定域名（FQDN）(mcp.smartsheet.com) 进行，而非 IP 地址。

对于合规架构师来说，MCP Server 不会存储提示词，提示词内容仅保留在 AI 客户端与模型之间。Smartsheet 只能看到结构化的工具调用及其结果。

清理

如果你按本演练操作后想移除该集成，以下是撤销各条路径的方法：

Amazon Quick

  1. 在 Amazon Quick 控制台中，导航到 Connectors（连接器）。
  2. 选择你的 Smartsheet 连接器。
  3. 选择 Delete（删除）以移除该连接。这将撤销 OAuth 令牌，并停止智能体对 Smartsheet 数据的访问。

Kiro

  1. 打开你的 MCP 配置文件（.kiro/settings/mcp.json）。
  2. 从 mcpServers 对象中移除 smartsheet-us 条目。
  3. 重启 Kiro 以卸载该服务器。

后续步骤

有关该服务器工作原理的背景信息，请参阅 Smartsheet 如何在 AWS 上构建远程 MCP 服务器。在你将 Smartsheet MCP Server 连接到所选系统后，我们推荐尝试以下四种操作：

你可以让聊天智能体监控你活跃的项目表，识别标记为 Blocked 或 At Risk 的行。你还可以要求为项目添加讨论评论作为标注，并通过你偏好的渠道向团队发送结构化摘要。这将是一个串联 get_sheet_summary、search 和 create_discussion_on_row 的工作流示例。

智能体还可以通过 Smartsheet MCP Server 检索数据，以便在你的问题跟踪器与 Smartsheet 项目计划之间核对任务状态。它可以标记两者之间的偏差，并按顺序使用 get_sheet_summary、get_columns、update_rows 和 create_discussion_on_row 更新受影响的行。

你还可以尝试跨报告和仪表板汇总项目健康状况信号。你可以用它生成结构化简报，无需手动收集数据，借助 list_reports、get_report、list_dashboards、get_dashboard 和 search。

最后，你可以让智能体在每次写入操作后都附带一条讨论评论，说明变更内容和原因。这通过组合使用 update_rows 和 create_discussion_on_row，在 Smartsheet 中创建了人类可读的审计轨迹。

这四种模式均适用于前述各条路径：Amazon Quick 面向业务用户的工作流，Kiro 面向开发者发起的操作。

正在用 Smartsheet MCP 和 AWS 构建什么？请在评论中分享你正在做的工作，或在 Smartsheet 开发者社区与我们联系。

关于作者

来源： AWS Machine Learning Blog · aws.amazon.com

#产品更新#MCP/工具调用#Agent