consent — Claude Code command: Azure approval and install
This Claude Code command guides Azure admin consent for Entra SSO and Outlook access to Microsoft Graph. A tenant admin opens the supplied URL and approves the permissions.
Apache-2.0 ★ 41,441 updated 2026-09-21
/plugin marketplace add anthropics/financial-services
/plugin install claude-for-msft-365-install@claude-for-financial-servicesWhat consent does
The command explains when Azure admin consent is required and provides URLs for Entra SSO and Outlook access to Microsoft Graph. Entra consent applies only when entra_sso=1; if graph_client_id points to a separately registered Entra app, consent is handled for that app. Graph consent is required when deploying the Outlook manifest, even with Entra SSO turned off.
A Global Admin signed in to the target tenant opens the URL and accepts the request. The command also gives an Azure CLI check using az ad sp show. Without Graph consent, users encounter an admin approval prompt when Outlook first tries to read mail.
What it helps with
- grant tenant consent for Entra SSO
- approve Graph access for an Outlook manifest
- check whether the tenant has a service principal
- use a separately registered Entra app for Outlook
Example prompts for the agent
- Set up Azure admin consent for Entra SSO.
- Explain how to approve Microsoft Graph for the Outlook manifest.
- Show how to check tenant consent with
az ad sp show.
How to install consent
1Plugin marketplace
/plugin marketplace add anthropics/financial-services/plugin install claude-for-msft-365-install@claude-for-financial-services2Manually: put the files in place
.claude/commands/consent.mdCall it with /consent. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/consent.mdCall it with /prompts:consent. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/consent.prompt.mdManually: put the files in place
.gemini/commands/consent.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about consent
How do I install consent in Claude Code?
Run /plugin marketplace add anthropics/financial-services, then run /plugin install claude-for-msft-365-install@claude-for-financial-services.
What does consent do?
It guides an administrator through approving Entra SSO or Microsoft Graph access for Outlook. It also provides an Azure CLI command to verify the tenant service principal.
What is required to use consent?
A Global Admin signed in to the target tenant must approve the request. Entra consent is needed when entra_sso=1; Graph consent is needed when deploying the Outlook manifest.
Source text
consent.md · Apache-2.0
--- description: Azure admin consent URLs — one-time tenant approval for Entra SSO and Outlook Graph access --- # Azure admin consent **Only needed when `entra_sso=1`** in the manifest. Gateway and Vertex setups with org-wide config don't use Entra and can skip this. If you set `graph_client_id` (your own Entra app), this page doesn't apply either — you manage consent on your app directly. One-time per tenant. A Global Admin opens this URL, clicks Accept, done. Until they do, NAA sign-in inside the add-in fails for every user in the tenant. ## The URL Same URL for every customer — `/organizations/` resolves the tenant from whoever signs in. No substitution needed. ``` https://login.microsoftonline.com/organizations/adminconsent?client_id=c2995f31-11e7-4882-b7a7-ef9def0a0266&redirect_uri=https://pivot.claude.ai/auth/callback ``` Print it. Tell them: open in a browser where a **Global Admin** for their tenant is signed in. They'll see a permissions screen listing what the add-in reads (user profile, extension attributes). After they click **Accept**, they land on a confirmation page — "Admin consent granted, you can close this tab." ## Verify ```bash az ad sp show --id c2995f31-11e7-4882-b7a7-ef9def0a0266 --query appId -o tsv ``` If that returns the same GUID, the service principal exists in their tenant — consent worked. If it errors with "does not exist", consent didn't complete. ## Outlook — Microsoft Graph consent **Only needed when deploying the Outlook manifest.** Separate from `entra_sso` above; required even if `entra_sso` is off. Claude for Outlook reads mail and calendar through Microsoft Graph. The Graph token stays in the user's Outlook client and is never sent to the gateway or to Anthropic, so this consent is the same regardless of which cloud serves the model. A Global Admin opens the URL, clicks Accept, done. ``` https://login.microsoftonline.com/organizations/v2.0/adminconsent?client_id=c2995f31-11e7-4882-b7a7-ef9def0a0266&scope=https://graph.microsoft.com/Mail.ReadWrite%20https://graph.microsoft.com/Calendars.Read%20https://graph.microsoft.com/People.Read%20https://graph.microsoft.com/User.Read%20offline_access&redirect_uri=https://pivot.claude.ai/auth/callback ``` Without this, every user hits a "Need admin approval" wall the first time Claude tries to read mail. **If their policy forbids consenting to a third-party app:** they can register their own single-tenant Entra app with the same delegated Graph permissions (Mail.ReadWrite, Calendars.Read, People.Read, User.Read, offline_access), grant admin consent on it, and pass its client ID as `graph_client_id` when generating the Outlook manifest. Same data flow; approval lives under their app instead of Anthropic's.
© Anthropic · Apache-2.0 · anthropics/financial-services