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文檔 或聯繫我們的支持團隊。