ui_menu_bar_click

Pantalla, ventanas e interfaz · macOS · Windows

Efecto: ejecución. Estado: disponibilidad controlada.

«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.

macOS

Propósito

Hace clic en un elemento de la barra de estado (extra de la barra de menú / NSStatusItem, los iconos a la derecha de la barra de menú) y, opcionalmente, sigue una ruta (`path`) de menú anidada. NO hace clic en los comandos de la barra de menú propia de una aplicación (Archivo, Edición, Visualización…): para esos use ui_find_element + ui_click o ui_keystroke. Mejor esfuerzo a través de la barra de menú de extras de AX de la aplicación; Es posible que no se pueda acceder a las aplicaciones que muestran menús totalmente personalizados (no AX) (recurra a ui_click en coordenadas conocidas). Requiere permiso de accesibilidad.

Entradas obligatorias

El esquema de esta plataforma no declara entradas obligatorias. Aun así, pueden existir selectores opcionales o requisitos de ejecución.

Permisos y confirmación

El esquema no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.

Utilice únicamente las aplicaciones, cuentas y recursos autorizados por el usuario en esta plataforma. Consulte la descripción específica de la plataforma de esta herramienta para conocer sus requisitos de conexión y permisos. Este catálogo no afirma alcances OAuth adicionales ni derechos de sistema operativo.

Esquema técnico canónico en inglés — 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"
}

Ejemplo documental

Ejemplo de documentación para ui_menu_bar_click. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

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

Windows

Propósito

Hace clic en un icono del área de notificación de Windows (bandeja del sistema) por su etiqueta, el equivalente a un extra de la barra de menús. Con el mejor esfuerzo, mediante UI Automation sobre la bandeja de la barra de tareas; las apps que dibujan un icono de bandeja totalmente personalizado pueden no exponer una etiqueta (recurre a ui_click en coordenadas conocidas). Algunos iconos están en el menú de desbordamiento oculto, que esta herramienta no abre. Sin etiqueta no hace clic en nada y se rechaza con invalid_params.

Entradas obligatorias

El esquema de esta plataforma no declara entradas obligatorias. Aun así, pueden existir selectores opcionales o requisitos de ejecución.

Permisos y confirmación

El esquema no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.

Utilice únicamente las aplicaciones, cuentas y recursos autorizados por el usuario en esta plataforma. Consulte la descripción específica de la plataforma de esta herramienta para conocer sus requisitos de conexión y permisos. Este catálogo no afirma alcances OAuth adicionales ni derechos de sistema operativo.

Esquema técnico canónico en inglés — 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"
}

Ejemplo documental

{
  "label": "Local MCP"
}