基于 AWS 上的 Smartsheet MCP 为 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 和数据层位于右侧。

图 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 IDE kiro.dev 与 Node.js 在您的环境中可用。

Smartsheet MCP Server 在三个区域端点可用。它使用 Streamable HTTP 传输(MCP 规范版本 2025-06-18 和 2025-03-26),并通过 OAuth 2.0 或个人访问令牌进行身份验证。

• 商业美国版:https://mcp.smartsheet.com。
• 欧盟版:https://mcp.smartsheet.eu。
• 澳大利亚版:https://mcp.smartsheet.au。

两种选项都提供相同的 Smartsheet 工具集。正确的选择取决于您的工作在哪里进行:

如果您需要一个全团队都可使用的完全托管、覆盖整个组织的解决方案,请选择 Amazon Quick:无需应用注册,仅支持预构建的 OAuth,并且可以在您企业中的知识型员工之间扩展。

如果您是一名想要轻量级方案的开发者,请选择 Kiro:无需基础设施,只需一个配置文件和一个个人访问令牌,并限定于您自己的工作流程。

Amazon Quick 集成

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

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

要添加 Quick 集成：

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

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

1. 选择 Smartsheet connector 磁贴。
2. 输入以下集成详细信息：
   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.

图 3：在 Amazon Quick 中输入 Smartsheet 连接详细信息

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

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

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

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

1. 选择 下一步.

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

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

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

Kiro 集成

Kiro 是当开发者希望在其开发环境中、与代码并排直接获取 Smartsheet 项目上下文而无需切换上下文时的正确选择。

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

Kiro 的一项名为 powers 的功能是一种一键安装的软件包，它将经过筛选的 MCP 服务器与引导文件（steering files）和钩子（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>"
      }
    }
  }
}

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

设置为你的 Smartsheet Personal Access Token，并配置到环境变量中。Kiro 在启动时将 MCP 服务器作为后台进程加载。初始化完成后，Smartsheet 工具即可在 Kiro 代理的所有模式下使用：聊天、spec 规划和基于 hooks 的自动化。完整详情请参阅 SMARTSHEET_API_TOKEN 到你的环境中的 Smartsheet Personal Access Token。Kiro 会在启动时将 MCP 服务器作为后台进程加载。初始化完成后，Smartsheet 工具即可在所有模式下供 Kiro 智能体使用：聊天、spec 规划以及基于 hooks 的自动化。完整详情请见 之后，Kiro 可以在开发工作流中引用 Smartsheet 数据：.

“检查 Backend API 项目表中的未解决 bug，并生成一份按优先级排序的修复列表。”

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

图 7：Kiro 从 Backend API 项目表中未解决的 bug 生成优先级修复列表

• 图 8：Kiro 根据 Q3 Roadmap 表中进行中的功能创建 spec

图 8：Kiro 从 Q3 Roadmap 表中正在进行的功能创建 spec

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

OAuth 2.0 和 Personal Access Token 身份验证

• OAuth 2.0 和 Personal Access Token 身份验证用户级权限强制执行
• ：代理只能访问已验证用户有权查看的数据。无法通过自然语言提示进行权限提升。：智能体只能访问经过身份验证的用户有权查看的数据。无法通过自然语言提示进行权限提升。
• ：系统管理员可以全局开启或关闭 AI 功能。写入工具的访问权限可按用户组进行配置。Streamable HTTP 传输
• ：防火墙允许列表通过完全限定域名（FQDN）（mcp.smartsheet.com）而非 IP 地址进行配置。对于合规架构师而言，MCP Server 不会存储提示词，提示词内容仅保留在 AI 客户端与模型之间。Smartsheet 只能看到结构化的工具调用及其结果。

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

如果你按照本演练操作并希望之后移除该集成，以下是撤销每条路径的方法：

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

在 Amazon Quick 控制台中，导航到

1. 连接器 选择你的 Smartsheet 连接器。.
2. 选择
3. 删除 以移除该连接。这将撤销 OAuth 令牌并停止代理对 Smartsheet 数据的访问。 以移除连接。这会撤销 OAuth 令牌并停止智能体对 Smartsheet 数据的访问。

打开你的 MCP 配置文件（

1. 从.kiro/settings/mcp.json).
2. 中移除 smartsheet-us 条目 mcpServers 对象。
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.

最后，您可以让智能体在每次写入操作后附加一条讨论评论，说明更改了什么以及为什么更改。通过以下要素的结合，这会在 Smartsheet 内创建一条人类可读的审计追踪： update_rows 和 create_discussion_on_row.

所有四种模式均适用于上述路径：Amazon Quick 用于面向业务用户的工作流，Kiro 用于开发人员发起的操作。

正在使用 Smartsheet MCP 和 AWS 构建什么？欢迎在评论中分享你的项目，或在以下社区与我们联系： Smartsheet 开发者社区.

关于作者