From 5f9d903a4a38a116f32936ae7d5684becb6efec5 Mon Sep 17 00:00:00 2001 From: Shreyas Saravanan Date: Wed, 2 Sep 2026 14:26:54 +0530 Subject: [PATCH 1/7] Add MCP server and VS Code extension affordances to SPE build docs Add one-click "open in agent/tool" affordances so developers can start building from a coding agent or the VS Code extension: - New reusable includes: includes/spe-mcp-install.md (VS Code / Insiders one-click MCP install buttons + Claude Code/Codex CLI one-liners) and includes/spe-vscode-extension.md (Marketplace install button). - Wire includes into build/sharepoint-embedded-mcp-server.md, build/quickstart-vscode.md, build/create-container-type.md, and build/create-manage-containers.md. - Add coding-agent pointers on build/agent-experiences.md and the documentation hub. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 022e6c80-2ba9-480e-9d52-4826b8a04d26 --- docs/embedded/build/agent-experiences.md | 3 +++ docs/embedded/build/create-container-type.md | 8 ++++++++ .../build/create-manage-containers.md | 6 ++++++ docs/embedded/build/quickstart-vscode.md | 7 +++++++ .../build/sharepoint-embedded-mcp-server.md | 6 ++++++ docs/embedded/includes/spe-mcp-install.md | 19 +++++++++++++++++++ .../embedded/includes/spe-vscode-extension.md | 6 ++++++ .../sharepoint-embedded-documentation.md | 2 +- 8 files changed, 56 insertions(+), 1 deletion(-) create mode 100644 docs/embedded/includes/spe-mcp-install.md create mode 100644 docs/embedded/includes/spe-vscode-extension.md diff --git a/docs/embedded/build/agent-experiences.md b/docs/embedded/build/agent-experiences.md index 28294a9ee1..e00b95f0ba 100644 --- a/docs/embedded/build/agent-experiences.md +++ b/docs/embedded/build/agent-experiences.md @@ -26,6 +26,9 @@ SharePoint Embedded agent experiences let your app answer questions over files s Choose the knowledge source when you want Foundry to manage retrieval and agent orchestration. Choose the Retrieval API when you want to control the grounding step, the prompt, and the model yourself. +> [!TIP] +> To provision and manage the SharePoint Embedded resources behind these experiences from a coding agent, use the [SharePoint Embedded MCP server](sharepoint-embedded-mcp-server.md). + ## How SharePoint Embedded grounds agents SharePoint Embedded grounds AI agents on enterprise content while keeping that content and its compliance controls inside the customer's Microsoft 365 tenant. You don't copy content into an external vector database. Key facts: diff --git a/docs/embedded/build/create-container-type.md b/docs/embedded/build/create-container-type.md index 24c3dc57a5..5eecca9a03 100644 --- a/docs/embedded/build/create-container-type.md +++ b/docs/embedded/build/create-container-type.md @@ -25,6 +25,14 @@ If you're just starting, complete [Quickstart: Build your first app with VS Code To decide between single-tenant and multitenant models first, see [Choose an app model](../plan/choose-app-model.md). +## Create a container type with a coding agent or the VS Code extension + +You can create and configure a container type without calling the APIs directly: + +[!INCLUDE [Add the SharePoint Embedded MCP server](../includes/spe-mcp-install.md)] + +[!INCLUDE [Install the SharePoint Embedded VS Code extension](../includes/spe-vscode-extension.md)] + ## Understand the container type relationship A container type is strongly coupled with one Microsoft Entra ID application, called the owning application. diff --git a/docs/embedded/build/create-manage-containers.md b/docs/embedded/build/create-manage-containers.md index 68a9d90183..64a8df19c7 100644 --- a/docs/embedded/build/create-manage-containers.md +++ b/docs/embedded/build/create-manage-containers.md @@ -23,6 +23,12 @@ Create and manage containers after your container type is created, registered, a Complete [Configure authentication and authorization](configure-authentication-authorization.md) before you call container APIs. +## Manage containers with a coding agent + +The [SharePoint Embedded MCP server](sharepoint-embedded-mcp-server.md) exposes container tools—such as `container_create`, `container_list`, `container_permissions_manage`, `container_archive_restore`, and `container_delete`—that a coding agent can call to manage containers through natural language. + +[!INCLUDE [Add the SharePoint Embedded MCP server](../includes/spe-mcp-install.md)] + ## Understand containers All SharePoint Embedded files and documents are stored in containers. diff --git a/docs/embedded/build/quickstart-vscode.md b/docs/embedded/build/quickstart-vscode.md index 0b7a9f690c..527c5f3278 100644 --- a/docs/embedded/build/quickstart-vscode.md +++ b/docs/embedded/build/quickstart-vscode.md @@ -23,6 +23,9 @@ Use the [SharePoint Embedded Visual Studio Code extension](https://marketplace.v This article starts the build journey. For more billing guidance, see [Create and configure a container type](create-container-type.md). +> [!TIP] +> Prefer to build with a coding agent instead of a guided view? Use the [SharePoint Embedded MCP server](sharepoint-embedded-mcp-server.md) to provision and manage resources through natural language. + ## Prerequisites Before you start, make sure you have: @@ -40,6 +43,10 @@ Before you start, make sure you have: ## Install the extension +[!INCLUDE [Install the SharePoint Embedded VS Code extension](../includes/spe-vscode-extension.md)] + +Or install it from within the editor: + 1. Open Visual Studio Code. 1. Open **Extensions** from the activity bar. 1. Search for **SharePoint Embedded**. diff --git a/docs/embedded/build/sharepoint-embedded-mcp-server.md b/docs/embedded/build/sharepoint-embedded-mcp-server.md index 25c91ac859..e269a5a4a5 100644 --- a/docs/embedded/build/sharepoint-embedded-mcp-server.md +++ b/docs/embedded/build/sharepoint-embedded-mcp-server.md @@ -57,6 +57,12 @@ For the complete, versioned list of tools, CLI flags, and environment variables, MCP clients launch the server with `npx`, so there's no separate global install. Add a server entry to your client's MCP configuration. +### Add the server with one click + +[!INCLUDE [Add the SharePoint Embedded MCP server](../includes/spe-mcp-install.md)] + +To add the server manually instead, use the following client-specific steps. + ### Visual Studio Code Add an MCP server entry to `.vscode/mcp.json` in your workspace: diff --git a/docs/embedded/includes/spe-mcp-install.md b/docs/embedded/includes/spe-mcp-install.md new file mode 100644 index 0000000000..76aca5dd9e --- /dev/null +++ b/docs/embedded/includes/spe-mcp-install.md @@ -0,0 +1,19 @@ + + +Add the SharePoint Embedded MCP server to a coding agent with one click: + +> [!div class="nextstepaction"] +> [Add to Visual Studio Code](https://vscode.dev/redirect/mcp/install?name=spe&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40microsoft%2Fspe-mcp%22%2C%22start%22%5D%7D) + +> [!div class="nextstepaction"] +> [Add to Visual Studio Code Insiders](https://insiders.vscode.dev/redirect/mcp/install?name=spe&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40microsoft%2Fspe-mcp%22%2C%22start%22%5D%7D) + +For other MCP clients, register the server with the same `npx` command: + +```console +# Claude Code +claude mcp add spe -- npx -y @microsoft/spe-mcp start + +# OpenAI Codex CLI +codex mcp add spe -- npx -y @microsoft/spe-mcp start +``` diff --git a/docs/embedded/includes/spe-vscode-extension.md b/docs/embedded/includes/spe-vscode-extension.md new file mode 100644 index 0000000000..cee74f2bb4 --- /dev/null +++ b/docs/embedded/includes/spe-vscode-extension.md @@ -0,0 +1,6 @@ + + +Install the SharePoint Embedded extension for Visual Studio Code to create a container type, configure the owning app and billing, register the container type, create containers, and load a sample app from a guided view in the editor: + +> [!div class="nextstepaction"] +> [Get the extension from the Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=SharepointEmbedded.ms-sharepoint-embedded-vscode-extension) diff --git a/docs/embedded/sharepoint-embedded-documentation.md b/docs/embedded/sharepoint-embedded-documentation.md index a7f8d8e824..a687a85d85 100644 --- a/docs/embedded/sharepoint-embedded-documentation.md +++ b/docs/embedded/sharepoint-embedded-documentation.md @@ -52,7 +52,7 @@ Decide how SharePoint Embedded fits before you write code. ## Build an app -An ordered journey from first container to a full-featured app. +An ordered journey from first container to a full-featured app. You can also build with a guided view using the [SharePoint Embedded VS Code extension](./build/quickstart-vscode.md) or from a coding agent with the [SharePoint Embedded MCP server](./build/sharepoint-embedded-mcp-server.md). 1. [Quickstart: build your first app with VS Code](./build/quickstart-vscode.md) 2. [Use the MCP server to build apps with a coding agent](./build/sharepoint-embedded-mcp-server.md) From 710e52ee71097817e5cf6c8ed86a3904eaf1f1b3 Mon Sep 17 00:00:00 2001 From: Shreyas Saravanan Date: Wed, 2 Sep 2026 14:35:19 +0530 Subject: [PATCH 2/7] Rename includes to full-word filenames to clear Learn validation The Learn build flagged filename-incomplete on spe-*.md includes because 'spe' is a disallowed abbreviation in filenames. Rename to spell out 'sharepoint-embedded' (matching the build page naming) and update all INCLUDE references. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 022e6c80-2ba9-480e-9d52-4826b8a04d26 --- docs/embedded/build/create-container-type.md | 4 ++-- docs/embedded/build/create-manage-containers.md | 2 +- docs/embedded/build/quickstart-vscode.md | 2 +- docs/embedded/build/sharepoint-embedded-mcp-server.md | 2 +- ...{spe-mcp-install.md => sharepoint-embedded-mcp-install.md} | 0 ...e-extension.md => sharepoint-embedded-vscode-extension.md} | 0 6 files changed, 5 insertions(+), 5 deletions(-) rename docs/embedded/includes/{spe-mcp-install.md => sharepoint-embedded-mcp-install.md} (100%) rename docs/embedded/includes/{spe-vscode-extension.md => sharepoint-embedded-vscode-extension.md} (100%) diff --git a/docs/embedded/build/create-container-type.md b/docs/embedded/build/create-container-type.md index 5eecca9a03..1e358e4496 100644 --- a/docs/embedded/build/create-container-type.md +++ b/docs/embedded/build/create-container-type.md @@ -29,9 +29,9 @@ To decide between single-tenant and multitenant models first, see [Choose an app You can create and configure a container type without calling the APIs directly: -[!INCLUDE [Add the SharePoint Embedded MCP server](../includes/spe-mcp-install.md)] +[!INCLUDE [Add the SharePoint Embedded MCP server](../includes/sharepoint-embedded-mcp-install.md)] -[!INCLUDE [Install the SharePoint Embedded VS Code extension](../includes/spe-vscode-extension.md)] +[!INCLUDE [Install the SharePoint Embedded VS Code extension](../includes/sharepoint-embedded-vscode-extension.md)] ## Understand the container type relationship diff --git a/docs/embedded/build/create-manage-containers.md b/docs/embedded/build/create-manage-containers.md index 64a8df19c7..8ba90b4b1e 100644 --- a/docs/embedded/build/create-manage-containers.md +++ b/docs/embedded/build/create-manage-containers.md @@ -27,7 +27,7 @@ Complete [Configure authentication and authorization](configure-authentication-a The [SharePoint Embedded MCP server](sharepoint-embedded-mcp-server.md) exposes container tools—such as `container_create`, `container_list`, `container_permissions_manage`, `container_archive_restore`, and `container_delete`—that a coding agent can call to manage containers through natural language. -[!INCLUDE [Add the SharePoint Embedded MCP server](../includes/spe-mcp-install.md)] +[!INCLUDE [Add the SharePoint Embedded MCP server](../includes/sharepoint-embedded-mcp-install.md)] ## Understand containers diff --git a/docs/embedded/build/quickstart-vscode.md b/docs/embedded/build/quickstart-vscode.md index 527c5f3278..ede8f81cb5 100644 --- a/docs/embedded/build/quickstart-vscode.md +++ b/docs/embedded/build/quickstart-vscode.md @@ -43,7 +43,7 @@ Before you start, make sure you have: ## Install the extension -[!INCLUDE [Install the SharePoint Embedded VS Code extension](../includes/spe-vscode-extension.md)] +[!INCLUDE [Install the SharePoint Embedded VS Code extension](../includes/sharepoint-embedded-vscode-extension.md)] Or install it from within the editor: diff --git a/docs/embedded/build/sharepoint-embedded-mcp-server.md b/docs/embedded/build/sharepoint-embedded-mcp-server.md index e269a5a4a5..7a6af02a6f 100644 --- a/docs/embedded/build/sharepoint-embedded-mcp-server.md +++ b/docs/embedded/build/sharepoint-embedded-mcp-server.md @@ -59,7 +59,7 @@ MCP clients launch the server with `npx`, so there's no separate global install. ### Add the server with one click -[!INCLUDE [Add the SharePoint Embedded MCP server](../includes/spe-mcp-install.md)] +[!INCLUDE [Add the SharePoint Embedded MCP server](../includes/sharepoint-embedded-mcp-install.md)] To add the server manually instead, use the following client-specific steps. diff --git a/docs/embedded/includes/spe-mcp-install.md b/docs/embedded/includes/sharepoint-embedded-mcp-install.md similarity index 100% rename from docs/embedded/includes/spe-mcp-install.md rename to docs/embedded/includes/sharepoint-embedded-mcp-install.md diff --git a/docs/embedded/includes/spe-vscode-extension.md b/docs/embedded/includes/sharepoint-embedded-vscode-extension.md similarity index 100% rename from docs/embedded/includes/spe-vscode-extension.md rename to docs/embedded/includes/sharepoint-embedded-vscode-extension.md From f8b8a365cbe8fd7463d567eb28cfc6127f8f9aab Mon Sep 17 00:00:00 2001 From: Shreyas Saravanan Date: Thu, 3 Sep 2026 12:24:29 +0530 Subject: [PATCH 3/7] Address review: hoist VS Code buttons above the fold; make Insiders a non-primary link Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 022e6c80-2ba9-480e-9d52-4826b8a04d26 --- docs/embedded/build/quickstart-vscode.md | 6 +++--- docs/embedded/build/sharepoint-embedded-mcp-server.md | 10 +++------- .../includes/sharepoint-embedded-mcp-install.md | 3 +-- 3 files changed, 7 insertions(+), 12 deletions(-) diff --git a/docs/embedded/build/quickstart-vscode.md b/docs/embedded/build/quickstart-vscode.md index ede8f81cb5..425e28ce59 100644 --- a/docs/embedded/build/quickstart-vscode.md +++ b/docs/embedded/build/quickstart-vscode.md @@ -21,6 +21,8 @@ next: create-container-type.md Use the [SharePoint Embedded Visual Studio Code extension](https://marketplace.visualstudio.com/items?itemName=SharepointEmbedded.ms-sharepoint-embedded-vscode-extension) to create a standard container type for your first app. The extension also configures the owning app, attaches Azure billing, and registers the container type. Then you create a container and run a local sample app. +[!INCLUDE [Install the SharePoint Embedded VS Code extension](../includes/sharepoint-embedded-vscode-extension.md)] + This article starts the build journey. For more billing guidance, see [Create and configure a container type](create-container-type.md). > [!TIP] @@ -43,9 +45,7 @@ Before you start, make sure you have: ## Install the extension -[!INCLUDE [Install the SharePoint Embedded VS Code extension](../includes/sharepoint-embedded-vscode-extension.md)] - -Or install it from within the editor: +Install the extension with the button at the top of this article, or from within the editor: 1. Open Visual Studio Code. 1. Open **Extensions** from the activity bar. diff --git a/docs/embedded/build/sharepoint-embedded-mcp-server.md b/docs/embedded/build/sharepoint-embedded-mcp-server.md index 7a6af02a6f..0e90046186 100644 --- a/docs/embedded/build/sharepoint-embedded-mcp-server.md +++ b/docs/embedded/build/sharepoint-embedded-mcp-server.md @@ -23,6 +23,8 @@ The SharePoint Embedded MCP server is an open-source [Model Context Protocol](ht Instead of clicking through portals and stitching together Microsoft Graph and Azure CLI commands by hand, you describe what you want—"create a trial container type for my app"—and the AI client calls the server's tools to do it. +[!INCLUDE [Add the SharePoint Embedded MCP server](../includes/sharepoint-embedded-mcp-install.md)] + > [!NOTE] > The SharePoint Embedded MCP server is an open-source developer tool released in preview. Its source code, full tool reference, and issue tracker live in the [microsoft/SharePoint-Embedded-MCP-Server](https://github.com/microsoft/SharePoint-Embedded-MCP-Server) repository on GitHub. @@ -55,13 +57,7 @@ For the complete, versioned list of tools, CLI flags, and environment variables, ## Install and configure -MCP clients launch the server with `npx`, so there's no separate global install. Add a server entry to your client's MCP configuration. - -### Add the server with one click - -[!INCLUDE [Add the SharePoint Embedded MCP server](../includes/sharepoint-embedded-mcp-install.md)] - -To add the server manually instead, use the following client-specific steps. +MCP clients launch the server with `npx`, so there's no separate global install. Use the one-click buttons at the top of this article, or add a server entry to your client's MCP configuration manually with the following client-specific steps. ### Visual Studio Code diff --git a/docs/embedded/includes/sharepoint-embedded-mcp-install.md b/docs/embedded/includes/sharepoint-embedded-mcp-install.md index 76aca5dd9e..a8fb32c98f 100644 --- a/docs/embedded/includes/sharepoint-embedded-mcp-install.md +++ b/docs/embedded/includes/sharepoint-embedded-mcp-install.md @@ -5,8 +5,7 @@ Add the SharePoint Embedded MCP server to a coding agent with one click: > [!div class="nextstepaction"] > [Add to Visual Studio Code](https://vscode.dev/redirect/mcp/install?name=spe&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40microsoft%2Fspe-mcp%22%2C%22start%22%5D%7D) -> [!div class="nextstepaction"] -> [Add to Visual Studio Code Insiders](https://insiders.vscode.dev/redirect/mcp/install?name=spe&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40microsoft%2Fspe-mcp%22%2C%22start%22%5D%7D) +Using the pre-release build? [Add the server to Visual Studio Code Insiders](https://insiders.vscode.dev/redirect/mcp/install?name=spe&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40microsoft%2Fspe-mcp%22%2C%22start%22%5D%7D). For other MCP clients, register the server with the same `npx` command: From ede07023d86ccb10e7ca218a49da22a0d2e87d77 Mon Sep 17 00:00:00 2001 From: Shreyas Saravanan Date: Thu, 3 Sep 2026 12:29:17 +0530 Subject: [PATCH 4/7] Move install buttons to the very top of the article, before intro prose Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 022e6c80-2ba9-480e-9d52-4826b8a04d26 --- docs/embedded/build/quickstart-vscode.md | 4 ++-- docs/embedded/build/sharepoint-embedded-mcp-server.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/embedded/build/quickstart-vscode.md b/docs/embedded/build/quickstart-vscode.md index 425e28ce59..763f7ebd60 100644 --- a/docs/embedded/build/quickstart-vscode.md +++ b/docs/embedded/build/quickstart-vscode.md @@ -19,10 +19,10 @@ outcome: Create a standard container type, attach billing, register it locally, next: create-container-type.md --> -Use the [SharePoint Embedded Visual Studio Code extension](https://marketplace.visualstudio.com/items?itemName=SharepointEmbedded.ms-sharepoint-embedded-vscode-extension) to create a standard container type for your first app. The extension also configures the owning app, attaches Azure billing, and registers the container type. Then you create a container and run a local sample app. - [!INCLUDE [Install the SharePoint Embedded VS Code extension](../includes/sharepoint-embedded-vscode-extension.md)] +Use the [SharePoint Embedded Visual Studio Code extension](https://marketplace.visualstudio.com/items?itemName=SharepointEmbedded.ms-sharepoint-embedded-vscode-extension) to create a standard container type for your first app. The extension also configures the owning app, attaches Azure billing, and registers the container type. Then you create a container and run a local sample app. + This article starts the build journey. For more billing guidance, see [Create and configure a container type](create-container-type.md). > [!TIP] diff --git a/docs/embedded/build/sharepoint-embedded-mcp-server.md b/docs/embedded/build/sharepoint-embedded-mcp-server.md index 0e90046186..24aeba6941 100644 --- a/docs/embedded/build/sharepoint-embedded-mcp-server.md +++ b/docs/embedded/build/sharepoint-embedded-mcp-server.md @@ -19,12 +19,12 @@ outcome: Use the SharePoint Embedded MCP server with a coding agent to provision next: quickstart-vscode.md --> +[!INCLUDE [Add the SharePoint Embedded MCP server](../includes/sharepoint-embedded-mcp-install.md)] + The SharePoint Embedded MCP server is an open-source [Model Context Protocol](https://modelcontextprotocol.io/) server that lets MCP-compatible AI clients set up and manage SharePoint Embedded applications through natural language. Supported clients include GitHub Copilot in Visual Studio Code or CLI, Claude Desktop, Cursor, and Azure AI Foundry. It's distributed as the [`@microsoft/spe-mcp`](https://github.com/microsoft/SharePoint-Embedded-MCP-Server) npm package and runs locally on your machine as a developer tool. Instead of clicking through portals and stitching together Microsoft Graph and Azure CLI commands by hand, you describe what you want—"create a trial container type for my app"—and the AI client calls the server's tools to do it. -[!INCLUDE [Add the SharePoint Embedded MCP server](../includes/sharepoint-embedded-mcp-install.md)] - > [!NOTE] > The SharePoint Embedded MCP server is an open-source developer tool released in preview. Its source code, full tool reference, and issue tracker live in the [microsoft/SharePoint-Embedded-MCP-Server](https://github.com/microsoft/SharePoint-Embedded-MCP-Server) repository on GitHub. From c36d8596495894d8ceea2f57b53d11f84ed45b16 Mon Sep 17 00:00:00 2001 From: Shreyas Saravanan Date: Thu, 3 Sep 2026 12:35:05 +0530 Subject: [PATCH 5/7] Move install buttons to the top on create-container-type and create-manage-containers Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 022e6c80-2ba9-480e-9d52-4826b8a04d26 --- docs/embedded/build/create-container-type.md | 12 ++++-------- docs/embedded/build/create-manage-containers.md | 4 ++-- 2 files changed, 6 insertions(+), 10 deletions(-) diff --git a/docs/embedded/build/create-container-type.md b/docs/embedded/build/create-container-type.md index 1e358e4496..eb07182ed4 100644 --- a/docs/embedded/build/create-container-type.md +++ b/docs/embedded/build/create-container-type.md @@ -19,20 +19,16 @@ outcome: Create a container type, connect it to an owning app, and choose the ri next: register-application-permissions.md --> +[!INCLUDE [Add the SharePoint Embedded MCP server](../includes/sharepoint-embedded-mcp-install.md)] + +[!INCLUDE [Install the SharePoint Embedded VS Code extension](../includes/sharepoint-embedded-vscode-extension.md)] + Create a SharePoint Embedded container type for your application to create containers or store files. A container type defines access, billing accountability, and selected behaviors for containers created by your app. If you're just starting, complete [Quickstart: Build your first app with VS Code](quickstart-vscode.md). Then use this article for trial, standard, and pass-through decisions. To decide between single-tenant and multitenant models first, see [Choose an app model](../plan/choose-app-model.md). -## Create a container type with a coding agent or the VS Code extension - -You can create and configure a container type without calling the APIs directly: - -[!INCLUDE [Add the SharePoint Embedded MCP server](../includes/sharepoint-embedded-mcp-install.md)] - -[!INCLUDE [Install the SharePoint Embedded VS Code extension](../includes/sharepoint-embedded-vscode-extension.md)] - ## Understand the container type relationship A container type is strongly coupled with one Microsoft Entra ID application, called the owning application. diff --git a/docs/embedded/build/create-manage-containers.md b/docs/embedded/build/create-manage-containers.md index 8ba90b4b1e..9bcd1ef364 100644 --- a/docs/embedded/build/create-manage-containers.md +++ b/docs/embedded/build/create-manage-containers.md @@ -19,6 +19,8 @@ outcome: Implement the basic SharePoint Embedded container lifecycle for applica next: manage-files.md --> +[!INCLUDE [Add the SharePoint Embedded MCP server](../includes/sharepoint-embedded-mcp-install.md)] + Create and manage containers after your container type is created, registered, and authorized. Containers are the basic storage unit in SharePoint Embedded. Complete [Configure authentication and authorization](configure-authentication-authorization.md) before you call container APIs. @@ -27,8 +29,6 @@ Complete [Configure authentication and authorization](configure-authentication-a The [SharePoint Embedded MCP server](sharepoint-embedded-mcp-server.md) exposes container tools—such as `container_create`, `container_list`, `container_permissions_manage`, `container_archive_restore`, and `container_delete`—that a coding agent can call to manage containers through natural language. -[!INCLUDE [Add the SharePoint Embedded MCP server](../includes/sharepoint-embedded-mcp-install.md)] - ## Understand containers All SharePoint Embedded files and documents are stored in containers. From a76294e93df4447561e10502e1e8100c4d3eed8e Mon Sep 17 00:00:00 2001 From: Shreyas Saravanan Date: Thu, 3 Sep 2026 13:33:13 +0530 Subject: [PATCH 6/7] Add one-click Add to Cursor and Add to LM Studio MCP install buttons Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 022e6c80-2ba9-480e-9d52-4826b8a04d26 --- docs/embedded/includes/sharepoint-embedded-mcp-install.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/embedded/includes/sharepoint-embedded-mcp-install.md b/docs/embedded/includes/sharepoint-embedded-mcp-install.md index a8fb32c98f..e8544e11c3 100644 --- a/docs/embedded/includes/sharepoint-embedded-mcp-install.md +++ b/docs/embedded/includes/sharepoint-embedded-mcp-install.md @@ -5,6 +5,12 @@ Add the SharePoint Embedded MCP server to a coding agent with one click: > [!div class="nextstepaction"] > [Add to Visual Studio Code](https://vscode.dev/redirect/mcp/install?name=spe&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40microsoft%2Fspe-mcp%22%2C%22start%22%5D%7D) +> [!div class="nextstepaction"] +> [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=spe&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBtaWNyb3NvZnQvc3BlLW1jcCIsInN0YXJ0Il19) + +> [!div class="nextstepaction"] +> [Add to LM Studio](lmstudio://add_mcp?name=spe&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBtaWNyb3NvZnQvc3BlLW1jcCIsInN0YXJ0Il19) + Using the pre-release build? [Add the server to Visual Studio Code Insiders](https://insiders.vscode.dev/redirect/mcp/install?name=spe&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40microsoft%2Fspe-mcp%22%2C%22start%22%5D%7D). For other MCP clients, register the server with the same `npx` command: From 84a9cceed9f5c58ad803f0420f52a60f81e95af8 Mon Sep 17 00:00:00 2001 From: Shreyas Saravanan Date: Thu, 3 Sep 2026 13:39:28 +0530 Subject: [PATCH 7/7] Revert Cursor and LM Studio buttons (custom URI schemes flagged as disallowed-domain by Learn) Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 022e6c80-2ba9-480e-9d52-4826b8a04d26 --- docs/embedded/includes/sharepoint-embedded-mcp-install.md | 6 ------ 1 file changed, 6 deletions(-) diff --git a/docs/embedded/includes/sharepoint-embedded-mcp-install.md b/docs/embedded/includes/sharepoint-embedded-mcp-install.md index e8544e11c3..a8fb32c98f 100644 --- a/docs/embedded/includes/sharepoint-embedded-mcp-install.md +++ b/docs/embedded/includes/sharepoint-embedded-mcp-install.md @@ -5,12 +5,6 @@ Add the SharePoint Embedded MCP server to a coding agent with one click: > [!div class="nextstepaction"] > [Add to Visual Studio Code](https://vscode.dev/redirect/mcp/install?name=spe&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40microsoft%2Fspe-mcp%22%2C%22start%22%5D%7D) -> [!div class="nextstepaction"] -> [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=spe&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBtaWNyb3NvZnQvc3BlLW1jcCIsInN0YXJ0Il19) - -> [!div class="nextstepaction"] -> [Add to LM Studio](lmstudio://add_mcp?name=spe&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBtaWNyb3NvZnQvc3BlLW1jcCIsInN0YXJ0Il19) - Using the pre-release build? [Add the server to Visual Studio Code Insiders](https://insiders.vscode.dev/redirect/mcp/install?name=spe&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40microsoft%2Fspe-mcp%22%2C%22start%22%5D%7D). For other MCP clients, register the server with the same `npx` command: