AI导哈

Smartsheet集成服务器

一个用于与Smartsheet API集成的模型上下文协议（MCP）服务器，允许AI助手通过标准化接口与Smartsheet数据进行交互。

  • by mattjhughes
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 mattjhughes/mcp-smartsheet

使用说明

智能表MCP服务器

模型上下文协议（MCP）服务器，用于与Smartsheet API集成。该服务器允许AI助手通过标准化的界面与Smartsheet数据进行交互。

特性

  • 列出可用图纸：查看所有可访问的Smartsheet电子表格
  • 读取工作表数据：访问特定表格的内容
  • 增加行：向电子表格添加新行
  • 更新行：更新现有行数据
  • 列出列：获取工作表的列信息
  • 搜索：在所有工作表中搜索特定文本

先决条件

  • Node.js（v16或更高版本）
  • npm或纱线
  • Smartsheet API令牌（从Smartsheet UI生成）

安装

  1. 克隆此存储库：

    git clone https://github.com/yourusername/smartsheet-mcp-server.git
cd smartsheet-mcp-server

  2. 安装依赖项：

    npm install

  3. 构建项目：

    npm run build

用法

运行服务器

SMARTSHEET_API_TOKEN=your_api_token npm start

MCP配置

MCP配置示例见 example-mcp-config.json:

{
  "mcpServers": {
    "smartsheet": {
      "command": "node",
      "args": ["./dist/index.js"],
      "env": {
        "SMARTSHEET_API_TOKEN": "YOUR_API_KEY_HERE"
      }
    }
  }
}

此配置可用于任何兼容MCP的客户端。

用Claude运行服务器

Claude的示例配置文件提供在 example-claude-config.json:

{
  "mcpServers": {
    "smartsheet": {
      "command": "node",
      "args": ["/path/to/mcp-smartsheet/dist/index.js"],
      "env": {
        "SMARTSHEET_API_TOKEN": "YOUR_SMARTSHEET_API_TOKEN"
      }
    }
  }
}
  1. 复制 example-claude-config.json 前往您选择的地点
  2. 替换 /path/to/mcp-smartsheet 安装的实际路径
  3. 替换 YOUR_SMARTSHEET_API_TOKEN 使用您的实际Smartsheet API令牌
  4. 配置Claude以使用此配置文件

如何获取Smartsheet API代币

  1. 登录您的Smartsheet帐户
  2. 前往账户>个人设置>API访问
  3. 点击“生成新的访问令牌”
  4. 复制令牌（您将无法再次看到它）

可用工具

服务器为AI助手提供以下工具：

  • listSheets：获取所有可用工作表的列表
  • getSheet：获取工作表的完整内容，包括行和单元格
  • addRow：在工作表中添加新行
  • updateRow：更新工作表中的现有行
  • list列：获取工作表的列定义
  • 搜索表：在工作表中搜索特定文本

安全考虑

  • 永远不要将Smartsheet API令牌提交到存储库
  • 使用环境变量或安全配置服务来管理API令牌
  • 考虑在Smartsheet帐户上设置适当的访问控制
  • 服务器在您的计算机上本地运行

贡献

欢迎投稿！请随时提交拉取请求。

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

相关 MCP