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

​
対応プラットフォーム

プラットフォームサポート
Flespi Free月1,000 AIクレジット
Flespi Commercial月1,000 AIクレジット + 有料超過分

​
前提条件

  • 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 TokenFlespiのAPIトークン（64バイト）7Bf3...xK9z

​
必要な権限

​
トークンタイプ

タイプアクセスレベル使用場面
StandardすべてのTelematicsエンティティ（デバイス、チャンネル、ストリーム、プラグイン、ジオフェンス、カリキュレーター）へのフルCRUD開発・テスト
ACL細粒度 — デフォルトで全拒否、モジュール/メソッド/アイテム単位で付与本番推奨
MasterプラットフォームAPIを含む完全な管理者権限AIエージェントでは絶対に使用しない

​
トークンの有効期限

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

​
推奨ACL権限（本番用）

読み取り専用（最小）:
モジュールメソッド目的
gw/devicesGETデバイス一覧、ステータス、テレメトリ、メッセージ
gw/channelsGETチャンネル一覧、設定、ステータス
gw/streamsGETストリーム一覧、ヘルス、デリバリー統計
gw/calculatorsGETカリキュレーター設定
aiPOSTMCPツールコールに必要
読み取り/書き込み（書き込み操作が必要な場合）:
モジュールメソッド目的
gw/devicesGET, POST, PUTデバイスの作成/更新
gw/channelsGET, POST, PUTチャンネルの作成/更新
gw/streamsGET, POST, PUT, DELETEストリームのフル管理
ACLトークンはデフォルトですべてを拒否します。明示的に付与された権限のみが許可されます。gw/devices にPOSTが付与されたトークンは、GETも別途付与されない限りGETを持ちません。

​
エージェント機能

接続後、エージェントは次のことができます:
機能説明
デバイス管理デバイスの一覧表示、ステータス確認、テレメトリとメッセージ履歴の読み取り
チャンネル監視チャンネルの設定、ステータス、接続プロトコルの検査
ストリームヘルスストリームのデリバリー統計とヘルスの監視
フリートテレメトリデバイス横断でGPS位置、速度、燃料、センサーデータをクエリ
ジオフェンスジオフェンスゾーンとトリガーの表示・管理
カリキュレーター走行検出、燃料消費などのカリキュレーター設定を検査

​
利用可能なMCPツール

無料ツール（0クレジット）:
ツール説明
search-api-methods自然言語クエリでflespi REST APIメソッドを探索
get-api-schema特定APIメソッドの完全なSwaggerスキーマを取得
flespi-api-readflespi REST APIへの読み取り専用GETリクエストを実行
flespi-api-write書き込み操作（POST/PUT/PATCH/DELETE）を実行
有料ツール:
ツールクレジット説明
search-flespi-documentation5flespiプラットフォームドキュメントを検索
search-device-documentation10デバイス/プロトコルメーカーのドキュメントを検索
generate-flespi-expression2セレクターやカリキュレーター用のflespi式を生成
generate-pvm-code10PVM（Protocol Virtual Machine）コードを生成
consult-flespi-account30アカウント読み取りアクセス付きのflespi AIエキスパートに複雑な分析を委任

​
AIクレジット

プラン月間無料クレジット超過分
Free1,000翌月まで利用不可
Commercial1,000追加100クレジットあたり€1
使用量はFlespiパネルの AIタイル、GET /ai/logs API、またはMQTTトピック flespi/log/ai/# で監視できます。

​
接続を確認

@alex list all Flespi devices and report their last known positions

​
プロンプト例

@alex check stream health and identify any delivery failures
@alex query telemetry for device 12345 over the last 24 hours
@alex list geofences and check which devices are inside zone "warehouse-01"

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

  • トークンが期限切れになっている可能性があります。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トークンはデフォルトで全拒否です

​
関連情報

https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/mcp.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=c89b6087a9d233901dea5e354452eff6

MCP 接続

カスタムMCP統合
https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/kubernetes.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=7c03292954ff635a1994623a5c39971b

Kubernetes 接続

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