MCP Server

🚀 TagoIO | MCP服务器

TagoIO MCP服务器使AI模型能够直接与你的TagoIO账户进行交互，为设备、数据和平台资源提供上下文访问，以优化开发工作流程并实现智能数据分析。

✨ 主要特性

• 设备管理：访问设备信息、配置和实时数据
• 数据分析：对存储的数据执行统计操作（求和、求平均值、生成报告）
• 平台集成：检索用户、操作、分析脚本和账户统计信息
• 代码生成：借助AI生成具有适当上下文的TagoIO分析脚本
• 开发支持：提供调试协助和标签关系分析

🚀 快速开始

前提条件

• 已安装Node.js 18+（下载地址）
• 拥有有效的TagoIO账户，具备有效的配置文件令牌或分析令牌
• 兼容的AI平台或集成开发环境（IDE）（见支持的平台）

📦 安装指南

手动配置

创建或更新你的MCP配置文件：

{
  "mcpServers": {
    "@tago-io/mcp": {
      "command": "npx",
      "args": ["-y", "@tago-io/mcp-server"],
      "env": {
        "TAGOIO_TOKEN": "YOUR-TOKEN",
        "TAGOIO_API": "https://api.us-e1.tago.io"
      }
    }
  }
}

配置参数：

• 将 YOUR-TOKEN 替换为你的TagoIO配置文件令牌或分析令牌。
  • 为提高安全性，建议使用分析令牌，因为你可以将令牌的权限限制为仅访问所需的资源。你的分析必须设置为“外部”运行，以便使用该令牌。
  • 使用配置文件令牌将立即授予MCP访问你整个配置文件的权限，但不建议在生产环境中使用。
• 对于欧洲账户，请将API端点更新为 https://api.eu-w1.tago.io。

特定平台设置

Claude桌面版

1. 下载并安装Claude桌面版。
2. 复制上述MCP配置。
3. 发送提示信息：“嘿，Claude，安装以下MCP服务器”，并附上配置。
4. Claude将自动安装并配置服务器。

开发IDE一键安装

或者将配置文件放置在你的IDE的适当位置，然后重新启动应用程序。

📚 详细文档

身份验证

MCP服务器需要一个TagoIO配置文件令牌进行身份验证：

1. 登录到你的TagoIO账户。
2. 导航到账户设置 → 配置文件令牌。
3. 生成一个具有适当权限的新令牌。
4. 在配置中替换 YOUR-PROFILE-TOKEN。

⚠️ 重要提示

请妥善保管你的配置文件令牌，切勿将其提交到版本控制系统。

API端点

服务器支持美国和欧洲的TagoIO实例：

• 美国东部：https://api.us-e1.tago.io（默认）
• 欧洲西部：https://api.eu-w1.tago.io

故障排除

常见问题

• 连接失败
  • 检查你的配置文件令牌是否有效。
  • 确保你使用的是适合你所在地区的正确API端点。
• 身份验证错误
  • 确认配置文件或分析令牌具有必要的权限。
  • 验证配置文件中的令牌格式是否正确。
• 数据访问问题
  • 检查你TagoIO账户中的设备权限。
  • 确保设备有最近可用的数据。

📄 许可证

本项目采用MIT许可证 - 有关详细信息，请参阅LICENSE文件。

需要帮助？ 访问 TagoIO文档 或联系我们的支持团队。