接続済みアプリ

コアプラットフォーム

connected_apps_readAIエージェント

AIエージェントデバイスが接続している外部アプリ（メール、カレンダー、CRM、メッセージングなど）とそのアカウント、組み込みの Performance Hub サービス、おすすめのアプリ、保留中の接続リクエストを表示します。接続は1台のエージェントデバイスに属します。接続可能なアプリとその slug を探すには search を渡します。接続済みアプリのツールは、別の "connected_apps" MCP サーバーを通じて実行されます（PH_APPS_SEARCH_TOOLS、次に PH_APPS_MULTI_EXECUTE_TOOL）。

アクション:

list: Connected Apps を一覧表示します。接続済みアプリごとに各アカウント（id、alias、healthy）を表示します。そのアプリのツールを実行するときは、alias または id を account として渡してください。

パラメーター

名前	種類	説明
`action`*	`"list"`	実行する操作です。各操作はツールの説明に記載されています。
`deviceId`	`string`	device_inventory_read から取得した AIエージェントの deviceUuid。エージェントは自身を対象に動作するため省略します。施設にエージェントが1台だけの場合、人も省略できます。
`search`	`string`	名前、slug、カテゴリ、説明でカタログ全体を検索します。例: "accounting"
`facilityId`	`string`	施設 ID。接続中の施設が対象の場合は省略できます。

connected_apps_writeAIエージェント

外部アプリのツールを使えるよう、AIエージェントデバイスへのアプリの接続を依頼します。まず connected_apps_read でアプリの slug を探してください。エージェントのオーナーとチャット中の人に通知し（アプリごとに1日1回まで）、チャット用の接続リンクを返します。そのリンクからサインインした人が、エージェントが操作に使うアカウントになるため、共有には注意してください。

アクション:

request_connect: 接続をリクエストします。既に接続済みのアプリでは、別のアカウントを追加するために alias を渡さない限り、代わりにそのアカウントを返します。toolkit が必要です。

パラメーター

名前	種類	説明
`action`*	`"request_connect"`	実行する操作です。各操作はツールの説明に記載されています。
`deviceId`	`string`	device_inventory_read から取得した AIエージェントの deviceUuid。エージェントは自身を対象に動作するため省略します。施設にエージェントが1台だけの場合、人も省略できます。
`toolkit`	`string`	connected_apps_read の list または search から取得したアプリの slug
`reason`	`string`	エージェントがアプリを必要とする理由。通知を受ける人に表示されます
`alias`	`string`	既に接続済みのアプリに追加するアカウントのラベル。例: 受信トレイのアドレス
`facilityId`	`string`	施設 ID。接続中の施設が対象の場合は省略できます。