DORKAG Help

Azd Installation

Installing the AZD plugin is straightforward. This guide will walk you through the process of installing the plugin and connecting it to your Azure DevOps account.
For more information on JetBrains plugin installation, refer to the official documentation.

Install the AZD plugin

  1. Open your JetBrains IDE and navigate to Settings | Plugins.

  2. Under the Marketplace tab, search for Azd.

  3. Click the Install button.

  4. Wait for the installation to complete and restart your IDE when prompted.

You can also install the plugin directly from the JetBrains Marketplace.

  1. Open the AZD plugin webpage.

  2. Click on the Install to... button and select your running IDE instance.

Authentication

AZD supports two authentication methods:

  • Microsoft Entra ID (OAuth) — Sign in with your Microsoft account using a secure OAuth flow. Recommended for Azure DevOps Services (cloud).

  • Personal Access Token (PAT) — Generate a token from Azure DevOps and paste it into the plugin. Required for Azure DevOps Server (on-premises).

Generating a Personal Access Token (PAT)

  1. Log in to your Azure DevOps organization.

  2. Navigate to User settings | Personal access tokens.

  3. Click New Token and select the following scopes:

    • vso.build_execute

    • vso.code_status

    • vso.code_write

    • vso.graph

    • vso.identity

    • vso.profile

    • vso.project

    • vso.test

    • vso.threads_full

    • vso.work_write

  4. Click Create and copy your token immediately. You won't be able to see it again.

More details about each scope

REST API Scope Name

Azure DevOps Portal Scope

Description

vso.code_write

Code (Read & write)

Cloning repos and pushing changes.

vso.code_status

Code (Status)

Updating build/PR statuses.

vso.graph

Graph (Read)

User/group discovery.

vso.build_execute

Build (Read & execute)

Triggering and monitoring builds.

vso.identity

Identity (Read)

User profile retrieval.

vso.project

Project and Team (Read, write, & manage)

Interacting with project data.

vso.threads_full

Pull Request and Threads (Read & write)

Managing PR comments.

vso.profile

Profile (Read)

User profile details.

vso.work_write

Work Items (Read & write)

Creating/updating tasks and bugs.

vso.test

Test Management (Read)

Accessing test plans and results.

Connect to Azure DevOps

Once the plugin is installed, you can connect your account from the ToolWindow or Settings.

Sign in with Microsoft (OAuth)

  1. Open the AZD ToolWindow.

    PR ToolWindow Login
  2. Click Sign in with Microsoft.

    OAuth Welcome
  3. Authenticate in your browser and approve the requested permissions.

    OAuth Scope Dialog
  4. After successful login, the plugin will automatically discover your organizations.

    Browser Login Success

Use a Personal Access Token (PAT)

  1. Go to Settings | Version Control | Azure DevOps.

  2. Click add and select PAT.

    Add AZD Account
  3. Enter your Server URL and paste the token.

  1. Open the AZD ToolWindow and click Login.

  2. In the Add AZD Account dialog, enter your server URL and PAT.

    Server Login
02 May 2026