Azure Boards

On this page

Connects Kotharo to Azure Boards for ticketing. All adapters

What you need

Connect

/kotharo:setup finds Azure Boards and takes you through these steps. To connect it by hand:

claude mcp add --scope user azure-devops -- npx -y @azure-devops/mcp <organization> -d core work-items repositories pipelines -a azcli

Install Node.js, which brings npm and npx. Its install page covers other systems.

macOS:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.8/install.sh | bash
\. "$HOME/.nvm/nvm.sh"
nvm install 24

Windows, in Git Bash:

powershell -c "irm https://community.chocolatey.org/install.ps1|iex"
choco install nodejs --version="24.22.1"

Linux:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.8/install.sh | bash
\. "$HOME/.nvm/nvm.sh"
nvm install 24

Install Azure CLI. Its install page covers other systems.

macOS:

brew update && brew install azure-cli

Windows, in Git Bash:

winget install --exact --id Microsoft.AzureCLI

Linux:

curl -fsSL 'https://azurecliprod.blob.core.windows.net/$root/deb_install.sh' | sudo bash

Sign in

<organization> is the organization's name from its dev.azure.com address, not the URL. Run az login with the work account in the organization's Microsoft Entra tenant; the server and the adapters use that login, never a personal access token.

To check you are signed in, run az account show.