MCP Server

🚀 TagoIO | MCP Server

TagoIO MCP Serverは、AIモデルがTagoIOアカウントと直接やり取りできるようにします。デバイス、データ、およびプラットフォームリソースへのコンテキストアクセスを提供し、開発ワークフローの向上と高度なデータ分析を実現します。

✨ 主な機能

• デバイス管理：デバイス情報、設定、およびリアルタイムデータにアクセスできます。
• データ分析：保存されたデータに対して統計演算（合計、平均、レポート）を実行できます。
• プラットフォーム統合：ユーザー、アクション、分析スクリプト、およびアカウント統計を取得できます。
• コード生成：適切なコンテキストを持ったAI駆動のTagoIO分析スクリプト生成が可能です。
• 開発サポート：デバッグ支援とタグ関係分析を提供します。

🚀 クイックスタート

前提条件

• Node.js 18以上がインストールされていること (https://nodejs.org/en/download/)
• 有効なプロファイルトークンまたは分析トークンを持つ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 Desktop

1. Claude Desktopをダウンロードしてインストールします。
2. 上記のMCP設定をコピーします。
3. プロンプトを送信します：「Hey Claude, install the following MCP Server」と設定を添えて。
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ドキュメントを参照するか、サポートチームにお問い合わせください。