Add MCP server and VS Code extension affordances to SharePoint Embedded build docs

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:

docs/embedded/build/create-container-type.md

@@ -19,6 +19,10 @@ 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.

docs/embedded/build/create-manage-containers.md

@@ -19,10 +19,16 @@ 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.
 
+## 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.
+
 ## Understand containers
 
 All SharePoint Embedded files and documents are stored in containers.

docs/embedded/build/quickstart-vscode.md

@@ -19,10 +19,15 @@ outcome: Create a standard container type, attach billing, register it locally,
 next: create-container-type.md
 -->
 
+[!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]
+> 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 +45,8 @@ Before you start, make sure you have:
 
 ## Install the extension
 
+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.
 1. Search for **SharePoint Embedded**.

docs/embedded/build/sharepoint-embedded-mcp-server.md

@@ -19,6 +19,8 @@ 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.
@@ -55,7 +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.
+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
 

docs/embedded/includes/sharepoint-embedded-mcp-install.md

@@ -0,0 +1,18 @@
+<!-- This is an include file. Don't add a title or H1 heading. -->
+
+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)
+
+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:
+
+```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
+```

docs/embedded/includes/sharepoint-embedded-vscode-extension.md

@@ -0,0 +1,6 @@
+<!-- This is an include file. Don't add a title or H1 heading. -->
+
+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)

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)