Smartsheet MCP Server

基本能力

产品定位

Smartsheet MCP Server 是一个连接 AI 系统与 Smartsheet 协作平台的中间件，提供标准化的自动化操作接口。

核心功能

• 智能集成：无缝连接 AI 系统与 Smartsheet
• 数据完整性：强制执行验证规则和维护引用完整性
• 公式管理：自动维护和更新公式引用
• 灵活配置：支持多种列类型和复杂数据结构
• 错误恢复：多层级的全面错误处理和验证
• 医疗健康分析：临床和研究数据的专业分析能力
• 批量处理：高效处理大型医疗健康数据集
• 自定义评分：医疗健康计划和研究的灵活评分系统

适用场景

1. 临床研究分析
2. 协议合规性评分
3. 患者数据分析
4. 研究影响评估
5. 医院运营
6. 资源利用分析
7. 患者满意度评分
8. 医疗健康创新
9. 儿科对齐评分
10. 创新影响评估
11. 自动化文档管理
12. 程序化修改表格结构
13. 动态列创建和管理
14. 数据操作
15. 批量数据更新
16. 智能重复检测
17. 系统集成
18. AI驱动的表格定制
19. 自动化报告工作流

工具列表

1. get_column_map：获取列映射和样本数据
2. smartsheet_write：写入新行到 Smartsheet
3. smartsheet_update：更新现有行
4. smartsheet_delete：删除行
5. smartsheet_add_column：添加新列
6. smartsheet_delete_column：删除列
7. smartsheet_rename_column：重命名列
8. smartsheet_bulk_update：基于规则的条件批量更新
9. start_batch_analysis：批量分析处理
10. get_job_status：跟踪批量分析进度
11. cancel_batch_analysis：取消运行中的批量分析作业

常见问题解答

1. 如何获取 Smartsheet API 密钥？
2. 登录 Smartsheet → 账户 → 个人设置 → API 访问 → 生成新访问令牌
3. 如何验证安装？
4. 服务器启动时应输出"Smartsheet MCP server running on stdio"
5. 使用 MCP 工具测试连接
6. 检查 Python 环境是否安装了 smartsheet 包
7. 如何处理错误？
8. 服务器实现了多层错误处理
9. 提供详细的错误日志和响应信息
10. 包含协议级、命令行和操作层的错误处理

使用教程

使用依赖

1. Node.js 和 npm
2. Conda（用于环境管理）
3. Smartsheet API 访问令牌

安装教程

1. 创建专用 conda 环境：

conda create -n cline_mcp_env python=3.12 nodejs -y
conda activate cline_mcp_env

1. 安装 Node.js 依赖：

npm install

1. 安装 Python 包：

cd smartsheet_ops
pip install -e .
cd ..

1. 构建 TypeScript 服务器：

npm run build

调试方式

1. 启动服务器进行测试：

conda activate cline_mcp_env
PYTHON_PATH=/Users/[username]/anaconda3/envs/cline_mcp_env/bin/python3 SMARTSHEET_API_KEY=your-api-key node build/index.js

1. 使用 MCP 工具测试连接
2. 检查错误日志（输出到 stderr）
3. 查看详细的 MCP 响应信息

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。