连接器指南阅读约 6 分钟38 个 MCP 工具7 种语言

如何通过 MCP 将 Smartsheet 连接到 Claude

使用个人访问令牌的 Smartsheet API 2.0(US、EU、AU 或 Gov):搜索和读取表格、行、列、表格摘要和单元格历史、评论和附件、工作区、文件夹、报表和仪表板、用户和共享;添加和修改行与列、发表评论、创建表格、共享以及发送更新请求。删除行在安装时关闭。

HC作者:HelpCode 团队更新于 6 分钟阅读 在 GitHub 开源

无需信用卡 · 7 天试用 · 提供自托管方案

Smartsheet

Smartsheet

Let your AI work in Smartsheet: search and read sheets, rows, columns, sheet summaries and cell history, comments and attachments, browse workspaces, folders, reports and dashboards, list users and shares, and add, update or delete rows, add columns, comment, create sheets, share and send update requests. Smartsheet API 2.0 with a personal access token (US, EU, AU or Gov).

个工具

38

区域

INTL

类别

项目管理

身份验证

Bearer Token

所需环境变量

SMARTSHEET_API_URLSMARTSHEET_ACCESS_TOKEN
在 Cloud 上一键安装

7 天免费试用 · 无需信用卡

  • 7 天免费试用
    无需信用卡
  • 符合 GDPR,SOC 2 就绪
    数据驻留欧盟,审计日志
  • 在 GitHub 开源
    开源 · AGPL-3.0
  • 支持 ChatGPT、Claude、Gemini
    任何兼容 MCP 的客户端

跳过安装。2 分钟内即可运行。

在 cloud.anythingmcp.com 开始免费试用,一键添加 Smartsheet,然后将你的 AI 客户端(Claude、ChatGPT、Copilot 或 Cursor)指向生成的 MCP 端点。无需 Docker,无需 git clone,无需任何工程经验。

开始免费试用

AnythingMCP 已收录在 Claude 的连接器目录中:一键添加到 Claude (在新标签页中打开),然后登录并选择 Claude 可以使用哪些 MCP 服务器。

摘要

使用个人访问令牌的 Smartsheet API 2.0(US、EU、AU 或 Gov):搜索和读取表格、行、列、表格摘要和单元格历史、评论和附件、工作区、文件夹、报表和仪表板、用户和共享;添加和修改行与列、发表评论、创建表格、共享以及发送更新请求。删除行在安装时关闭。

试试这样问

Smartsheet 的示例提示

点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。

Smartsheet · 通过 MCP 实时
分享
Opus 4.7

Claude 是 AI,可能会出错。请核对回答。

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Smartsheet、粘贴凭证、生成 MCP API key,即可完成。无 Docker、无 git clone、无本地服务器。

Smartsheet + Claude

使用个人访问令牌的 Smartsheet API 2.0(US、EU、AU 或 Gov):搜索和读取表格、行、列、表格摘要和单元格历史、评论和附件、工作区、文件夹、报表和仪表板、用户和共享;添加和修改行与列、发表评论、创建表格、共享以及发送更新请求。删除行在安装时关闭。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

SMARTSHEET_API_URL, SMARTSHEET_ACCESS_TOKEN

步骤 1 — 获取凭证

设置大约需要 2 分钟。你需要一个带 API 访问权限的 Smartsheet 套餐(Pro、Business、Enterprise 或 Advanced Work Management)。

  1. 登录 Smartsheet,点击左下角的账户图标,打开 Apps & Integrations(或 Personal Settings),然后打开 API Access。
  2. 点击 Generate new access token,起一个名字(例如 AnythingMCP)并复制令牌。令牌只显示一次。
  3. 把它粘贴到 SMARTSHEET_ACCESS_TOKEN,不要带 Bearer 一词。
  4. 把 SMARTSHEET_API_URL 设为你账户所在区域的主机:app.smartsheet.com(US)用 https://api.smartsheet.com/2.0,app.smartsheet.eu 用 https://api.smartsheet.eu/2.0,app.smartsheet.au 用 https://api.smartsheet.au/2.0,Smartsheet Gov 用 https://api.smartsheetgov.com/2.0。令牌只能在其所属区域的主机上使用;在其他主机上 Smartsheet 会返回 401 “invalid access token”。
  5. 安装连接器并运行 smartsheet_get_current_user:它会显示令牌属于谁,并确认令牌可用。

以谁的权限运行:每次调用都以令牌所属用户的身份运行,使用该用户对各个表格的访问权限,令牌可以做该用户在 Smartsheet 中能做的一切。如果这一点很重要,请用一个只能访问 AI 应该看到的表格的专用用户来生成令牌。

可读取的内容:在用户能打开的所有内容中搜索(表格、报表、仪表板、文件夹、工作区和模板的名称、单元格数据、评论、附件和摘要字段),可用 scopes(例如 sheetNames)缩小范围;表格及其列(类型、下拉选项、主列)和行,每行包括行号、用于层级的父行以及以 value 和 displayValue 表示的单元格;单独一行;在一个表格内的文本搜索;表格摘要字段;单元格的修改历史,包括谁在何时修改;表格和行上的评论线程;附件,附带约 2 分钟有效的下载链接;工作区和文件夹及其内容;汇集多个表格行的报表,单元格按 virtualColumnId 标识;仪表板(API 中称为 sights)及其小组件;组织账户的用户(系统管理员可看到所有人,其他用户只能看到有限信息),以及某个项目与谁共享。

大表格:AI 先列出列以获取其 ID 和类型,然后读取一页行,或用 row_numbers、row_ids、column_ids 或 rows_modified_since 只读取部分行。

可写入的内容:smartsheet_add_rows 和 smartsheet_update_rows(只修改给定的单元格;位置字段会移动行),smartsheet_add_columns 和 smartsheet_update_column(更改列类型可能会转换或丢弃单元格值),在表格和行上新建评论线程及回复,在工作区或文件夹中用自定义列或复制模板、表格来新建表格,smartsheet_share_asset 和 smartsheet_create_update_request。这些工具在安装时即开启。带 send_email 的共享和更新请求会发送邮件,表格的关注者也可能收到新评论的通知,因此 AI 会先向你展示收件人、访问级别和内容,并等你同意。

写入单元格:单元格写作 {"columnId": <id>, "value": <value>}。DATE 接受 YYYY-MM-DD,CHECKBOX 接受 true 或 false,PICKLIST 接受其中一个选项(除非 strict 为 false,否则其他值会被拒绝),CONTACT_LIST 接受邮箱地址,数字按数字发送。公式写在 "formula": "=..." 中,而不是 value。新行需要指定位置:toBottom、toTop、parentId 或 siblingId。带列公式的列、系统列(自动编号、创建日期、修改人)和锁定的列不能写入。

安装时关闭:smartsheet_delete_rows,因为被删除的行连同其子行、附件和评论无法通过 API 恢复。团队需要时由管理员开启。

数据格式:表格、行、列、工作区、文件夹、报表和用户都有很长的数字 ID(最多 16 位),AI 会按返回的原样以文本传递。日期和时间为 UTC 的 ISO 8601;日期单元格为 YYYY-MM-DD。多联系人和多选单元格以文本返回,除非传入 level(2 或 3)和 include=objectValue。accessLevel 为 VIEWER、COMMENTER、EDITOR、EDITOR_SHARE、ADMIN 或 OWNER。写入调用返回 {"message": "SUCCESS", "resultCode": 0, "result": ...};resultCode 为 3 表示部分成功。

分页:表格、列、讨论、附件、用户和单元格历史用 page 和 page_size 分页(默认 100;响应中包含 totalPages 和 totalCount),也可用 include_all。工作区、工作区和文件夹的内容、仪表板以及共享用令牌分页:AI 把响应中的 lastKey 作为 last_key 传入,直到它不再出现。

限制:每个令牌每分钟 300 次请求,单元格历史每分钟 30 次。返回 429(错误代码 4003)表示需要等一分钟。批量行调用算作一次请求;请控制在几百行以内。

常见错误:401(代码 1002、1003、1004)表示令牌无效或已过期,或使用了其他区域的主机。403(1004)表示令牌的用户无权打开该项目:把它共享给该用户,或使用有访问权限的用户的令牌。404(1006)表示 ID 不存在或该用户看不到。400 会带有说明问题的 errorCode 和 message,例如值不在下拉列表中、新行没有位置,或向带列公式的列写入。

该连接器不上传文件,不删除表格或列,也不创建工作区或文件夹。

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Claude 中添加连接器

你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(https://cloud.anythingmcp.com/mcp/…)。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

推荐路径:在 claude.ai web 上工作,无需触碰任何配置文件。

  1. 在 Claude 中打开 Customize → Connectors。
  2. 点击 +,然后点击 Add custom connector。
  3. 输入名称(例如 Smartsheet)和远程 MCP 服务器 URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID,然后点击 Add。
  4. 点击 Connect,登录 AnythingMCP(OAuth)并允许访问。

下面所有工具都会出现在你的聊天中,开始输入提示。

可用工具

ToolWhat it does
smartsheet_get_current_userThe user the access token belongs to: id, email, name, account (organisation) id and name, admin flags, locale and time zone
smartsheet_list_sheetsList the sheets the user can open: id, name, access level, permalink, created and modified dates
smartsheet_get_sheetRead a sheet: its columns (id, title, type, options, primary) and rows, each row with id, rowNumber, parentId (for hierarchy) and cells as…
smartsheet_get_rowRead one row of a sheet with its cells (columnId, value, displayValue), parent and sibling ids and modification date. include=columns adds…
smartsheet_search_sheetSearch the text of one sheet: returns the matching rows (objectId is the row id, text shows the match, contextData the row content)
smartsheet_searchSearch everything the user can access: sheet, report, dashboard, folder, workspace and template names, cell data, comments, attachments and…
smartsheet_list_columnsList the columns of a sheet: id, index, title, type (TEXT_NUMBER, DATE, DATETIME, CHECKBOX, PICKLIST, MULTI_PICKLIST, CONTACT_LIST…
smartsheet_get_cell_historyThe change history of one cell: every earlier value with modifiedAt and modifiedBy, newest first
smartsheet_get_sheet_summaryRead the sheet summary fields of a sheet (the key-value fields shown in the Summary panel, often totals and project status): id, title…
smartsheet_list_discussionsList the discussions (comment threads) of a sheet, on the sheet itself and on its rows: id, title, parentType (SHEET or ROW), parentId…
smartsheet_list_row_discussionsList the discussions (comment threads) of one row
smartsheet_list_attachmentsList every attachment of a sheet (sheet, row and comment attachments): id, name, attachmentType (FILE, LINK, GOOGLE_DRIVE, ...), mimeType…
smartsheet_list_row_attachmentsList the attachments of one row, including those on its comments
smartsheet_get_attachmentGet one attachment with a temporary download URL (url, valid for urlExpiresInMillis milliseconds, usually 2 minutes) for files, or the link…
smartsheet_list_workspacesList the workspaces the user can access: id, name, access level and permalink
smartsheet_get_workspaceRead a workspace's metadata: id, name, access level, permalink, created and modified dates
smartsheet_list_workspace_childrenList what is directly inside a workspace: sheets, reports, dashboards (sights), folders and templates, each with id, name, resourceType and…
smartsheet_get_folderRead a folder's metadata: id, name, permalink, created and modified dates
smartsheet_list_folder_childrenList what is directly inside a folder: sheets, reports, dashboards, subfolders and templates
smartsheet_list_reportsList the reports the user can open: id, name, access level, permalink and whether it is a sheet summary report
smartsheet_get_reportRead a report: its columns (virtualId, title, type) and rows gathered from the source sheets, each row with sheetId and cells keyed by…
smartsheet_list_dashboardsList the dashboards (called sights in the API) the user can open: id, name, access level and permalink
smartsheet_get_dashboardRead a dashboard: its widgets (type, title, position and content such as the sheet or report a chart or metric reads, rich text, shortcuts…
smartsheet_list_usersList the users of the organisation account: id, email, name, status, admin and licensed-sheet-creator flags, seat type
smartsheet_get_userRead one user of the organisation: email, name, admin flags, status, title, department, sheet count
smartsheet_list_sharesList who a sheet, report, dashboard or workspace is shared with: each share with id, type (USER or GROUP), email or groupId, name…
smartsheet_add_rowsAdd rows to a sheet
smartsheet_update_rowsChange cells of existing rows, or move rows
smartsheet_delete_rowsDelete rows from a sheet, with their child rows, attachments and comments
smartsheet_add_columnsAdd columns to a sheet
smartsheet_update_columnChange a column: rename it, change its type or dropdown options, move it (index), hide or lock it, set a description, width, validation or…
smartsheet_create_discussionStart a comment thread on a sheet with a first comment
smartsheet_create_row_discussionStart a comment thread on one row of a sheet, with its first comment
smartsheet_add_commentReply to an existing discussion (comment thread) on a sheet or row
smartsheet_create_sheet_in_workspaceCreate a sheet at the top level of a workspace, either with your own columns (exactly one with "primary": true, usually TEXT_NUMBER) or as…
smartsheet_create_sheet_in_folderCreate a sheet inside a folder, with your own columns (exactly one primary) or as a copy of a template or sheet (from_id)
smartsheet_share_assetShare a sheet, report, dashboard or workspace with people (by email) or a group, at a given access level. send_email notifies them
smartsheet_create_update_requestEmail people an update request: a form where they can edit the given rows (and columns) without opening the sheet

示例提示

  • “列出 Project Tracker 表格中状态为 At Risk 的所有行,包括负责人和截止日期。”
  • “在 Marketing Calendar 表格底部添加一行:Webinar,2026-11-20,负责人 [email protected],状态 Planned。”
  • “谁修改了 Q4 Budget 表格第 14 行的预算单元格?之前的值是什么?”
  • “找出所有提到 Project Apollo 的表格、评论和附件。”
  • “读取 Website Relaunch 的表格摘要,告诉我整体状态和完成百分比。”

FAQ

Claude Code 和 Claude Desktop 一样工作吗? 是的,两者都指向 https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。

下一步

这份指南对你有帮助吗?

你的 Smartsheet 智能体只差一次点击。

安装连接器,粘贴密钥,向 Claude 提问。免费试用 7 天,无需信用卡。

相关指南

连接器

如何通过 MCP 将 Smartsheet 连接到 ChatGPT

使用个人访问令牌的 Smartsheet API 2.0(US、EU、AU 或 Gov):搜索和读取表格、行、列、表格摘要和单元格历史、评论和附件、工作区、文件夹、报表和仪表板、用户和共享;添加和修改行与列、发表评论、创建表格、共享以及发送更新请求。删除行在安装时关闭。

连接器

如何通过 MCP 将 Smartsheet 连接到 Microsoft Copilot

使用个人访问令牌的 Smartsheet API 2.0(US、EU、AU 或 Gov):搜索和读取表格、行、列、表格摘要和单元格历史、评论和附件、工作区、文件夹、报表和仪表板、用户和共享;添加和修改行与列、发表评论、创建表格、共享以及发送更新请求。删除行在安装时关闭。

连接器

如何通过 MCP 将 Smartsheet 连接到 Cursor

使用个人访问令牌的 Smartsheet API 2.0(US、EU、AU 或 Gov):搜索和读取表格、行、列、表格摘要和单元格历史、评论和附件、工作区、文件夹、报表和仪表板、用户和共享;添加和修改行与列、发表评论、创建表格、共享以及发送更新请求。删除行在安装时关闭。

连接器

如何通过 MCP 将 Smartsheet 连接到 Gemini

使用个人访问令牌的 Smartsheet API 2.0(US、EU、AU 或 Gov):搜索和读取表格、行、列、表格摘要和单元格历史、评论和附件、工作区、文件夹、报表和仪表板、用户和共享;添加和修改行与列、发表评论、创建表格、共享以及发送更新请求。删除行在安装时关闭。

连接器

如何通过 MCP 将 Smartsheet 连接到 Meta Muse

使用个人访问令牌的 Smartsheet API 2.0(US、EU、AU 或 Gov):搜索和读取表格、行、列、表格摘要和单元格历史、评论和附件、工作区、文件夹、报表和仪表板、用户和共享;添加和修改行与列、发表评论、创建表格、共享以及发送更新请求。删除行在安装时关闭。

连接器

Smartsheet 接入 MCP:在任意 AI 智能体中使用表格、行、报表和仪表板

使用个人访问令牌的 Smartsheet API 2.0(US、EU、AU 或 Gov):搜索和读取表格、行、列、表格摘要和单元格历史、评论和附件、工作区、文件夹、报表和仪表板、用户和共享;添加和修改行与列、发表评论、创建表格、共享以及发送更新请求。删除行在安装时关闭。