ui_menu_bar_click

Bildschirm, Fenster und Oberfläche · macOS · Windows

Wirkung: Ausführen. Status: bedingt verfügbar.

„Bedingte Verfügbarkeit“ bedeutet, dass das Werkzeug von Version, Plattform, Berechtigungen, Konto oder Konfiguration abhängen kann. Es ist nicht in jeder Installation aktiv.

macOS

Zweck

Klickt auf ein Statusleistenelement (Menüleisten-Extra / NSStatusItem, die Symbole rechts in der Menüleiste) und folgt optional einem verschachtelten Menüpfad. Es klickt NICHT auf die eigenen Menüleistenbefehle einer Anwendung (Ablage, Bearbeiten, Darstellung …): Verwenden Sie dafür ui_find_element + ui_click oder ui_keystroke. Nach bestem Bemühen über die AX-Extras-Menüleiste der App; Apps, die vollständig benutzerdefinierte (nicht AX) Menüs rendern, sind möglicherweise nicht erreichbar (weichen Sie dann auf ui_click an bekannten Koordinaten aus). Erfordert die Berechtigung „Barrierefreiheit“.

Erforderliche Eingaben

Das Schema dieser Plattform deklariert keine erforderlichen Eingaben. Optionale Selektoren oder Laufzeitanforderungen können dennoch gelten.

Berechtigungen und Bestätigung

Das Schema deklariert keinen ausdrücklichen Bestätigungsparameter. Das erlaubt keine Handlung ohne Zustimmung; prüfen Sie die Wirkung und holen Sie eine Autorisierung ein.

Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

Kanonisches technisches Schema auf Englisch — 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"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für ui_menu_bar_click. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

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

Windows

Zweck

Klickt per Beschriftung ein Symbol im Windows-Infobereich (System Tray) – das Gegenstück zu einem Menüleisten-Extra. Nach bestem Bemühen über UI Automation auf dem Taskleisten-Tray; Apps, die ein vollständig eigenes Tray-Symbol zeichnen, geben möglicherweise keine Beschriftung preis (weichen Sie dann auf ui_click mit bekannten Koordinaten aus). Manche Symbole liegen im versteckten Überlauf-Flyout, das dies nicht öffnet. Ohne label klickt es nichts und lehnt mit invalid_params ab.

Erforderliche Eingaben

Das Schema dieser Plattform deklariert keine erforderlichen Eingaben. Optionale Selektoren oder Laufzeitanforderungen können dennoch gelten.

Berechtigungen und Bestätigung

Das Schema deklariert keinen ausdrücklichen Bestätigungsparameter. Das erlaubt keine Handlung ohne Zustimmung; prüfen Sie die Wirkung und holen Sie eine Autorisierung ein.

Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

Kanonisches technisches Schema auf Englisch — 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"
}

Dokumentationsbeispiel

{
  "label": "Local MCP"
}