mcpField
A
azure-search-nav

azure-search-nav

github.com/microsoftCloud & DevOps1.6k95 installsUpdated today
Repository

About azure-search-nav

A skill that builds Azure Portal navigation links from a resource URL or ARM resource ID and a search query. It uses PowerShell with Az.Accounts authentication to find matching portal blades for supported resource types.

Key features

  1. 01Accept portal URLs or ARM resource IDs
  2. 02Search Azure Portal navigation items
  3. 03Authenticate with browser or device code
  4. 04Return portal deep links
  5. 05Support configured resource types

Use cases

  1. 01Find a blade for a supported Azure resource
  2. 02Locate a portal menu for an operation
  3. 03Create a deep link from an ARM resource ID

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/microsoft/azure-skills --skill azure-search-nav

After installing, type/azure-search-navin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
Invoke-PortalSearchNav.ps1
README.md
resource-types.json

Details

From the project README

Azure Portal Search Link Builder

Quick Reference

ItemValue
Scriptreferences/Invoke-PortalSearchNav.ps1
Resource mapreferences/resource-types.json
PrerequisiteAz.Accounts PowerShell module
AuthInteractive Microsoft sign-in (Connect-AzAccount), or device-code with -UseDeviceAuthentication

When to Use This Skill

  • User asks to find where in the Azure portal to perform an operation on a supported Container Service, Arc-enabled Kubernetes, or Compute resource.
  • User wants a portal deep link for a specific blade/menu item.
  • User provides a resource URL or ARM resource ID and a natural-language search query.

Workflow

  1. Collect resource link (portal URL or bare ARM resource ID) and search query from the user.
  2. Run references/Invoke-PortalSearchNav.ps1 -ResourceUrl '<link>' -Query '<query>'.
  3. The script signs in (browser by default; pass -UseDeviceAuthentication in headless/CLI environments), calls the search API, and prints portal deep links always rooted at https://portal.azure.com.

See references/README.md for full parameter reference and API details.

Error Handling

ErrorCauseFix
Resource type not enabledarmProvider not in references/resource-types.jsonConfirm the type is in the enabled-provider list
401 from APIInvalid token, or wrong tenant selectedRe-run and select the account with access to the target subscription's tenant
Empty resultsNo matching navigation item for the queryTry a different search term
Az.Accounts not foundModule not installedInstall-Module Az.Accounts -Scope CurrentUser
Browser sign-in fails (no window handle)Headless/CLI environmentRe-run with -UseDeviceAuthentication

Comments

Markdown supported