Skip to main content
Flespiアカウントを接続することで、CloudThinkerエージェントがGPSデバイスの管理、テレメトリの監視、チャンネルとストリームの検査、Flespi MCPサーバーを通じたフリートインフラストラクチャの操作を行えるようになります。 Flespiは、Flespiパネルで生成したAPIトークン（StandardまたはACLタイプ）で認証します。

​
対応プラットフォーム

​
前提条件

  • flespi.io の Flespiアカウント。
  • APIトークンを作成・管理するためのFlespiパネルへのアクセス。
  • 本番ワークロードの場合、CloudThinkerが必要とするモジュールにスコープされた権限を持つACLトークン。

​
セットアップ

CloudThinkerはFlespi APIトークンを使用して、Flespiの公式MCPサーバー経由でFlespiに接続します。
1

Flespiアカウントを作成

アカウントをお持ちでない場合は、flespi.io でサインアップしてください。
2

APIトークンを生成

Flespiパネルで左メニューの Tokens に移動し、「+」 ボタンをクリックします:
  • Name: CloudThinker Agent
  • Type: Standard（開発用）またはACL（本番用）
  • TTL: 有効期限を設定（例: 7776000（90日））。FlespiはすべてのトークンにTTLまたは有効期限の設定を必須としています。
64バイトのトークンをすぐにコピーします。
3

CloudThinkerで接続を追加

Connections → Flespi に移動し、生成したトークンを入力します。
4

接続をテスト

Connect をクリックします。CloudThinkerがトークンを検証し、Connected ステータスを表示します。
Flespiは認証プレフィックスとして Bearer ではなく FlespiToken を使用します。CloudThinkerはこれを自動的に処理しますが、APIコールを手動でデバッグする際には留意してください。

​
接続の詳細

​
必要な権限

​
トークンタイプ

​
トークンの有効期限

Flespiはすべてのトークンに有効期限の設定を必須としています。以下のいずれかを設定してください:
  • ttl — 非活動状態になってからの有効期限（秒）（APIコールごとにリセット）
  • expire — ハード有効期限のUnixタイムスタンプ
長期的な統合には ttl（例: 7776000 = 90日）を使用してください。タイマーはAPIコールのたびにリセットされるため、アクティブなトークンが予期せず期限切れになることはありません。

​
推奨ACL権限（本番用）

読み取り専用（最小）: 読み取り/書き込み（書き込み操作が必要な場合）:
ACLトークンはデフォルトですべてを拒否します。明示的に付与された権限のみが許可されます。gw/devices にPOSTが付与されたトークンは、GETも別途付与されない限りGETを持ちません。

​
エージェント機能

接続後、エージェントは次のことができます:

​
利用可能なMCPツール

無料ツール（0クレジット）: 有料ツール:

​
AIクレジット

使用量はFlespiパネルの AIタイル、GET /ai/logs API、またはMQTTトピック flespi/log/ai/# で監視できます。

​
接続を確認

​
プロンプト例

​
トラブルシューティング

  • トークンが期限切れになっている可能性があります。Flespiパネルでの TTL と有効期限の設定を確認してください。
  • 新しいトークンを作成して、CloudThinkerの接続を更新してください。
  • 期限切れのトークンはflespiによって自動的に削除されます。
  • ACLトークンに必要なモジュール + HTTPメソッドの組み合わせが不足しています。
  • トークンのACLを更新して、必要な権限を付与してください。
  • ACLはデフォルトで全拒否です。各権限を明示的に付与する必要があります。
  • 月間AIクレジットが枯渇しています。
  • Freeプランの場合: 翌月まで待ちます。Commercialプランの場合: 超過設定を確認してください。
  • クレジット使用量は GET /ai/logs またはイベントコード 1710 で監視できます。
  • Flespiは1分あたりのAPI + MQTT + トラフィックの合計使用量を計算します。
  • リクエスト頻度を下げるかバッチ処理を行ってください。
  • 使用量が最も多いトークンが最初にブロックされます。他のトークンは引き続き動作します。
  • トークンにIPホワイトリストが設定されているが、サーバーIPが含まれていません。
  • FlespiパネルでトークンのIPホワイトリストを更新してください: Token settings → IPs whitelist。

​
セキュリティ

  • 最小権限 — エージェントがユースケースに必要な権限のみを付与します。まず読み取り専用から始め、後から拡張してください。
  • デフォルトで読み取り専用 — エージェントにこの接続で変更を行わせる場合を除き、読み取り専用の認証情報を使用してください。
  • 認証情報のローテーション — 通常のスケジュールに従ってキーとトークンをローテーションしてください。接続を更新すると、CloudThinker が新しい値を自動的に取得します。
  • オフボーディング時に失効 — 接続を削除するか、チームメンバーが退職する際には、プロバイダー側で認証情報を無効化してください。
  • 専用トークン — CloudThinker用に別個のトークンを作成し、統合間で共有したり、Masterトークンを使用したりしないでください
  • 本番環境ではACL — 必要最低限の権限のみを持つACLトークンを使用してください。ACLトークンはデフォルトで全拒否です

​
関連情報

MCP 接続

カスタムMCP統合

Kubernetes 接続

IoTワークロード向けコンテナオーケストレーション