ui_menu_bar_click
Ecrã, janelas e interface · macOS · Windows
Efeito: execução. Estado: disponibilidade condicionada.
«Disponibilidade condicionada» significa que a ferramenta pode depender da versão, plataforma, permissões, conta ou configuração. Não significa que esteja ativa em todas as instalações.
macOS
Finalidade
Clica em um item da barra de status (barra de menu extra/NSStatusItem) e, opcionalmente, segue um caminho de menu aninhado. Melhor esforço por meio da barra de menu de extras AX do aplicativo; aplicativos que renderizam menus totalmente personalizados (não AX) podem não ser acessíveis (voltar para ui_click em coordenadas conhecidas). Requer permissão de acessibilidade.
Entradas obrigatórias
O esquema desta plataforma não declara entradas obrigatórias. Ainda podem existir seletores opcionais ou requisitos de execução.
Permissões e confirmação
O esquema não declara um parâmetro explícito de confirmação. Isto não autoriza qualquer ação sem permissão; reveja o efeito e obtenha autorização.
- Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.
Esquema técnico canónico em 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"
}Exemplo documental
Exemplo de documentação para ui_menu_bar_click. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.
{
"label": "Local MCP",
"path": [
"Local MCP",
"Settings…"
]
}Windows
Finalidade
Clica no ícone da área de notificação do Windows (bandeja do sistema) por rótulo – o análogo de um extra da barra de menu. Melhor esforço via UI Automation na bandeja da barra de tarefas; aplicativos que renderizam um ícone de bandeja totalmente personalizado podem não expor um rótulo (voltar para ui_click em coordenadas conhecidas). Alguns ícones ficam no submenu de estouro oculto, que não abre.
Entradas obrigatórias
O esquema desta plataforma não declara entradas obrigatórias. Ainda podem existir seletores opcionais ou requisitos de execução.
Permissões e confirmação
O esquema não declara um parâmetro explícito de confirmação. Isto não autoriza qualquer ação sem permissão; reveja o efeito e obtenha autorização.
- Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.
Esquema técnico canónico em 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"
}Exemplo documental
Exemplo de documentação para ui_menu_bar_click. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.
{
"label": "Local MCP"
}