Work management context for AI agents with Smartsheet MCP on AWS

AI代理在AWS上使用Smartsheet MCP的工作管理上下文 | 人工智能

AI代理在AWS上使用Smartsheet MCP的工作管理上下文

当AI代理能够针对组织内实际进行的工作采取行动时，其价值最为显著。工作管理涉及更新项目时间线、重新分配任务和呈现状态等复杂且跨职能的任务。AI代理可以在无需切换工具的情况下协助完成这些工作。Smartsheet作为管理项目、组合和运营的工作管理平台，现已推出通用可用的模型上下文协议（MCP）服务器。

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

在本文中，我们将介绍两种将Smartsheet MCP服务器连接到现有工作流程的方法。Amazon Quick是一个为商业用户、项目经理和运营团队构建的智能AI工作空间。他们可以通过自然语言查询、更新表格和构建仪表板，而无需编写代码。Kiro是一个智能IDE，开发者可以通过MCP连接到Smartsheet，参考项目规范、更新任务状态并跟踪依赖关系，而无需离开编码工作流。

架构概述

下图展示了Smartsheet MCP服务器作为中心集成层连接AWS服务的方式。Amazon Quick和Kiro直接作为MCP客户端进行连接。

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

下图架构图说明了这些集成路径：Smartsheet MCP服务器位于中心，左侧是Amazon Quick和Kiro作为MCP客户端，右侧是Smartsheet的API和数据层。

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

与Amazon Quick和Kiro的冲刺管理

考虑一个在Smartsheet中跟踪冲刺的软件工程团队。任务、负责人、状态和阻碍因素都存储在项目表格中。对于同一团队，每种路径的使用方式如下：

当项目经理等用户想查看本周哪些冲刺任务受阻时，他们可以通过自然语言向Amazon Quick提问。Amazon Quick聊天代理会查询Smartsheet MCP服务器，提取相关行，并呈现包含负责人姓名和截止日期的摘要。该响应直接来自实时Smartsheet数据，无需创建报告或仪表板。

对于正在修复漏洞或处理功能的开发人员，他们可以让Kiro提取当前冲刺表格，并显示分配给他们的开放后端任务。Kiro通过MCP查询Smartsheet，并在行内呈现列表。当修复提交时，Kiro钩子会自动将对应行状态更新为“完成”。

先决条件

/think

Smartsheet MCP 服务器提供精确的结构化上下文信息，包括行关系、列类型、单元格历史记录和评论。这种方式生成的负载体积更小，而非返回原始 API 负载。这一工程决策在处理数百个 AI 辅助查询时，会随着项目组合规模的扩大，显著降低运行成本并提升延迟表现。欲了解 Smartsheet 如何在 AWS 上构建远程 MCP 服务器，请参阅《Smartsheet 如何在 AWS 上构建远程 MCP 服务器》。

在将 Smartsheet MCP 服务器连接到 Amazon Quick 和 Kiro 之前，请确保已具备以下条件：

• 拥有有效的 AWS 账户，并为所连接的服务（Amazon Quick 或 Kiro）配置了适当的 AWS 身份和访问管理（IAM）权限
• 拥有 Business、Enterprise 或 AWM 计划的 Smartsheet 账户
• Smartsheet 个人访问令牌，或如果客户端支持 OAuth 流程，则使用 OAuth 凭据
• 对于 Amazon Quick：在 Amazon Quick 账户中拥有 Author 或更高权限
• 对于 Kiro：从 kiro.dev 安装 Kiro IDE，并在环境中配置 Node.js

Smartsheet MCP 服务器提供三个区域端点。它使用可流式传输的 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 集成的步骤如下：

• 在 Amazon Quick 控制台中，导航至连接器页面并找到 Smartsheet 目录条目

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

• 选择 Smartsheet 连接器图块
• 输入以下集成信息：名称 – 为 Smartsheet 集成指定描述性名称。保持连接类型和认证配置设置为默认值。基础 URL – https://mcp.smartsheet.com。客户端 ID – 来自 Smartsheet 开发者工具应用注册的客户端 ID。客户端密钥 – 来自 Smartsheet 开发者工具应用注册的密钥。令牌 URL – https://api.smartsheet.com/2.0/token。认证 URL – https://app.smartsheet.com/b/authorize

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

• 选择下一步
• 在管理工具和权限页面，您将看到可用工具列表。选择下一步

图 4：Smartsheet 连接器的管理工具和权限页面

• 在发布页面，选择可以访问此连接的人员，然后选择发布

图 5：在发布页面选择可以访问 Smartsheet 连接的人员

连接后，Amazon Quick chat代理可通过自然语言与Smartsheet数据交互：

• “我们投资组合中哪些项目目前处于风险中？”
• “将后端API表格中身份验证任务的状态更新为已完成。”
• “生成Q3路线图中所有逾期事项的摘要并发送给团队。”

图6：Amazon Quick chat响应，汇总Smartsheet项目表格中的逾期任务，包含关键观察结果和推荐行动

Kiro集成

当开发者希望在开发环境中直接访问Smartsheet项目上下文，且无需切换上下文时，Kiro是理想选择。

Kiro围绕基于规格的开发构建。它将高层级提示转化为结构化规格，再生成可运行的代码、文档和测试。MCP服务器通过连接文档、数据库、API和企业系统，为Kiro提供真实世界的数据上下文，而非依赖训练时的知识。

Kiro的"powers"功能是一个一键安装的捆绑包，包含精选的MCP服务器、引导文件和钩子。它为Kiro编码代理开箱即用的新功能。对于Smartsheet，连接配置只需一个JSON配置块，从此Kiro代理可在开发工作流中引用实时项目数据。

要将Smartsheet MCP服务器连接到Kiro，请将其添加到Kiro MCP配置中（工作区范围：.kiro/settings/mcp.json）。完整操作指南请参见《Kiro和MCP服务器入门》：

{
  "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代理使用。详细信息请参见《Smartsheet MCP服务器文档》。

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

• “检查后端API项目表格中的开放缺陷，生成优先级修复列表。”

图7：Kiro从后端API项目表格的开放缺陷中生成优先级修复列表

• “提取Q3路线图表格，为标记为进行中的功能创建规格。”

图8：Kiro从Q3路线图表格的进行中功能创建规格

企业治理

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

• OAuth 2.0和个人访问令牌认证：选择您的MCP客户端支持的认证方式
• 用户级权限控制：代理仅能访问已认证用户有权限查看的数据，自然语言提示无法提升权限
• 组织级AI控制：系统管理员可全局启用或禁用AI功能，写工具访问权限可按用户组配置

• 可流式传输的 HTTP 传输：防火墙允许列表通过完全限定域名（FQDN）（mcp.smartsheet.com）设置，而非 IP 地址。

对于合规架构师而言，MCP 服务器不会存储提示内容，提示内容仅在 AI 客户端与模型之间传输。Smartsheet 仅能看到结构化的工具调用及其结果。

清理

如果您按照本指南操作并希望后续移除集成，以下是撤销每种配置路径的方法：

Amazon Quick

• 在 Amazon Quick 控制台中，进入 Connectors（连接器）。
• 选择您的 Smartsheet 连接器。
• 点击 Delete（删除）以断开连接。这将撤销 OAuth 令牌并阻止代理访问 Smartsheet 数据。

Kiro

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

下一步

如需了解服务器的工作原理，请参阅《Smartsheet 如何在 AWS 上构建远程 MCP 服务器》。在将 Smartsheet MCP 服务器连接到您选择的系统后，我们建议尝试以下四项操作：

您可以要求聊天代理监控您的活动项目表，识别标记为 Blocked（已阻塞）或 At Risk（存在风险）的行。您也可以要求为项目添加讨论评论，并通过您偏好的渠道向团队发送结构化摘要。这将是一个串联使用 get_sheet_summary、search 和 create_discussion_on_row 的示例工作流。

代理还可以通过 Smartsheet MCP 服务器获取数据，以在您的问题跟踪器与 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 开发者社区与我们交流。

作者简介

{
  "name": "John Doe",
  "title": "Senior Software Engineer",
  "company": "Smartsheet",
  "bio": "John is a passionate developer with 15+ years of experience in building scalable cloud solutions."
}