Installing a Plugin from the Marketplace

What you'll build

A working connection to a plugin marketplace with at least one plugin installed and its skills available in your agent. Learn more → Plugin Marketplace. Time: ~5 minutes.

Prerequisites

• An Azure SRE Agent in Running state with Agent Space configured
• Contributor role or higher on the SRE Agent resource
• Internet access to GitHub (the marketplace resolves plugins from public GitHub repositories)
• The Plugins page must be visible in your sidebar under Builder — if you don't see it, workspace tooling features may need to be enabled for your agent space

Step 1: Open the Plugin Marketplace

1. Navigate to sre.azure.com and select your agent space
2. In the sidebar, expand Builder
3. Click Plugins

Checkpoint: You see the Plugins page with the heading "Plugins" and description "Import skills from plugin marketplaces." Two tabs are visible: Browse (selected) and Installed. The Marketplaces section shows "No marketplaces added yet."

Step 2: Add a marketplace

1. Click Add marketplace (the + button next to "Marketplaces")
2. In the dialog, click the Well-known marketplaces dropdown
3. Select Azure SRE Agent Plugins
4. Click Resolve — the system fetches the marketplace manifest from GitHub and shows a preview with the marketplace name, description, and plugin count
5. Click Add

Checkpoint: A marketplace card appears in the Marketplaces section. The plugin browser loads and displays available plugins.

Custom marketplaces

You can also type any GitHub owner/repo path or URL in the Marketplace URL or owner/repo field. This works with any repository that has a valid marketplace.json in the supported locations (.github/plugin/ or .claude-plugin/).

Step 3: Browse available plugins

1. Explore the plugin cards — each shows the plugin name, description, version, author, and badges:
   • Skills (green) — this plugin has importable skills
   • Requires MCP (blue) — this plugin needs MCP connectors to be configured
   • Unsupported MCP (orange) — uses an MCP server type not yet supported
2. Use the Search plugins... field to filter by name or description
3. Toggle the filter checkboxes to show or hide plugins without skills or with unsupported MCP types

Checkpoint: You see a grid of plugin cards. Each card indicates what the plugin contains through its badges.

Step 4: Preview and import skills

1. Click a plugin card to open the detail dialog
2. Review the plugin information — name, version, author, description, and a View source link pointing to the plugin's GitHub folder
3. Click the eye icon next to any skill to preview its content before importing
4. Select the skills you want using individual checkboxes, or click Select all
5. Click Import selected

Checkpoint: You see "Successfully imported N skills." The skills are now available in your agent.

Skill name conflicts

If an imported skill name matches an existing skill that wasn't imported from a plugin, the system automatically prefixes the new skill with the plugin name to avoid conflicts.

Step 5: Configure MCP connectors (if applicable)

If your plugin includes MCP server configurations (shown in an orange section within the detail dialog):

1. For each MCP server listed, click Add as connector
2. The connector wizard opens pre-filled with the server's configuration:
   • Connection type (Local for command-based servers, Remote for URL-based)
   • Command, arguments, and environment variables (or URL and headers)
3. Review the pre-filled settings and adjust if needed
4. Complete the connector wizard

Checkpoint: Your MCP connector appears in the Connectors list with the server name from the plugin.

Step 6: Verify your installation

1. Switch to the Installed tab on the Plugins page
2. Find your installed plugin card showing:
   • Plugin name and version
   • Source marketplace badge
   • Link to the source repository
   • Badges for each imported skill
3. Click Check for updates (sync icon) to verify the plugin is current

Checkpoint: Your plugin shows "Up to date" with a checkmark. The imported skills are listed with their names.

What you learned

• How to add a marketplace source (well-known or custom) to your Plugin Marketplace
• How to browse, search, and filter available plugins
• How to preview skill content before importing
• How to import skills with one click
• How to configure MCP plugins as connectors with pre-filled settings
• How to check installed plugins for updates

Next steps

• Plugin Marketplace — understand marketplace formats and MCP config options
• MCP Connectors — learn more about configuring MCP tool servers
• Skills — how your agent uses imported skills during conversations