Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 8 additions & 1 deletion sources/platform/integrations/ai/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -158,8 +158,15 @@ Chat and coding assistants you connect to Apify through the Apify MCP server or
imageUrlDarkTheme="/img/platform/integrations/github-copilot-white.svg"
smallImage
/>
<Card
title="Microsoft 365 Copilot"
desc="Use the Apify agent in Microsoft 365 Copilot to discover, run, and retrieve Actors from chat."
to="/integrations/microsoft-365-copilot"
imageUrl="/img/platform/integrations/microsoft-365-copilot.svg"
smallImage
/>
</CardGrid>

## By provider

See everything for a provider on one page: the [OpenAI hub](/integrations/openai) (ChatGPT, Codex, Agents SDK) and the [Claude hub](/integrations/claude) (Claude Desktop, Claude Code CLI).
See everything for a provider on one page: the [OpenAI hub](/integrations/openai) (ChatGPT, Codex, Agents SDK), the [Claude hub](/integrations/claude) (Claude Desktop, Claude Code CLI), and the [Microsoft 365 Copilot hub](/integrations/microsoft-365-copilot) (end users and IT admins).
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
label: 'Microsoft 365 Copilot'
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
---
title: Microsoft 365 Copilot
description: Use Apify Actors with Microsoft 365 Copilot - run Actors from your Copilot chat, or deploy the Apify agent for your organization as an IT admin.
sidebar_label: Microsoft 365 Copilot
slug: /integrations/microsoft-365-copilot
---

import Card from '@site/src/components/Card';
import CardGrid from '@site/src/components/CardGrid';

Apify integrates with [Microsoft 365 Copilot](https://www.microsoft.com/microsoft-365/copilot) in two places: Copilot chat for end users, and the Teams admin center for IT administrators. Both connect Copilot to Apify's library of [Actors](https://apify.com/store) through the [Apify MCP server](/integrations/mcp).

## Get started

<CardGrid>
<Card
title="User"
desc="Use the Apify agent in Microsoft 365 Copilot to search Apify Store, run Actors, and retrieve results."
to="/integrations/microsoft-365-copilot-user"
imageUrl="/img/platform/integrations/microsoft-365-copilot.svg"
smallImage
/>
<Card
title="Admin"
desc="Deploy the Apify agent so users in your organization can run Actors from Microsoft 365 Copilot."
to="/integrations/microsoft-365-copilot-admin"
imageUrl="/img/platform/integrations/microsoft-365-copilot.svg"
smallImage
/>
</CardGrid>
Original file line number Diff line number Diff line change
@@ -0,0 +1,160 @@
---
title: Deploy the Apify agent
sidebar_label: Admin
description: Learn how to deploy the Apify agent in Microsoft 365 Copilot so your organization can search Apify Store, run Actors, and retrieve results from chat.
slug: /integrations/microsoft-365-copilot-admin
---

import ThirdPartyDisclaimer from '@site/sources/_partials/_third-party-integration.mdx';

This guide is for Microsoft 365 administrators. It covers making the Apify agent available to users in [Microsoft 365 Copilot](https://www.microsoft.com/microsoft-365/copilot).

The Apify agent is a declarative agent for Microsoft 365 Copilot. It connects Copilot to Apify's library of [Actors](https://apify.com/store) through the [Apify MCP server](/integrations/mcp). Users can search Apify Store, run Actors, and retrieve datasets through the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/docs/getting-started/intro).

The agent calls Apify's remote MCP server at `https://mcp.apify.com`. No data flows to Apify until a user signs in with their own Apify account and runs a tool.

Once you complete these steps, users follow [Use Apify in Microsoft 365 Copilot](/integrations/microsoft-365-copilot-user).

<ThirdPartyDisclaimer />

## Prerequisites

- A Teams Administrator or Global Administrator role. You need it to allow and deploy the app.
- Microsoft 365 Copilot licenses for users who will run Apify tools. Users without a license can open the agent, but tool calls will not run.
- [An Apify account](https://console.apify.com/sign-up) for each end user. Free accounts work. You cannot pre-provision a shared Apify login.

:::note MCP connection is automatic

You do not need to register `mcp.apify.com` as an MCP server. The MCP connection is part of the app package. It is configured when you deploy the app.

:::

## Install the agent

### Allow the app

1. Go to the [Teams admin center](https://admin.teams.microsoft.com) > **Teams apps** > **Manage apps**.

1. Search for **Apify**.

1. Open the app and confirm its status is **Allowed**. If it is **Blocked**, change it to **Allowed**.

Making the app allowed means users can find and install it from the Agent Store. If that is all you want, stop here and send users [Use Apify in Microsoft 365 Copilot](/integrations/microsoft-365-copilot-user).

### Install the app for users

If you want the agent to appear without users installing it:

1. In the Teams admin center, go to **Teams apps** > **Setup policies**.

1. Open **Global (Org-wide default)**, or create a new policy and assign it to a specific group if you are piloting.

1. Under **Installed apps**, select **Add apps**, find **Apify**, and add it.

1. Optionally add it under **Pinned apps** so it is visible without users searching.

1. Click **Save**.

Alternatively, on the app's page in **Manage apps**, use the **Users and groups** tab to assign the app to specific people or groups.

:::tip Pilot with a group first

Assign the app to a small group rather than editing the Global policy. It is easier to reverse and avoids a tenant-wide change while you evaluate.

:::

Policy changes are not instant. Allow up to 24 hours before concluding that a deployment failed. Users who had Copilot open should reload it and start a new chat.

## Authenticate to Apify

Each user signs in with their own Apify account. You cannot pre-approve this centrally.

The first time a user runs a tool, Copilot prompts them to sign in. Users complete the Apify OAuth flow themselves. Apify tokens are not visible to Microsoft 365 or to administrators.

Read-only tools like searching Apify Store work without signing in. Users need to authenticate to run Actors and access their account data.

:::tip Session persistence

The connection stays authenticated for future sessions. Users can revoke access at any time in [Apify Console > Settings > Integrations](https://console.apify.com/settings/integrations).

:::

## Run your first prompt

1. Open Microsoft 365 Copilot at [m365.cloud.microsoft/chat](https://m365.cloud.microsoft/chat).

1. Confirm **Apify** appears under **Agents** in the sidebar.

1. Select **Apify** and send:

> Use Apify to find a good Actor for scraping Google Maps places. Show me the best option, its input requirements, pricing model, and what kind of dataset output it returns. Do not run the Actor yet.

Copilot prompts you to sign in to Apify. That confirms the agent and its tools are working.

The agent searches Apify Store, fetches the top Actor's details through the Apify MCP server, and summarizes its inputs, pricing, and output - all without running the Actor.

## Brief your users

Tell users these two points when you announce the rollout.

### Select the agent first

Users must select **Apify** under **Agents** before typing. In a normal Copilot chat, the agent's tools are not available. Copilot may answer Apify questions from general knowledge without saying it is not connected.

### Each user signs in individually

The first time a user runs a tool, they are prompted to sign in to Apify. This is per-user. Users need their own Apify account.

## Data and privacy

- Prompts and parameters relevant to a tool call are sent to `mcp.apify.com` when a user invokes an Apify tool.
- Apify is a non-Microsoft service. Data processed by Apify is governed by Apify's terms, not by your Microsoft agreements.
- Review [Apify's privacy policy](https://apify.com/privacy-policy) and [terms of use](https://apify.com/terms-of-use) before deploying.
- Users authenticate with their own Apify credentials through OAuth. Apify tokens are not visible to Microsoft 365 or to administrators.

## Manage and remove the agent

- To block the agent for the organization, go to the Teams admin center > **Manage apps** > **Apify** and set the status to **Blocked**.
- To remove it for specific users, remove the app from the setup policy assigned to them, or unassign it under **Users and groups**.
- To restrict which agents are available, go to the Microsoft 365 admin center > **Copilot** > **Settings** > **Data access** > **Agents**. You can control which users can access agents and which publisher types are permitted.

## Troubleshooting

### Users can't find the Apify agent

Confirm the app status is **Allowed** in **Teams apps** > **Manage apps**. If users report "We couldn't load the info about this agent," the app is in the catalog but not fully published. Check that the app shows a published version, not `--`.

Policy changes can take up to 24 hours. Ask users to reload Copilot and start a new chat.

### Copilot answers without using Apify tools

Users are almost always in a plain Copilot chat rather than in the agent. Have them select **Apify** under **Agents** first. If they are in the agent, check that they hold a Microsoft 365 Copilot license.

### Some users see the agent, others don't

Check the setup policy assigned to each user, and confirm propagation has completed. Policy changes can take up to 24 hours.

### Browser doesn't open, or OAuth fails

Sign-in is per-user and cannot be completed by an administrator. Have the user select **Apify**, send a simple prompt such as `Find an Actor for scraping Google Maps`, and complete **Sign in to apify**. See [Authenticate to Apify](#authenticate-to-apify) and [Use Apify in Microsoft 365 Copilot](/integrations/microsoft-365-copilot-user).

## Limitations

- Changes to app availability and setup policies can take up to 24 hours to propagate.
- Long-running Actors may exceed the time a single tool call waits for completion. Have users reduce the scope or split the work across multiple prompts.
- Each Actor run consumes Apify platform usage from the user's Apify plan in addition to any Microsoft 365 Copilot usage. See [Billing](/account/billing) for details.
- The Apify agent cannot build or deploy Actors. Point developers to the [Cursor](/integrations/cursor), [GitHub Copilot](/integrations/github-copilot), or [Claude Code CLI](/integrations/claude-code-cli) integrations.

## Related integrations

- [Use Apify in Microsoft 365 Copilot](/integrations/microsoft-365-copilot-user) - End-user setup and first prompts
- [MCP server integration](/integrations/mcp) - Use the Apify MCP server with other clients
- [ChatGPT integration](/integrations/chatgpt) - Connect the Apify MCP server to ChatGPT

## Resources

- [Manage your apps in the Microsoft Teams admin center](https://learn.microsoft.com/en-us/microsoftteams/manage-apps) - Allow or block the Apify app
- [Manage agents and app setup policies](https://learn.microsoft.com/en-us/microsoftteams/teams-app-setup-policies) - Install and pin the app for users
- [Manage agents for Microsoft 365 Copilot](https://learn.microsoft.com/en-us/microsoft-365/copilot/extensibility/manage) - Admin controls for Copilot agents
- [Agents admin guide for Microsoft 365](https://learn.microsoft.com/en-us/copilot/microsoft-365/agent-essentials/m365-agents-admin-guide) - Official Microsoft admin guidance
- [Apify Store](https://apify.com/store) - Browse Actors users can run from Copilot
Original file line number Diff line number Diff line change
@@ -0,0 +1,124 @@
---
title: Use Apify in Microsoft 365 Copilot
sidebar_label: User
description: Learn how to use the Apify agent in Microsoft 365 Copilot to discover, run, and retrieve Actors with the Apify MCP server from Copilot chat.
slug: /integrations/microsoft-365-copilot-user
---

import ThirdPartyDisclaimer from '@site/sources/_partials/_third-party-integration.mdx';

[Microsoft 365 Copilot](https://www.microsoft.com/microsoft-365/copilot) is Microsoft's AI assistant for work. It answers questions, summarizes Microsoft 365 content, and runs agents from chat.

The Apify agent connects Microsoft 365 Copilot to Apify's library of [Actors](https://apify.com/store). It uses the [Apify MCP server](/integrations/mcp) to search Apify Store, run Actors, and retrieve datasets through the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/docs/getting-started/intro).

This guide covers setup in Microsoft 365 Copilot. If you're an IT administrator deploying the agent for your organization, see [Deploy the Apify agent](/integrations/microsoft-365-copilot-admin).

<ThirdPartyDisclaimer />

## Prerequisites

- [An Apify account](https://console.apify.com/sign-up) - sign up for free if you don't have one.
- A Microsoft 365 Copilot license. Without it you can open the agent, but it cannot run Apify tools.
- The Apify agent available in your organization. If you cannot find it, contact your administrator.

## Install the agent

1. Open Microsoft 365 Copilot at [m365.cloud.microsoft/chat](https://m365.cloud.microsoft/chat).

1. Look for **Apify** under **Agents** in the sidebar.

1. If **Apify** is not listed, select **More agents** to open the Agent Store.

1. Search for **Apify**, open it, and select **Open** (or **Add**, if shown).

If Apify does not appear in the Agent Store, your administrator has not made it available yet.

## Authenticate to Apify

The agent uses the Apify MCP server at `https://mcp.apify.com`. Read-only tools like searching Apify Store and fetching Actor details work without signing in, but you need to authenticate to run Actors and access your account data.

1. Select **Apify** under **Agents** so the chat is scoped to the agent. Confirm the conversation title shows **Apify**.

1. Ask the agent to do something that needs your Apify account, for example `Find an Actor for scraping Google Maps`.

1. When Copilot shows **Sign in to apify**, select it. Copilot opens the Apify OAuth flow.

1. Review the permissions and click **Allow access**.

1. Back in Copilot, the agent can run Apify tools with your account.

:::tip Session persistence

The connection stays authenticated for future sessions. You can revoke access at any time in [Apify Console > Settings > Integrations](https://console.apify.com/settings/integrations).

:::

## Run your first prompt

Select **Apify** under **Agents** before you type. The agent routes the request to the right Apify tool, so you don't need to name tools yourself.

If you type into a normal Copilot chat instead, Copilot answers from general knowledge and cannot run anything on Apify.

> Use Apify to find a good Actor for scraping Google Maps places. Show me the best option, its input requirements, pricing model, and what kind of dataset output it returns. Do not run the Actor yet.

The agent searches Apify Store, fetches the top Actor's details through the Apify MCP server, and summarizes its inputs, pricing, and output - all without running the Actor.

## Example prompts

Start with short, specific requests. If you already know the Actor you want, name it explicitly - for example [`apify/web-scraper`](https://apify.com/apify/web-scraper) - rather than describing it.

_Search Apify Store:_

> Search Apify Store for Instagram scrapers.

_Actor details:_

> What does the apify/web-scraper Actor need as input?

_Retrieve results:_

> Show me the results from my last run.

## Troubleshooting

### The Apify agent doesn't appear in Copilot

Select **More agents** and search the Agent Store for **Apify**. If it is missing there too, your administrator has not made it available. Contact them and share [Deploy the Apify agent](/integrations/microsoft-365-copilot-admin).

### Copilot answers without using Apify tools

You are most likely in a normal Copilot chat. Select **Apify** under **Agents** and start a new chat. If a response explains what you would do in Apify rather than doing it, check that you are in the agent.

### The Apify MCP server shows as unauthenticated

Ask a direct request such as `Find an Actor for scraping Google Maps` so Copilot can show **Sign in to apify**. Complete the OAuth flow. See [Authenticate to Apify](#authenticate-to-apify).

If nothing happens and you are never asked to sign in, simplify the request. Long multi-step prompts can cause the agent to explain instead of act.

### Browser doesn't open, or OAuth fails

If the sign-in window doesn't open, retry the prompt and select **Sign in to apify** again.

If you don't have an Apify account, [sign up](https://console.apify.com/sign-up) and then retry the sign-in prompt.

If the agent fails to load, contact your IT administrator. The agent may not be fully deployed in your organization.

## Limitations

- Ask for one thing at a time. Long multi-step requests often fail in a single turn. Find the Actor first, then run it, then ask for results.
- Long-running Actors may exceed the time a single tool call waits for completion. Start the run from the agent, then check results in [Apify Console](https://console.apify.com).
- Each Actor run consumes Apify platform usage from your plan in addition to any Microsoft 365 Copilot usage. See [Billing](/account/billing) for details. Review the Actor's pricing in Apify Store before large jobs.
- The Apify agent cannot build or deploy Actors. That requires a local development environment. To develop Actors with AI assistance, use the [Cursor](/integrations/cursor), [GitHub Copilot](/integrations/github-copilot), or [Claude Code CLI](/integrations/claude-code-cli) integrations.

## Related integrations

- [Deploy the Apify agent](/integrations/microsoft-365-copilot-admin) - Make the agent available to your organization
- [MCP server integration](/integrations/mcp) - Use the Apify MCP server with other clients
- [ChatGPT integration](/integrations/chatgpt) - Connect the Apify MCP server to ChatGPT

## Resources

- [Get started with agents in Microsoft 365 Copilot](https://support.microsoft.com/en-us/topic/get-started-with-agents-in-microsoft-365-copilot-943e563d-602d-40fa-bdd1-dbc83f582466) - Official Microsoft 365 Copilot agent docs
- [Agent Store in Microsoft Copilot](https://learn.microsoft.com/en-us/microsoft-365/copilot/copilot-agent-store) - How the Agent Store works
- [Apify Store](https://apify.com/store) - Browse Actors you can run from Copilot
- [Apify Console](https://console.apify.com) - Runs, datasets, and usage
7 changes: 7 additions & 0 deletions sources/platform/integrations/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -155,6 +155,13 @@ Plug Apify Actors into the AI stack - chat clients like Claude and ChatGPT via t
imageUrlDarkTheme="/img/platform/integrations/cursor-white.svg"
smallImage
/>
<Card
title="Microsoft 365 Copilot"
desc="Use the Apify agent in Microsoft 365 Copilot to discover, run, and retrieve Actors from chat."
to="/integrations/microsoft-365-copilot"
imageUrl="/img/platform/integrations/microsoft-365-copilot.svg"
smallImage
/>
</CardGrid>

[See all AI integrations →](/integrations/ai)
Expand Down
Loading
Loading