From eafc4a53086ad8beb5a94f56c05d75526cf0c224 Mon Sep 17 00:00:00 2001 From: Greg Joseph Date: Wed, 15 Jul 2026 11:54:35 -0700 Subject: [PATCH 1/7] Add MCP install buttons to SharePoint Embedded MCP server article Adds a docs-to-devtools install-buttons include to the SharePoint Embedded MCP server Learn article (Install and configure section): a native 'Install in Visual Studio Code' next-step-action button plus one-click install links for VS Code Insiders, Visual Studio, and Cursor, and the claude/codex 'mcp add' CLI commands. Scoped to the MCP server page only for now. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- docs/embedded/build/sharepoint-embedded-mcp-server.md | 2 ++ docs/embedded/includes/mcp-install-buttons.md | 7 +++++++ 2 files changed, 9 insertions(+) create mode 100644 docs/embedded/includes/mcp-install-buttons.md diff --git a/docs/embedded/build/sharepoint-embedded-mcp-server.md b/docs/embedded/build/sharepoint-embedded-mcp-server.md index 831e130c7..8b2e8e39d 100644 --- a/docs/embedded/build/sharepoint-embedded-mcp-server.md +++ b/docs/embedded/build/sharepoint-embedded-mcp-server.md @@ -42,6 +42,8 @@ For the complete, versioned list of tools, CLI flags, and environment variables, ## Install and configure +[!INCLUDE [Install the SharePoint Embedded MCP server](../includes/mcp-install-buttons.md)] + MCP clients launch the server with `npx`, so there's no separate global install. Add a server entry to your client's MCP configuration. ### Visual Studio Code diff --git a/docs/embedded/includes/mcp-install-buttons.md b/docs/embedded/includes/mcp-install-buttons.md new file mode 100644 index 000000000..51a33d441 --- /dev/null +++ b/docs/embedded/includes/mcp-install-buttons.md @@ -0,0 +1,7 @@ + + +> [!div class="nextstepaction"] +> [Install in Visual Studio Code](https://vscode.dev/redirect?url=vscode:mcp/install?%7B%22name%22%3A%22spe%22%2C%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) + +One-click install is also available for [Visual Studio Code Insiders](https://vscode.dev/redirect?url=vscode-insiders:mcp/install?%7B%22name%22%3A%22spe%22%2C%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), [Visual Studio](https://aka.ms/vs/mcp-install?%7B%22name%22%3A%22spe%22%2C%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), and [Cursor](https://cursor.com/install-mcp?name=spe&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBtaWNyb3NvZnQvc3BlLW1jcCIsInN0YXJ0Il19). From the command line, run `claude mcp add spe -- npx -y @microsoft/spe-mcp start` for Claude Code or `codex mcp add spe -- npx -y @microsoft/spe-mcp start` for the Codex CLI. From 5dfce5473ef05ef4223844b1ca035ba02e5d1986 Mon Sep 17 00:00:00 2001 From: grjoseph Date: Mon, 10 Aug 2026 12:29:36 -0700 Subject: [PATCH 2/7] Expand attributed MCP install buttons across SPE docs Add Microsoft Learn source and campaign arguments to every supported install path, and surface the reusable install include on high-intent SharePoint Embedded build articles. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- docs/embedded/build/create-container-type.md | 6 +++++- docs/embedded/build/create-manage-containers.md | 6 +++++- docs/embedded/build/quickstart-vscode.md | 7 ++++++- docs/embedded/build/sharepoint-embedded-mcp-server.md | 2 +- docs/embedded/includes/mcp-install-buttons.md | 4 ++-- 5 files changed, 19 insertions(+), 6 deletions(-) diff --git a/docs/embedded/build/create-container-type.md b/docs/embedded/build/create-container-type.md index 6a521785d..ae453ee53 100644 --- a/docs/embedded/build/create-container-type.md +++ b/docs/embedded/build/create-container-type.md @@ -1,7 +1,7 @@ --- title: Create and configure a container type description: Create a trial or production SharePoint Embedded container type and configure its owning app and billing model. -ms.date: 07/13/2026 +ms.date: 08/10/2026 ms.reviewer: stpuceli ms.author: mawin ms.localizationpriority: high @@ -77,6 +77,10 @@ You can create one with the SharePoint Embedded Visual Studio Code extension or The Visual Studio Code path is fastest for a first app. See [Quickstart: Build your first app with VS Code](quickstart-vscode.md). +You can also create and configure a container type through a coding agent by installing the SharePoint Embedded MCP server. + +[!INCLUDE [Install the SharePoint Embedded MCP server](../includes/mcp-install-buttons.md)] + For Microsoft Graph, create the container type with the `trial` billing classification. The following restrictions are applied to trial container types: diff --git a/docs/embedded/build/create-manage-containers.md b/docs/embedded/build/create-manage-containers.md index 9c35aecfa..206ee2615 100644 --- a/docs/embedded/build/create-manage-containers.md +++ b/docs/embedded/build/create-manage-containers.md @@ -1,7 +1,7 @@ --- title: Create and Manage Containers description: Create, list, update, recycle, restore, and delete SharePoint Embedded containers in your app. -ms.date: 07/13/2026 +ms.date: 08/10/2026 ms.reviewer: jaeccles ms.author: mawin ms.localizationpriority: high @@ -23,6 +23,10 @@ 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. +You can also manage the container lifecycle through a coding agent by installing the SharePoint Embedded MCP server. + +[!INCLUDE [Install the SharePoint Embedded MCP server](../includes/mcp-install-buttons.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 759b0ea7e..d74a23af1 100644 --- a/docs/embedded/build/quickstart-vscode.md +++ b/docs/embedded/build/quickstart-vscode.md @@ -1,7 +1,7 @@ --- title: "Quickstart: Build your first app with VS Code" description: Create a standard SharePoint Embedded container type in Visual Studio Code and run the sample application locally. -ms.date: 07/13/2026 +ms.date: 08/10/2026 ms.reviewer: mawin ms.author: mawin ms.localizationpriority: high @@ -23,6 +23,11 @@ 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 through a coding agent? Install the SharePoint Embedded MCP server. + +[!INCLUDE [Install the SharePoint Embedded MCP server](../includes/mcp-install-buttons.md)] + ## Prerequisites Before you start, make sure you have: diff --git a/docs/embedded/build/sharepoint-embedded-mcp-server.md b/docs/embedded/build/sharepoint-embedded-mcp-server.md index 8b2e8e39d..87042ce96 100644 --- a/docs/embedded/build/sharepoint-embedded-mcp-server.md +++ b/docs/embedded/build/sharepoint-embedded-mcp-server.md @@ -1,7 +1,7 @@ --- title: Use the MCP server to build apps with a coding agent description: Use the open-source SharePoint Embedded MCP server with a coding agent to provision, configure, scaffold, and manage SharePoint Embedded applications through natural language. -ms.date: 07/10/2026 +ms.date: 08/10/2026 ms.localizationpriority: high ms.author: grjoseph ai-usage: ai-assisted diff --git a/docs/embedded/includes/mcp-install-buttons.md b/docs/embedded/includes/mcp-install-buttons.md index 51a33d441..7c3e9a61a 100644 --- a/docs/embedded/includes/mcp-install-buttons.md +++ b/docs/embedded/includes/mcp-install-buttons.md @@ -2,6 +2,6 @@ Included by developer-facing SharePoint Embedded articles. Do not add page frontmatter—this file is not a standalone article. --> > [!div class="nextstepaction"] -> [Install in Visual Studio Code](https://vscode.dev/redirect?url=vscode:mcp/install?%7B%22name%22%3A%22spe%22%2C%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) +> [Install in Visual Studio Code](https://vscode.dev/redirect?url=vscode:mcp/install?%7B%22name%22%3A%22spe%22%2C%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%2C%22--install-source%22%2C%22microsoft-learn%22%2C%22--install-campaign%22%2C%22docs-install-buttons%22%5D%7D) -One-click install is also available for [Visual Studio Code Insiders](https://vscode.dev/redirect?url=vscode-insiders:mcp/install?%7B%22name%22%3A%22spe%22%2C%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), [Visual Studio](https://aka.ms/vs/mcp-install?%7B%22name%22%3A%22spe%22%2C%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), and [Cursor](https://cursor.com/install-mcp?name=spe&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBtaWNyb3NvZnQvc3BlLW1jcCIsInN0YXJ0Il19). From the command line, run `claude mcp add spe -- npx -y @microsoft/spe-mcp start` for Claude Code or `codex mcp add spe -- npx -y @microsoft/spe-mcp start` for the Codex CLI. +One-click install is also available for [Visual Studio Code Insiders](https://vscode.dev/redirect?url=vscode-insiders:mcp/install?%7B%22name%22%3A%22spe%22%2C%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%2C%22--install-source%22%2C%22microsoft-learn%22%2C%22--install-campaign%22%2C%22docs-install-buttons%22%5D%7D), [Visual Studio](https://aka.ms/vs/mcp-install?%7B%22name%22%3A%22spe%22%2C%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%2C%22--install-source%22%2C%22microsoft-learn%22%2C%22--install-campaign%22%2C%22docs-install-buttons%22%5D%7D), and [Cursor](https://cursor.com/install-mcp?name=spe&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBtaWNyb3NvZnQvc3BlLW1jcCIsInN0YXJ0IiwiLS1pbnN0YWxsLXNvdXJjZSIsIm1pY3Jvc29mdC1sZWFybiIsIi0taW5zdGFsbC1jYW1wYWlnbiIsImRvY3MtaW5zdGFsbC1idXR0b25zIl19). From the command line, run `claude mcp add spe -- npx -y @microsoft/spe-mcp start --install-source microsoft-learn --install-campaign docs-install-buttons` for Claude Code or `codex mcp add spe -- npx -y @microsoft/spe-mcp start --install-source microsoft-learn --install-campaign docs-install-buttons` for the Codex CLI. From 446e83db3fdbd71773c3efab9875d0236fd0a78f Mon Sep 17 00:00:00 2001 From: grjoseph Date: Tue, 11 Aug 2026 07:03:00 -0700 Subject: [PATCH 3/7] Restore existing article dates Keep ms.date unchanged while adding the reusable MCP install include. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- docs/embedded/build/create-container-type.md | 2 +- docs/embedded/build/create-manage-containers.md | 2 +- docs/embedded/build/quickstart-vscode.md | 2 +- docs/embedded/build/sharepoint-embedded-mcp-server.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/embedded/build/create-container-type.md b/docs/embedded/build/create-container-type.md index ae453ee53..cdeb1c89e 100644 --- a/docs/embedded/build/create-container-type.md +++ b/docs/embedded/build/create-container-type.md @@ -1,7 +1,7 @@ --- title: Create and configure a container type description: Create a trial or production SharePoint Embedded container type and configure its owning app and billing model. -ms.date: 08/10/2026 +ms.date: 07/13/2026 ms.reviewer: stpuceli ms.author: mawin ms.localizationpriority: high diff --git a/docs/embedded/build/create-manage-containers.md b/docs/embedded/build/create-manage-containers.md index 206ee2615..37815eeea 100644 --- a/docs/embedded/build/create-manage-containers.md +++ b/docs/embedded/build/create-manage-containers.md @@ -1,7 +1,7 @@ --- title: Create and Manage Containers description: Create, list, update, recycle, restore, and delete SharePoint Embedded containers in your app. -ms.date: 08/10/2026 +ms.date: 07/13/2026 ms.reviewer: jaeccles ms.author: mawin ms.localizationpriority: high diff --git a/docs/embedded/build/quickstart-vscode.md b/docs/embedded/build/quickstart-vscode.md index d74a23af1..4a8a582c1 100644 --- a/docs/embedded/build/quickstart-vscode.md +++ b/docs/embedded/build/quickstart-vscode.md @@ -1,7 +1,7 @@ --- title: "Quickstart: Build your first app with VS Code" description: Create a standard SharePoint Embedded container type in Visual Studio Code and run the sample application locally. -ms.date: 08/10/2026 +ms.date: 07/13/2026 ms.reviewer: mawin ms.author: mawin ms.localizationpriority: high diff --git a/docs/embedded/build/sharepoint-embedded-mcp-server.md b/docs/embedded/build/sharepoint-embedded-mcp-server.md index 87042ce96..8b2e8e39d 100644 --- a/docs/embedded/build/sharepoint-embedded-mcp-server.md +++ b/docs/embedded/build/sharepoint-embedded-mcp-server.md @@ -1,7 +1,7 @@ --- title: Use the MCP server to build apps with a coding agent description: Use the open-source SharePoint Embedded MCP server with a coding agent to provision, configure, scaffold, and manage SharePoint Embedded applications through natural language. -ms.date: 08/10/2026 +ms.date: 07/10/2026 ms.localizationpriority: high ms.author: grjoseph ai-usage: ai-assisted From 41e7a9cc7387b58bcee6c54918f62992260b5f49 Mon Sep 17 00:00:00 2001 From: grjoseph Date: Tue, 11 Aug 2026 09:53:16 -0700 Subject: [PATCH 4/7] Align MCP install copy with SPE docs guidance Expand MCP on first use, use direct active-voice instructions, and simplify the reusable install text after reviewing the PR with the internal SPE documentation skills. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- docs/embedded/build/create-container-type.md | 2 +- docs/embedded/build/create-manage-containers.md | 2 +- docs/embedded/build/quickstart-vscode.md | 2 +- docs/embedded/includes/mcp-install-buttons.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/embedded/build/create-container-type.md b/docs/embedded/build/create-container-type.md index cdeb1c89e..cba9e5066 100644 --- a/docs/embedded/build/create-container-type.md +++ b/docs/embedded/build/create-container-type.md @@ -77,7 +77,7 @@ You can create one with the SharePoint Embedded Visual Studio Code extension or The Visual Studio Code path is fastest for a first app. See [Quickstart: Build your first app with VS Code](quickstart-vscode.md). -You can also create and configure a container type through a coding agent by installing the SharePoint Embedded MCP server. +To create and configure a container type through a coding agent, install the SharePoint Embedded Model Context Protocol (MCP) server. [!INCLUDE [Install the SharePoint Embedded MCP server](../includes/mcp-install-buttons.md)] diff --git a/docs/embedded/build/create-manage-containers.md b/docs/embedded/build/create-manage-containers.md index 37815eeea..a2c18eacd 100644 --- a/docs/embedded/build/create-manage-containers.md +++ b/docs/embedded/build/create-manage-containers.md @@ -23,7 +23,7 @@ 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. -You can also manage the container lifecycle through a coding agent by installing the SharePoint Embedded MCP server. +To manage the container lifecycle through a coding agent, install the SharePoint Embedded Model Context Protocol (MCP) server. [!INCLUDE [Install the SharePoint Embedded MCP server](../includes/mcp-install-buttons.md)] diff --git a/docs/embedded/build/quickstart-vscode.md b/docs/embedded/build/quickstart-vscode.md index 4a8a582c1..b7137eb52 100644 --- a/docs/embedded/build/quickstart-vscode.md +++ b/docs/embedded/build/quickstart-vscode.md @@ -24,7 +24,7 @@ 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 through a coding agent? Install the SharePoint Embedded MCP server. +> To build through a coding agent, install the SharePoint Embedded Model Context Protocol (MCP) server. [!INCLUDE [Install the SharePoint Embedded MCP server](../includes/mcp-install-buttons.md)] diff --git a/docs/embedded/includes/mcp-install-buttons.md b/docs/embedded/includes/mcp-install-buttons.md index 7c3e9a61a..e73c4b0f1 100644 --- a/docs/embedded/includes/mcp-install-buttons.md +++ b/docs/embedded/includes/mcp-install-buttons.md @@ -4,4 +4,4 @@ > [!div class="nextstepaction"] > [Install in Visual Studio Code](https://vscode.dev/redirect?url=vscode:mcp/install?%7B%22name%22%3A%22spe%22%2C%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%2C%22--install-source%22%2C%22microsoft-learn%22%2C%22--install-campaign%22%2C%22docs-install-buttons%22%5D%7D) -One-click install is also available for [Visual Studio Code Insiders](https://vscode.dev/redirect?url=vscode-insiders:mcp/install?%7B%22name%22%3A%22spe%22%2C%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%2C%22--install-source%22%2C%22microsoft-learn%22%2C%22--install-campaign%22%2C%22docs-install-buttons%22%5D%7D), [Visual Studio](https://aka.ms/vs/mcp-install?%7B%22name%22%3A%22spe%22%2C%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%2C%22--install-source%22%2C%22microsoft-learn%22%2C%22--install-campaign%22%2C%22docs-install-buttons%22%5D%7D), and [Cursor](https://cursor.com/install-mcp?name=spe&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBtaWNyb3NvZnQvc3BlLW1jcCIsInN0YXJ0IiwiLS1pbnN0YWxsLXNvdXJjZSIsIm1pY3Jvc29mdC1sZWFybiIsIi0taW5zdGFsbC1jYW1wYWlnbiIsImRvY3MtaW5zdGFsbC1idXR0b25zIl19). From the command line, run `claude mcp add spe -- npx -y @microsoft/spe-mcp start --install-source microsoft-learn --install-campaign docs-install-buttons` for Claude Code or `codex mcp add spe -- npx -y @microsoft/spe-mcp start --install-source microsoft-learn --install-campaign docs-install-buttons` for the Codex CLI. +Install with one click in [Visual Studio Code Insiders](https://vscode.dev/redirect?url=vscode-insiders:mcp/install?%7B%22name%22%3A%22spe%22%2C%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%2C%22--install-source%22%2C%22microsoft-learn%22%2C%22--install-campaign%22%2C%22docs-install-buttons%22%5D%7D), [Visual Studio](https://aka.ms/vs/mcp-install?%7B%22name%22%3A%22spe%22%2C%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%2C%22--install-source%22%2C%22microsoft-learn%22%2C%22--install-campaign%22%2C%22docs-install-buttons%22%5D%7D), or [Cursor](https://cursor.com/install-mcp?name=spe&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBtaWNyb3NvZnQvc3BlLW1jcCIsInN0YXJ0IiwiLS1pbnN0YWxsLXNvdXJjZSIsIm1pY3Jvc29mdC1sZWFybiIsIi0taW5zdGFsbC1jYW1wYWlnbiIsImRvY3MtaW5zdGFsbC1idXR0b25zIl19). From the command line, run `claude mcp add spe -- npx -y @microsoft/spe-mcp start --install-source microsoft-learn --install-campaign docs-install-buttons` for Claude Code or `codex mcp add spe -- npx -y @microsoft/spe-mcp start --install-source microsoft-learn --install-campaign docs-install-buttons` for the Codex CLI. From dff552a4ed07dca05cb140cb0bfeddfc64ec0ac8 Mon Sep 17 00:00:00 2001 From: grjoseph Date: Tue, 11 Aug 2026 13:43:59 -0700 Subject: [PATCH 5/7] Use managed aka.ms MCP install links Replace long editor-specific install URLs with validated, team-owned aka.ms aliases while preserving attributed Claude and Codex command examples. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- docs/embedded/includes/mcp-install-buttons.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/embedded/includes/mcp-install-buttons.md b/docs/embedded/includes/mcp-install-buttons.md index e73c4b0f1..4633f2e6e 100644 --- a/docs/embedded/includes/mcp-install-buttons.md +++ b/docs/embedded/includes/mcp-install-buttons.md @@ -2,6 +2,6 @@ Included by developer-facing SharePoint Embedded articles. Do not add page frontmatter—this file is not a standalone article. --> > [!div class="nextstepaction"] -> [Install in Visual Studio Code](https://vscode.dev/redirect?url=vscode:mcp/install?%7B%22name%22%3A%22spe%22%2C%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%2C%22--install-source%22%2C%22microsoft-learn%22%2C%22--install-campaign%22%2C%22docs-install-buttons%22%5D%7D) +> [Install in Visual Studio Code](https://aka.ms/spe-mcp/install/learn/vscode) -Install with one click in [Visual Studio Code Insiders](https://vscode.dev/redirect?url=vscode-insiders:mcp/install?%7B%22name%22%3A%22spe%22%2C%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%2C%22--install-source%22%2C%22microsoft-learn%22%2C%22--install-campaign%22%2C%22docs-install-buttons%22%5D%7D), [Visual Studio](https://aka.ms/vs/mcp-install?%7B%22name%22%3A%22spe%22%2C%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%2C%22--install-source%22%2C%22microsoft-learn%22%2C%22--install-campaign%22%2C%22docs-install-buttons%22%5D%7D), or [Cursor](https://cursor.com/install-mcp?name=spe&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBtaWNyb3NvZnQvc3BlLW1jcCIsInN0YXJ0IiwiLS1pbnN0YWxsLXNvdXJjZSIsIm1pY3Jvc29mdC1sZWFybiIsIi0taW5zdGFsbC1jYW1wYWlnbiIsImRvY3MtaW5zdGFsbC1idXR0b25zIl19). From the command line, run `claude mcp add spe -- npx -y @microsoft/spe-mcp start --install-source microsoft-learn --install-campaign docs-install-buttons` for Claude Code or `codex mcp add spe -- npx -y @microsoft/spe-mcp start --install-source microsoft-learn --install-campaign docs-install-buttons` for the Codex CLI. +Install with one click in [Visual Studio Code Insiders](https://aka.ms/spe-mcp/install/learn/vscode-insiders), [Visual Studio](https://aka.ms/spe-mcp/install/learn/visual-studio), or [Cursor](https://aka.ms/spe-mcp/install/learn/cursor). From the command line, run `claude mcp add spe -- npx -y @microsoft/spe-mcp start --install-source microsoft-learn --install-campaign docs-install-buttons` for Claude Code or `codex mcp add spe -- npx -y @microsoft/spe-mcp start --install-source microsoft-learn --install-campaign docs-install-buttons` for the Codex CLI. From 194d36392b90fee1d5fbca70deb9e8f266078d48 Mon Sep 17 00:00:00 2001 From: grjoseph Date: Tue, 11 Aug 2026 13:59:05 -0700 Subject: [PATCH 6/7] Improve MCP install block layout Keep the reusable one-click links compact and move Claude Code and Codex CLI commands into a dedicated, copyable console section on the MCP article. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- docs/embedded/build/sharepoint-embedded-mcp-server.md | 9 +++++++++ docs/embedded/includes/mcp-install-buttons.md | 2 +- 2 files changed, 10 insertions(+), 1 deletion(-) diff --git a/docs/embedded/build/sharepoint-embedded-mcp-server.md b/docs/embedded/build/sharepoint-embedded-mcp-server.md index 8b2e8e39d..ab872666b 100644 --- a/docs/embedded/build/sharepoint-embedded-mcp-server.md +++ b/docs/embedded/build/sharepoint-embedded-mcp-server.md @@ -79,6 +79,15 @@ Add the server to `%APPDATA%\Claude\claude_desktop_config.json` (Windows) or `~/ } ``` +### Claude Code and Codex CLI + +Add the server from a terminal: + +```console +claude mcp add spe -- npx -y @microsoft/spe-mcp start --install-source microsoft-learn --install-campaign docs-install-buttons +codex mcp add spe -- npx -y @microsoft/spe-mcp start --install-source microsoft-learn --install-campaign docs-install-buttons +``` + ### Cursor and other MCP clients Any client that supports MCP servers over the stdio transport can run the server with the same `npx -y @microsoft/spe-mcp` command. See your client's documentation for where to register MCP servers. diff --git a/docs/embedded/includes/mcp-install-buttons.md b/docs/embedded/includes/mcp-install-buttons.md index 4633f2e6e..5671f08c6 100644 --- a/docs/embedded/includes/mcp-install-buttons.md +++ b/docs/embedded/includes/mcp-install-buttons.md @@ -4,4 +4,4 @@ > [!div class="nextstepaction"] > [Install in Visual Studio Code](https://aka.ms/spe-mcp/install/learn/vscode) -Install with one click in [Visual Studio Code Insiders](https://aka.ms/spe-mcp/install/learn/vscode-insiders), [Visual Studio](https://aka.ms/spe-mcp/install/learn/visual-studio), or [Cursor](https://aka.ms/spe-mcp/install/learn/cursor). From the command line, run `claude mcp add spe -- npx -y @microsoft/spe-mcp start --install-source microsoft-learn --install-campaign docs-install-buttons` for Claude Code or `codex mcp add spe -- npx -y @microsoft/spe-mcp start --install-source microsoft-learn --install-campaign docs-install-buttons` for the Codex CLI. +Install with one click in [Visual Studio Code Insiders](https://aka.ms/spe-mcp/install/learn/vscode-insiders), [Visual Studio](https://aka.ms/spe-mcp/install/learn/visual-studio), or [Cursor](https://aka.ms/spe-mcp/install/learn/cursor). For Claude Code or the Codex CLI, use the [command-line setup](../build/sharepoint-embedded-mcp-server.md#claude-code-and-codex-cli). From 1c7bded8b008d596383268a554715236d584abd8 Mon Sep 17 00:00:00 2001 From: grjoseph Date: Tue, 11 Aug 2026 14:07:22 -0700 Subject: [PATCH 7/7] Refine MCP client setup layout List alternative clients as scannable links and keep Claude Code and Codex CLI commands free of visible attribution parameters. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- docs/embedded/build/sharepoint-embedded-mcp-server.md | 4 ++-- docs/embedded/includes/mcp-install-buttons.md | 8 +++++++- 2 files changed, 9 insertions(+), 3 deletions(-) diff --git a/docs/embedded/build/sharepoint-embedded-mcp-server.md b/docs/embedded/build/sharepoint-embedded-mcp-server.md index ab872666b..5dc7188de 100644 --- a/docs/embedded/build/sharepoint-embedded-mcp-server.md +++ b/docs/embedded/build/sharepoint-embedded-mcp-server.md @@ -84,8 +84,8 @@ Add the server to `%APPDATA%\Claude\claude_desktop_config.json` (Windows) or `~/ Add the server from a terminal: ```console -claude mcp add spe -- npx -y @microsoft/spe-mcp start --install-source microsoft-learn --install-campaign docs-install-buttons -codex mcp add spe -- npx -y @microsoft/spe-mcp start --install-source microsoft-learn --install-campaign docs-install-buttons +claude mcp add spe -- npx -y @microsoft/spe-mcp start +codex mcp add spe -- npx -y @microsoft/spe-mcp start ``` ### Cursor and other MCP clients diff --git a/docs/embedded/includes/mcp-install-buttons.md b/docs/embedded/includes/mcp-install-buttons.md index 5671f08c6..855042651 100644 --- a/docs/embedded/includes/mcp-install-buttons.md +++ b/docs/embedded/includes/mcp-install-buttons.md @@ -4,4 +4,10 @@ > [!div class="nextstepaction"] > [Install in Visual Studio Code](https://aka.ms/spe-mcp/install/learn/vscode) -Install with one click in [Visual Studio Code Insiders](https://aka.ms/spe-mcp/install/learn/vscode-insiders), [Visual Studio](https://aka.ms/spe-mcp/install/learn/visual-studio), or [Cursor](https://aka.ms/spe-mcp/install/learn/cursor). For Claude Code or the Codex CLI, use the [command-line setup](../build/sharepoint-embedded-mcp-server.md#claude-code-and-codex-cli). +Other clients: + +- [Install in Visual Studio Code Insiders](https://aka.ms/spe-mcp/install/learn/vscode-insiders) +- [Install in Visual Studio](https://aka.ms/spe-mcp/install/learn/visual-studio) +- [Install in Cursor](https://aka.ms/spe-mcp/install/learn/cursor) +- [Configure Claude Code](../build/sharepoint-embedded-mcp-server.md#claude-code-and-codex-cli) +- [Configure the Codex CLI](../build/sharepoint-embedded-mcp-server.md#claude-code-and-codex-cli)