tago-io

TagoIO | MCP 服务

只需提出请求，即可操作你的 TagoIO 账户。你的 AI 助手会读取设备、数据、仪表板和分析内容，并根据你的要求进行更改。你可以通过 IDE 或聊天工具使用。

---

从这里开始

1. 获取令牌。 在 TagoIO 个人资料设置中生成 Profile Token。
2. 将服务添加到客户端。 使用上方的安装按钮，或从客户端设置中复制适用于你的工具的配置。
3. 提出请求。 试试：“列出我的设备，并告诉我哪些设备本周停止发送数据。”

你的客户端会连接到由 TagoIO 托管的服务 https://mcp.ai.tago.io。你也可以自行运行服务。

你可以提出的请求

该服务为你的账户提供约 80 项专用功能。你描述想要的结果，助手会选择相应的工具。目前适用的场景包括：

了解你的设备群

• “过去 7 天内哪些设备没有发送数据？”
• “显示 Water Meter 12 最近 50 条记录，并总结流量变量。”
• “在我的 LoRaWAN 网络中创建设备，然后给我它的令牌。”

无需切换标签页即可调试

• “Daily Report 分析昨晚失败了。读取控制台并告诉我原因。”
• “修复你发现的错误，上传脚本，然后运行一次确认。”
• “有客户说他们的仪表板是空的。以该用户身份登录并检查他们看到的内容。”

根据描述构建仪表板

• “为我的冷链设备群构建一个仪表板：显示设备位置的地图、过去 24 小时的温度折线图，以及电池电量卡片。”
• “这个仪表没有显示数值。将它的配置与设备实际发送的变量进行比较。”

理清权限

• “我的分析在写入 Sites 实体时遇到权限错误。需要什么策略？”
• “显示所有涉及 TagoRUN 用户的访问策略。”

保持账户整洁

• “我本月的数据记录使用量距离上限还有多远？”
• “查找存储时间超过一年且大小超过 5 MB 的文件，然后删除它们。”

结合文档编写代码

• “查找解析 Dragino LHT65 载荷的官方示例，并针对我的设备进行调整。”

该服务可以读取和写入数据。删除数据、轮换凭据和上传脚本时，会通过助手的确认流程执行，因此每项更改都需要你批准后才会生效。

客户端设置

以下每项配置都指向托管服务。将 YOUR-TAGOIO-TOKEN 替换为你的 Profile Token。

客户端	配置所在位置
VS Code / GitHub Copilot	.vscode/mcp.json 或用户设置
Claude Code	claude mcp add-json CLI
Claude Desktop	~/Library/Application Support/Claude/claude_desktop_config.json（macOS）、%APPDATA%\Claude\claude_desktop_config.json（Windows）
Cursor	~/.cursor/mcp.json
Windsurf	~/.codeium/windsurf/mcp_config.json
JetBrains IDEs	设置 > 工具 > AI Assistant > MCP
Google Gemini CLI	~/.gemini/settings.json
Amazon Q CLI	~/.aws/amazonq/mcp.json
Warp	~/.warp/mcp.json
Kiro	.kiro/mcp.json
OpenAI Agents / ChatGPT	Agent Builder 界面

VS Code / GitHub Copilot

将配置添加到 .vscode/mcp.json，即可用于单个项目；添加到用户设置，则可用于所有项目。VS Code Insiders 使用相同的配置，Copilot 也会读取同一个文件。

{
  "servers": {
    "@tago-io/mcp": {
      "type": "http",
      "url": "https://mcp.ai.tago.io",
      "headers": {
        "Authorization": "Bearer ${input:tagoToken}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "tagoToken",
      "description": "TagoIO Profile Token",
      "password": true
    }
  ]
}

Claude Code

claude mcp add-json tagoio '{"type":"http","url":"https://mcp.ai.tago.io","headers":{"Authorization":"Bearer YOUR-TAGOIO-TOKEN"}}'

Claude Desktop

通过 mcp-remote 桥接连接。

{
  "mcpServers": {
    "@tago-io/mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.ai.tago.io",
        "--header",
        "Authorization: Bearer YOUR-TAGOIO-TOKEN"
      ]
    }
  }
}

Cursor

{
  "mcpServers": {
    "@tago-io/mcp": {
      "url": "https://mcp.ai.tago.io",
      "headers": {
        "Authorization": "Bearer YOUR-TAGOIO-TOKEN"
      }
    }
  }
}

Windsurf

{
  "mcpServers": {
    "@tago-io/mcp": {
      "serverUrl": "https://mcp.ai.tago.io",
      "headers": {
        "Authorization": "Bearer YOUR-TAGOIO-TOKEN"
      }
    }
  }
}

JetBrains IDEs

打开 Settings > Tools > AI Assistant > Model Context Protocol (MCP)，添加服务，然后粘贴：

{
  "servers": {
    "@tago-io/mcp": {
      "url": "https://mcp.ai.tago.io",
      "requestInit": {
        "headers": {
          "Authorization": "Bearer YOUR-TAGOIO-TOKEN"
        }
      }
    }
  }
}

Google Gemini CLI

{
  "mcpServers": {
    "@tago-io/mcp": {
      "httpUrl": "https://mcp.ai.tago.io",
      "headers": {
        "Authorization": "Bearer YOUR-TAGOIO-TOKEN"
      }
    }
  }
}

Amazon Q CLI

{
  "mcpServers": {
    "@tago-io/mcp": {
      "url": "https://mcp.ai.tago.io",
      "headers": {
        "Authorization": "Bearer YOUR-TAGOIO-TOKEN"
      }
    }
  }
}

Warp

通过 mcp-remote 桥接连接。

{
  "mcpServers": {
    "@tago-io/mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.ai.tago.io",
        "--header",
        "Authorization: Bearer YOUR-TAGOIO-TOKEN"
      ]
    }
  }
}

Kiro

通过 mcp-remote 桥接连接，并将配置放在项目根目录下的 .kiro/mcp.json 中。

{
  "mcpServers": {
    "@tago-io/mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.ai.tago.io",
        "--header",
        "Authorization: Bearer YOUR-TAGOIO-TOKEN"
      ]
    }
  }
}

OpenAI Agents / ChatGPT

在 Agent Builder 或 ChatGPT 的 MCP 设置中：

• 服务 URL：https://mcp.ai.tago.io
• 协议：Streamable HTTP
• 身份验证：Authorization: Bearer YOUR-TAGOIO-TOKEN 标头

选择令牌

令牌	获取位置	可访问范围
Profile	个人资料设置	整个个人资料。从这里开始。
Analysis	Analysis > 你的分析，将其设置为运行“External”	仅限该分析可访问的内容。适用于通过 IAM 控制访问权限的共享环境和生产环境。
Device	设备本身	该设备的数据。账户级请求会返回权限错误。

区域和端点

请求默认发送到 US East。设置 x-tagoio-region 标头即可访问其他端点：

值	目标
us-e1	US East（默认）
eu-w1	EU West
https://api.your-instance.io	你的专用 TagoDeploy 实例

x-tagoio-region: eu-w1

对于 TagoDeploy，请传入实例完整的 API 端点，且必须使用 https://。托管服务支持此方式，因此专用实例只需使用与公共区域相同的一行配置。

STDIO 不支持标头。请改为将 TAGOIO_API 设置为你的端点。

在本地运行

在自己的计算机上运行服务，以便离线工作，或在网络阻止出站连接时使用。安装 Node.js 22.12 或更高版本，然后：

npx -y @tago-io/mcp-server        # STDIO, what desktop apps and IDEs expect
npx -y @tago-io/mcp-server http   # HTTP on port 3000

STDIO 从环境中读取令牌：

{
  "mcpServers": {
    "@tago-io/mcp": {
      "command": "npx",
      "args": ["-y", "@tago-io/mcp-server"],
      "env": {
        "TAGOIO_TOKEN": "YOUR-TAGOIO-TOKEN"
      }
    }
  }
}

对于 Claude Code：

claude mcp add @tago-io/mcp-server -e TAGOIO_TOKEN=YOUR-TAGOIO-TOKEN -- npx -y @tago-io/mcp-server

HTTP 模式会在每个请求中接收令牌，因此多个人可以使用各自的凭据共享同一服务。使用 MCP_PORT 设置端口，并通过检查 GET /health 确认服务已启动。若要让本 README 中的任意配置指向本地服务，请将 URL 替换为 http://localhost:3000。运行 npx -y @tago-io/mcp-server --help 查看完整选项列表。

编写自定义小组件

自定义小组件是 React 组件，必须严格遵循编写规范：使用 provider 包装器、固定 npm: 依赖项，并添加 // tailwind 标记。服务会根据此规范验证代码，并报告不符合要求之处。

自定义小组件技能通过实际示例讲解这套规范。为 Claude Code 安装该技能：

# all projects
mkdir -p ~/.claude/skills/custom-widget-development
curl -fsSL https://raw.githubusercontent.com/tago-io/mcp-server/master/skills/custom-widget-development/SKILL.md \
  -o ~/.claude/skills/custom-widget-development/SKILL.md

# one project
mkdir -p .claude/skills/custom-widget-development
curl -fsSL https://raw.githubusercontent.com/tago-io/mcp-server/master/skills/custom-widget-development/SKILL.md \
  -o .claude/skills/custom-widget-development/SKILL.md

对于其他客户端，请将同一文件放到该客户端加载技能或可复用提示词的位置。

你的令牌和数据

在结果、错误、脚本下载和控制台输出到达助手之前，服务会从中剥离你的令牌。环境变量值、生成的 analysis 令牌和签名文件 URL 也会进行同样处理。

部分设置仍需在 TagoIO 管理后台中配置：TagoRUN 环境配置、SSO 和自定义域名、测试邮件，以及匿名用户创建。

故障排除

无法连接。 确认令牌仍然有效，并且你的网络可以访问 https://mcp.ai.tago.io。如果账户位于 EU West，请设置 x-tagoio-region 标头。

身份验证错误。 使用 HTTP 时，标头应为 Bearer YOUR-TOKEN，中间要有空格。使用 STDIO 时，令牌应放在 TAGOIO_TOKEN 中。如果格式无误，令牌可能缺少访问所请求内容的权限。

请求返回空结果。 通常有两个原因：设备在你指定的时间范围内没有数据，或者你的个人资料无权访问该设备。

桥接程序失败（Claude Desktop、Warp、Kiro）。检查是否安装了 Node.js 22.12 或更高版本，然后手动运行桥接程序以查看实际错误：

npx -y mcp-remote https://mcp.ai.tago.io --header "Authorization: Bearer YOUR-TOKEN"

完整工具参考

服务按领域分组公开的所有工具。每个工具都有自己的参数、限制，以及客户端读取的描述中标注的读取或写入属性。

Domain	Tools
Devices	search_devices, get_device, create_device, update_device, delete_device, configure_device
Device data	read_device_data, send_device_data, edit_device_data, delete_device_data
Actions	search_actions, get_action, create_action, update_action, delete_action
Analyses	search_analyses, get_analysis, create_analysis, update_analysis, delete_analysis, upload_analysis_script, download_analysis_script, run_analysis, read_analysis_console
Dashboards & widgets	search_dashboards, get_dashboard, create_dashboard, update_dashboard, delete_dashboard, get_widget, create_widget, update_widget, delete_widget, widget_schema_lookup, validate_widget_configuration, get_custom_widget_code, upload_custom_widget_code
Entities	search_entities, get_entity, create_entity, update_entity, delete_entity, update_entity_schema
Entity data	read_entity_data, send_entity_data, edit_entity_data, delete_entity_data, empty_entity_data
Run users	search_run_users, get_run_user, create_run_user, update_run_user, delete_run_user, login_as_run_user
Run-user notifications	read_run_user_notifications, send_run_user_notification, update_run_user_notification, delete_run_user_notification
Files	search_files, delete_files
Access management	search_access_policies, get_access_policy, lookup_access_permissions, create_analysis_access_policy, create_run_user_access_policy, update_analysis_access_policy, update_run_user_access_policy, delete_access_policy
Profile	get_profile, get_profile_limits, get_profile_statistics, search_secrets
Connectors & networks	search_connectors, get_connector, search_networks, get_network
Docs & examples	platform_overview, search_docs, read_doc, search_code_examples, get_code_example

参与贡献

欢迎提交问题和拉取请求。Agent 指南见 AGENTS.md。

许可证

MIT。请参阅 LICENSE 文件。

---

由 TagoIO 团队打造。需要帮助？请查看 TagoIO 文档 或联系支持团队。