Skip to content

Releases: Azure/Connectors

v1.0.0b9 (preview)

30 May 00:35

Choose a tag to compare

v1.0.0b9 (preview) Pre-release
Pre-release

First preview release of the az connector-namespace Azure CLI extension.

Pre-release — Command names, arguments, and behaviors may change before GA. For evaluation and feedback only; don't pin production workloads to this version yet.

Install

# Linux / macOS — installer script
curl -fsSL https://raw.githubusercontent.com/Azure/Connectors/main/docs/early/cli/install.sh \
  | CONNECTOR_NAMESPACE_VERSION=1.0.0b9 sh
# Windows
& ([scriptblock]::Create((irm https://raw.githubusercontent.com/Azure/Connectors/main/docs/early/cli/install.ps1))) -Version 1.0.0b9

Or pin directly without the script:

az extension add --upgrade --yes --source \
  https://github.com/Azure/Connectors/releases/download/v1.0.0b9/connector_namespace-1.0.0b9-py3-none-any.whl

Verify: az connector-namespace --help

What's in this preview

9 sub-groups, 45 commands for Microsoft.Web/connectorGateways and its children:

Group Highlights
az connector-namespace create/show/list/update/delete + list-api-key + regenerate-access-key
az connector-namespace identity assign / remove / show
az connector-namespace connection + invoke, list-connection-keys, list-consent-links, confirm-consent-code
az connector-namespace connection access-policy nested principal schema
az connector-namespace mcp-connector with 5 auth modes (Developer, OBO, OBO+App, AppOnly, NotSpecified)
az connector-namespace mcp-connector access-policy flat principal schema
az connector-namespace trigger (+ run, status) webhook-style triggers + run history
az connector-namespace connector (catalog) list / show managed connectors
az connector-namespace managed-mcp-operation (catalog) list MCP-aware operations

Full reference: docs/early/cli/complete-reference.md.
AI-agent integration guide: docs/early/cli/AGENTS.md.

Known limitations (preview)

  • Hosted-MCP-server image discovery is not in the CLI for v1 — get valid --hosted-mcp-server hosted-mcp-server-id=… values from the Connectors portal.
  • az connector-namespace update is tag-only. All other namespace fields are immutable; delete + recreate to change them.
  • --scope on list-api-key takes the MCP server config name as a plain string (e.g. --scope office365Mcp), not a JSON wrapper.
  • OBO --connectors uses name (the managed connector id, e.g. sql), not connectionName — the gateway provisions per-user connections automatically.

Verify the download

  • Wheel: connector_namespace-1.0.0b9-py3-none-any.whl (146,361 bytes)
  • SHA-256: 30b7e8e0273ee11c582d9d1fad1c734937d30e322b2dc6dbc1598df909183724
  • MD5 (base64): 03d6FLFRGszQD8+HbvsCkg==
curl -L -O https://github.com/Azure/Connectors/releases/download/v1.0.0b9/connector_namespace-1.0.0b9-py3-none-any.whl
sha256sum connector_namespace-1.0.0b9-py3-none-any.whl
# Expect: 30b7e8e0273ee11c582d9d1fad1c734937d30e322b2dc6dbc1598df909183724

Filing issues

https://github.com/Azure/Connectors/issues. Include az --version, az extension show --name connector-namespace, the full command (redact secrets), and the full error (run with --debug if helpful).