vivaXite

Tenant Cockpit

Connect Claude and Copilot (MCP)

With the MCP add-on module, your people ask the Tenant Cockpit questions directly in Claude or Microsoft Copilot, for example: "Which teams have no owner?" or "What are the most critical BPA findings?" Sign-in uses the work account. Everyone sees only what they may see in the Tenant Cockpit. Access is strictly read-only.

Overview

  1. Book the MCP module for your tenant with vivaXite (it is enabled per tenant).
  2. Once: an administrator of your tenant consents to the app "Tenant Cockpit MCP".
  3. Add the server address in Claude (as a connector), in Claude Code, or in Copilot Studio, or install the agent in Microsoft 365 Copilot. After that, people sign in with their account the first time they use it.

What Claude and Copilot can query

Each person sees only what the page groups in the Tenant Cockpit allow. There are no write functions.

Details for the setup

Server address
https://mcp.tenant-cockpit.com/mcp
Client ID
<Client ID of the MCP app>
Client secret
none (public client with PKCE)
Permission (scope)
https://mcp.tenant-cockpit.com/mcp/mcp.read (read only)
Sign-in
Microsoft Entra ID, work account (guest accounts are not allowed)

Claude

Connector in Claude and Claude Code

1. Administrator consent

An administrator of your tenant (Global Administrator or Privileged Role Administrator) opens this address and confirms. After that, all users can sign in without consenting themselves.

https://login.microsoftonline.com/organizations/v2.0/adminconsent?client_id={{MCPID}}&scope=https://mcp.tenant-cockpit.com/mcp/mcp.read&redirect_uri=https://tenant-cockpit.com/

The app "Tenant Cockpit MCP" only gets the right to sign in and to call the Tenant Cockpit MCP service. It gets no access to your Microsoft 365 data.

2. Add the connector

  1. An owner of the Claude organization opens Settings → Connectors → Add custom connector.
  2. Name: Tenant Cockpit, URL: https://mcp.tenant-cockpit.com/mcp.
  3. No further details are needed: Claude registers itself automatically, you do not have to enter the client ID.
  4. People enable the connector in their chat and sign in with their work account.

Team/Enterprise: the owner adds the connector under Organization settings → Connectors; people then click "Connect" under Settings → Connectors. Individual plans (Pro/Max): add the connector directly in your own settings.

Claude Code: run this in a terminal, then open /mcp in the app and choose "Authenticate":

claude mcp add --transport http tenant-cockpit https://mcp.tenant-cockpit.com/mcp

Microsoft Copilot

Agent in Microsoft 365 Copilot and Copilot Studio

Microsoft 365 Copilot (agent)

The "Tenant Cockpit" agent is provided as an app package (ZIP) and deployed through the Teams admin center. Prerequisites: the MCP module is enabled for your tenant, and the users have a Microsoft 365 Copilot license.

  1. Consent: An administrator opens this address and confirms. Teams may then show an error page; the consent has still been granted.
    https://login.microsoftonline.com/organizations/v2.0/adminconsent?client_id={{COPILOTID}}&scope=https://mcp.tenant-cockpit.com/mcp/mcp.read&redirect_uri=https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect
  2. Download the package: tenant-cockpit-copilot-agent.zip (do not unzip it).
  3. Upload: In the Teams admin center (Teams Administrator or Global Administrator) open Teams apps → Manage apps, choose Upload new app (or Upload custom app) and select the ZIP. The app "Tenant Cockpit" appears in the list.
  4. Make it available: Open the app and check that its status is Allowed and that the desired users or groups have access. Alternatively, in the Microsoft 365 admin center go to Copilot → Agents → All agents, open "Tenant Cockpit" and choose Deploy or set the availability.
  5. Use it: After a few minutes (rarely up to a few hours) users open Microsoft 365 Copilot, pick "Tenant Cockpit" under Agents and ask a question, for example "How is my tenant doing?". They sign in once the first time.

If the agent does not appear or the app cannot be uploaded, check in the Teams policies (app permission policies and setup policies) that custom apps are allowed. Updates arrive as a new package with a higher version number and are applied the same way using Update.

Copilot Studio

  1. In the agent choose Tools → Add a tool → Model Context Protocol and create a new MCP server.
  2. Server URL: https://mcp.tenant-cockpit.com/mcp. Authentication: OAuth 2.0. If the form offers "Dynamic" or "Dynamic discovery", that is enough. The details below are only needed for manual setup.
  3. Client ID as above. Leave the client secret empty, or enter any placeholder if the form insists.
  4. Authorization URL: https://login.microsoftonline.com/organizations/oauth2/v2.0/authorize
  5. Token and refresh URL: https://login.microsoftonline.com/organizations/oauth2/v2.0/token
  6. Scopes: https://mcp.tenant-cockpit.com/mcp/mcp.read offline_access
  7. Send the redirect URL shown there to vivaXite. It is registered once on the app.

Ending access

You can disconnect at any time: in Entra under Enterprise applications delete or disable the application "Tenant Cockpit MCP". You can also cancel the module with vivaXite. The server then rejects all requests from your tenant.