Skip to content

Add attributed MCP install buttons across SharePoint Embedded articles - #10953

Draft
Gregory Joseph (gnjoseph) wants to merge 4 commits into
SharePoint:mainfrom
gnjoseph:users/grjoseph/mcp-docs-devtools-buttons
Draft

Add attributed MCP install buttons across SharePoint Embedded articles#10953
Gregory Joseph (gnjoseph) wants to merge 4 commits into
SharePoint:mainfrom
gnjoseph:users/grjoseph/mcp-docs-devtools-buttons

Conversation

@gnjoseph

@gnjoseph Gregory Joseph (gnjoseph) commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds reusable docs-to-devtools install buttons for the SharePoint Embedded MCP server and expands them across high-intent SharePoint Embedded build articles.

Every install path launches @microsoft/spe-mcp with bounded attribution arguments:

--install-source microsoft-learn --install-campaign docs-install-buttons

The MCP client stores these arguments in its server configuration and supplies them on each launch. The server adds the bounded, non-personal labels to existing Graph/ARM request metadata; it does not open a separate telemetry channel.

Articles

  • Use the MCP server to build apps with a coding agent
  • Quickstart: Build your first app with VS Code
  • Create and configure a container type
  • Create and manage containers

Existing ms.date values are intentionally unchanged.

Install targets

  • Visual Studio Code
  • Visual Studio Code Insiders
  • Visual Studio
  • Cursor
  • Claude Code
  • Codex CLI

The presentation is a reusable include so it can be improved once and updated everywhere.

Validation

  • VS Code and VS Code Insiders wrappers return HTTP 302 to their expected MCP install schemes with the attributed payload intact.
  • Visual Studio resolves through aka.ms and vs-open.link to vsweb+mcp:/install, preserving the payload.
  • Cursor returns HTTP 200 and its base64 config decodes to the expected command and args.
  • Installed Claude Code CLI help confirms the documented mcp add <name> -- <command> [args...] form.
  • Official Codex MCP documentation confirms the documented codex mcp add <server-name> -- <stdio server-command> form.
  • Microsoft Learn build passed and PoliCheck found no issues.

Dependencies and release gates

Companion OSS draft: microsoft/SharePoint-Embedded-MCP-Server#86

SPO.Core ingestion task: https://dev.azure.com/onedrive/SPIN/_workitems/edit/3198658

This Learn change should merge only after:

  • the companion CLI flags are merged and available in the published npm package;
  • privacy/CELA approval is obtained for the install-attribution disclosure; and
  • the service/data contract for ingesting the bounded request metadata is confirmed.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

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>
@gnjoseph
Gregory Joseph (gnjoseph) force-pushed the users/grjoseph/mcp-docs-devtools-buttons branch from 7eb3d37 to eafc4a5 Compare July 15, 2026 19:14
@gnjoseph Gregory Joseph (gnjoseph) changed the title Add docs-to-devtools MCP install/action buttons to SharePoint Embedded docs Add MCP install buttons to the SharePoint Embedded MCP server article Jul 15, 2026
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit eafc4a5:

✅ Validation status: passed

File Status Preview URL Details
docs/embedded/build/sharepoint-embedded-mcp-server.md ✅Succeeded View
docs/embedded/includes/mcp-install-buttons.md ✅Succeeded View

For more details, please refer to the build report.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

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)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we add the buttons for the other editors?

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>
@gnjoseph Gregory Joseph (gnjoseph) changed the title Add MCP install buttons to the SharePoint Embedded MCP server article Add attributed MCP install buttons across SharePoint Embedded articles Aug 10, 2026
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 5dfce54:

✅ Validation status: passed

File Status Preview URL Details
docs/embedded/build/create-container-type.md ✅Succeeded View
docs/embedded/build/create-manage-containers.md ✅Succeeded View
docs/embedded/build/quickstart-vscode.md ✅Succeeded View
docs/embedded/build/sharepoint-embedded-mcp-server.md ✅Succeeded View
docs/embedded/includes/mcp-install-buttons.md ✅Succeeded View

For more details, please refer to the build report.

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

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

“Thou shall not update ms.date”

Keep ms.date unchanged while adding the reusable MCP install include.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@gnjoseph

Copy link
Copy Markdown
Contributor Author

Addressed the review follow-ups:

  • Restored every existing ms.date value in commit 446e83d; this PR no longer changes article dates.
  • Kept the current reusable include presentation as the initial version so its appearance can be improved once in one place later.
  • Exercised and decoded every editor payload:
    • VS Code: HTTP 302 to vscode:mcp/install with the expected attributed npx args.
    • VS Code Insiders: HTTP 302 to vscode-insiders:mcp/install with the same args.
    • Visual Studio: aka.ms 301 → vs-open.link 302 → vsweb+mcp:/install, preserving the payload.
    • Cursor: HTTP 200; its base64 config decodes to the expected command/args.
    • Claude Code: installed CLI help confirms mcp add <name> -- <command> [args...], matching this command.
    • Codex: the official MCP documentation confirms codex mcp add <server-name> -- <stdio server-command>.

All decoded configurations contain --install-source microsoft-learn --install-campaign docs-install-buttons.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 446e83d:

✅ Validation status: passed

File Status Preview URL Details
docs/embedded/build/create-container-type.md ✅Succeeded View
docs/embedded/build/create-manage-containers.md ✅Succeeded View
docs/embedded/build/quickstart-vscode.md ✅Succeeded View
docs/embedded/build/sharepoint-embedded-mcp-server.md ✅Succeeded View
docs/embedded/includes/mcp-install-buttons.md ✅Succeeded View

For more details, please refer to the build report.

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>
@gnjoseph

Copy link
Copy Markdown
Contributor Author

Internal odsp-microsoft/spe-dev-docs-ai review summary:

  • Cloned the repository to Q:\src\spe-dev-docs-ai and installed spe-doc-updater@spe-dev-docs-ai.
  • Verified spe-doc-updater, doc-review, and sharepoint-reader.
  • Ran /doc-review across all five PR files using the style, accuracy, and code reviewers. Most findings were pre-existing or outside the PR diff.
  • Fixed the PR-specific editorial finding in commit 41e7a9c by expanding Model Context Protocol on first use and using direct active voice.
  • Left the original ms.date values unchanged.
  • Re-decoded all editor payloads; all passed.
  • The reviewers correctly flagged that attribution flags are not present in the currently published npm version. This remains an explicit merge-order gate on OSS PR Staging #86 and the subsequent package publish.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 41e7a9c:

✅ Validation status: passed

File Status Preview URL Details
docs/embedded/build/create-container-type.md ✅Succeeded View
docs/embedded/build/create-manage-containers.md ✅Succeeded View
docs/embedded/build/quickstart-vscode.md ✅Succeeded View
docs/embedded/build/sharepoint-embedded-mcp-server.md ✅Succeeded View
docs/embedded/includes/mcp-install-buttons.md ✅Succeeded View

For more details, please refer to the build report.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants