ui_menu_bar_click

画面、ウインドウ、UI · macOS · Windows

効果: 実行. 状態: 条件付き提供.

「条件付き提供」は、バージョン、プラットフォーム、権限、アカウント、設定に依存する可能性を示し、すべての環境で有効という意味ではありません。

macOS

目的

ステータスバー項目（メニューバー追加項目 / NSStatusItem、メニューバー右側のアイコン）をクリックし、任意で入れ子のメニューパスをたどります。アプリケーション自身のメニューバーコマンド（File、Edit、View…）はクリックしません。それらには ui_find_element + ui_click または ui_keystroke を使ってください。アプリの AX extras メニューバー経由のベストエフォートです。完全なカスタム描画で AX 非対応のメニューには到達できない場合があります（その場合は既知の coords で ui_click を使ってください）。アクセシビリティ権限が必要です。

必須入力

このプラットフォームのスキーマには必須入力が宣言されていません。任意の選択項目や実行要件が存在する場合があります。

権限と確認

スキーマには明示的な確認パラメータがありません。これは無許可の操作を認めるものではありません。効果を確認し、承認を得てください。

このプラットフォームでは、ユーザーが許可したアプリ、アカウント、リソースだけを使用してください。接続と権限の要件については、このツールのプラットフォーム固有の説明を参照してください。このカタログは、追加の OAuth スコープや OS 権限があるとは主張しません。

英語の正規技術スキーマ — macOS

{
  "properties": {
    "app_bundle_id": {
      "description": "Owner of the status item.",
      "type": "string"
    },
    "label": {
      "description": "Status item / menu item title.",
      "type": "string"
    },
    "path": {
      "description": "Nested menu path, e.g. [\"App\",\"Settings…\"].",
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [],
  "type": "object"
}

ドキュメント例

ui_menu_bar_click のドキュメント例です。この例は実行しないでください。表示される引数は架空のデータセットに属します。実際に呼び出す前に実在する識別子を確認し、承認を得てください。

{
  "label": "Local MCP",
  "path": [
    "Local MCP",
    "Settings…"
  ]
}

Windows

目的

Windows の通知領域（システムトレイ）のアイコンを、ラベルでクリックします。メニューバーエクストラに相当します。タスクバーのトレイに対する UI Automation によるベストエフォートの操作です。完全に独自のトレイアイコンを描画するアプリは、ラベルを公開しないことがあります（その場合は、既知の座標で ui_click にフォールバックしてください）。一部のアイコンは非表示のオーバーフローフライアウトにあり、これはそれを開きません。label がない場合は何もクリックせず、invalid_params で拒否します。

必須入力

このプラットフォームのスキーマには必須入力が宣言されていません。任意の選択項目や実行要件が存在する場合があります。

権限と確認

スキーマには明示的な確認パラメータがありません。これは無許可の操作を認めるものではありません。効果を確認し、承認を得てください。

このプラットフォームでは、ユーザーが許可したアプリ、アカウント、リソースだけを使用してください。接続と権限の要件については、このツールのプラットフォーム固有の説明を参照してください。このカタログは、追加の OAuth スコープや OS 権限があるとは主張しません。

英語の正規技術スキーマ — Windows

{
  "properties": {
    "button": {
      "description": "Default left (right opens the icon's context menu).",
      "enum": [
        "left",
        "right"
      ],
      "type": "string"
    },
    "label": {
      "description": "Tray icon tooltip/name to match.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

ドキュメント例

{
  "label": "Local MCP"
}