--- schema_version: "1" id: a64c4cc7de79e44cc1514dbbe9ebb5d201325636bcf6441787e08c8f7e364b12 title: Integrate the Enhanced Experience with Microsoft Teams collection: mulesoft version: current locale: en-us portal_url: https://docs.salesforce.com/mulesoft/current/en-us/general/exp-teams-integrate.md canonical_url: https://docs.mulesoft.com/general/exp-teams-integrate source_site: docs.mulesoft.com content_type: documentation content_hash: 56f6c6e5319bb46705da74fd688837377fdb00818b0da34d1bafc8c83cfe2968 description: MuleSoft Documentation Site latest: true --- --- product: Getting Started keywords: microsoft teams integration, mulesoft agent, teams bot, mcp server, anypoint platform, enhanced experience --- # Integrate the Enhanced Experience with Microsoft Teams > For the full documentation index, see: https://docs.mulesoft.com/llms.txt Install the MuleSoft for Teams app in your Microsoft Teams tenant to interact with MuleSoft directly from Teams using natural language. The Teams app enables you to: - [Connect Your Microsoft Teams Tenant to the MuleSoft Organization](#connect-teams-tenant): Bind your Microsoft Teams tenant to your Anypoint organization so the app can send alerts and notifications directly to channels and DMs. - [Begin Using the MuleSoft Agent](#begin-using-agent): Manage your MuleSoft environment with the MuleSoft Agent integrated with Teams. Use MuleSoft Agent, to list APIs, view MCP servers, check governance, and perform other management tasks. - Configure alerts to deliver notifications to Teams channels. For instructions, see [Configuring Notifications for Alerts](https://docs.mulesoft.com/general/exp-alerts-configure-notifications). > [!NOTE] This tool uses generative AI, which can produce inaccurate or harmful responses. Review > for accuracy and safety before using. ## Before You Begin Before setting up the Teams integration, verify that the following requirements are met: - **Generative AI enabled**: Generative AI must be enabled in your Anypoint Platform and Salesforce organizations. For more information, see [Enabling or Disabling Generative AI for Anypoint Platform](https://docs.mulesoft.com/access-management/enabling-generative-ai). - **Salesforce-Anypoint Connection**: Your Anypoint Platform organization must be fully connected to your Salesforce organization. - **Early Access Program**: The MuleSoft Agent feature must be enabled for your organization by the MuleSoft team as part of the Early Access Program. Contact your Customer Success Manager (CSM) or Account Executive (AE) to join the program. ## Connect Your Microsoft Teams Tenant to the MuleSoft Organization You must be a MuleSoft organization administrator and a Microsoft Teams administrator to connect the Teams integration. If you are not a Teams administrator, you can send a request to your Teams administrator to approve the app. Each MuleSoft organization can connect to only one Microsoft Teams tenant, and each tenant can connect to only one MuleSoft organization. 1. Log in and go to **Notifications** > **Settings**. 2. In **Microsoft Teams Setup**, click **Install Microsoft Teams app**. This publishes the Teams app to your AAD tenant’s app catalog through Microsoft Graph. If the tenant hasn’t yet consented to this app, you’re redirected to Microsoft to grant admin consent. 3. Select your Microsoft Teams admin account. 4. Review the permissions requested and click **Accept**. The app requests the following permissions: - Read and write to all app catalogs - Maintain access to data you have given it access to - View your basic profile 5. After the installation completes, the confirmation page displays **Microsoft Teams integration installed**. Click **Back to Settings**. In **Notifications** > **Settings**, the **Microsoft Teams Setup** section now shows **Installed** and displays the bound tenant ID. 6. Click **Grant Access** to allow the app to browse your Teams directory for channel and team member access. 7. In Microsoft Teams, review the permissions requested and click **Accept**. After access is granted, configure notification channels in the **Notification Channels** section. After installation, the MuleSoft Agent app appears in Microsoft Teams Admin Center under **Manage apps** as available to everyone and unblocked. To disconnect the integration: 1. Click **Disconnect** in the **Microsoft Teams Setup** section. 2. Confirm the disconnection. This immediately revokes MuleSoft’s access to your Teams tenant and stops all notifications. The MuleSoft app remains in the Microsoft Teams Admin Center. To fully remove it, a Teams administrator must uninstall it from the Admin Center, or right-click the app in Teams and select **Uninstall**. ## Begin Using the MuleSoft Agent > [!IMPORTANT] MuleSoft Agent is available on request. To get access, contact your account > executive. Before getting started, make sure you have: - An Anypoint Platform account with access to the enhanced experience. - Generative AI enabled in your Anypoint Platform and Salesforce organizations by your administrator. For more information, see [Enabling or Disabling Generative AI for Anypoint Platform](https://docs.mulesoft.com/access-management/enabling-generative-ai). - The **MuleSoft Agent AI User** permission assigned to your user. For more information, see [Enhanced Experience Permissions](https://docs.mulesoft.com/general/exp-home-start#permissions). To assign the **MuleSoft Agent AI User** permission across business groups: 1. Log in to Anypoint Platform and open **Access Management**. 2. Select the business group where you want to assign the permission. 3. Find the user and assign the **MuleSoft Agent AI User** permission. 4. Repeat for each business group that requires access. To start using the agent in Teams: 1. Open Microsoft Teams and go to **Apps**. 2. Under **Built for your organisation**, find **MuleSoft Agent** and click **Add**. 3. Click **Open** or select a channel where you want to use the app. 4. The agent sends a welcome message. Select a prompt suggestion or type a message to start. 5. If prompted, click **Connect to MuleSoft** and sign in with your Anypoint Platform credentials. 6. After authenticating, close the browser tab to complete account linking. Return to Teams to continue the conversation. After you authenticate, you can use the agent to list APIs, agents, MCP servers, view governance reports, and more. > [!NOTE] After the first 24 hours, you must @mention the MuleSoft Agent in channels to send it a > message. In direct messages, you can send messages to the agent at any time without @mentioning > it. ## Available Prompt Suggestions When you open the MuleSoft Agent, the following prompt suggestions are available: - **signin**: Connect your MuleSoft account. - **signout**: Disconnect your MuleSoft account. - **What business group am I in?**: Shows your current business group. - **List APIs in my business group**: Lists APIs in your current business group. - **Risks across my portfolio?**: Shows risks across your portfolio. - **Top MCP token spend this week**: Shows which MCP servers had the highest token spend this week. - **Which agents have instances?**: Lists agents that have instances. - **Top API error rates (7 days)**: Shows APIs with the highest error rates over the past 7 days. - **feedback**: Send feedback to the MuleSoft Agent team. - **help**: Show available commands. ## Common Use Cases for the MuleSoft Agent You can use the MuleSoft Agent to perform these platform tasks in Teams: - **Receive alerts**: Receive alerts to channels. For more information, see [Configuring Notifications for Alerts](https://docs.mulesoft.com/general/exp-alerts-configure-notifications). - **Find services by capability**: Use natural-language search to discover APIs, agents, LLMs, and MCP servers. - **Run governance, monitoring, and cost drill-ins**: Generate governance, monitoring, and cost reports on request. - **Take governance actions**: Apply policies and apply cost management recommendations. ## Microsoft Graph Permissions The MuleSoft for Microsoft Teams app requires the following Microsoft Graph permissions. Use this information when your security or IT team asks for justification before approving the app installation.
PermissionTypePurpose

AppCatalog.Read.All

Application

Verifies that the MuleSoft app is properly published in your Teams app catalog. Without this, the app cannot confirm its own availability, and users see silent failures instead of actionable setup errors.

AppCatalog.ReadWrite.All

Delegated

Required when a Teams admin publishes or updates the MuleSoft app package in your catalog. Only exercised during install or upgrade — not at runtime — and scoped to the consenting admin’s session.

AppCatalog.ReadWrite.All

Application

Allows the MuleSoft app to receive updates, such as new Adaptive Card formats or capability additions, without requiring an admin to manually republish each time.

Channel.ReadBasic.All

Application

Delivers API alerts and deployment notifications to specific channels you configure. The app reads channel names and IDs to resolve routing rules. It reads channel metadata only — not message content.

Team.ReadBasic.All

Application

During setup, lets you map MuleSoft environments and business groups to specific teams without manually looking up team IDs. Read-only access to team names and descriptions — no access to members or content.

TeamsAppInstallation.ReadWriteAndConsentForTeam.All

Application

Lets a Teams admin roll the app out to all relevant teams in a single action with automatic RSC consent, rather than requiring each individual team owner to install it separately.

TeamsAppInstallation.ReadWriteForTeam.All

Application

Manages the app lifecycle across teams, including handling version upgrades and removing the app from teams where it is no longer needed.

TeamSettings.Read.All

Application

Checks team policies before the app attempts to post. If a team has restricted messaging or moderation enabled, the app surfaces a clear configuration error rather than silently dropping critical API alerts. Read-only — it does not change settings through this permission.

TeamSettings.ReadWrite.All

Application

During initial provisioning only, the app may adjust channel settings to enable bot posting in moderated channels where incident alerts must be delivered. This is a one-time setup action, not ongoing runtime behavior.

User.Read

Delegated

Standard sign-in permission for the admin performing the initial consent. The app reads basic profile information (name, email) to log who authorized the connection between the Anypoint Platform organization and the Teams tenant.

## Security, Data Retention, and Residency - **Hyperforce and data boundaries**: The MuleSoft Agent respects your designated Hyperforce region. Install the regional app for Teams that corresponds to your region. Customer data never leaves your designated Hyperforce boundary. - **LLM architecture and web access**: The MuleSoft Agent uses the Salesforce LLM-Gateway, powered by OpenAI GPT-5-mini. The agent does not perform public web searches. - **Data retention and compliance**: Data retention policies, data removal, LLM data tenancy, and infrastructure details are covered in the applicable Salesforce Security, Privacy, and Architecture (SPARC) documentation. Customer data is securely deleted upon expiration of the applicable retention periods in accordance with SPARC guidelines. For more information, see the [Salesforce Trust and Compliance Documentation](https://www.salesforce.com/company/legal/trust-and-compliance-documentation/). ## See Also - [Get Started with the Enhanced Experience](https://docs.mulesoft.com/general/exp-home-start) - [Enhanced MuleSoft Experience Overview](https://docs.mulesoft.com/general/exp-overview) - [Integrate the Enhanced Experience with Slack](https://docs.mulesoft.com/general/exp-slack-integrate) - [Connect the Enhanced Experience to Claude Desktop](https://docs.mulesoft.com/general/exp-claude-desktop-connect)