Skip to content

Expand SharePoint Embedded MCP server article: available tools, configuration, and SPA auth guidance - #10950

Open
Gregory Joseph (gnjoseph) wants to merge 3 commits into
SharePoint:mainfrom
gnjoseph:users/grjoseph/spe-mcp-docs-followup
Open

Expand SharePoint Embedded MCP server article: available tools, configuration, and SPA auth guidance#10950
Gregory Joseph (gnjoseph) wants to merge 3 commits into
SharePoint:mainfrom
gnjoseph:users/grjoseph/spe-mcp-docs-followup

Conversation

@gnjoseph

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

Copy link
Copy Markdown
Contributor

Summary

Expands the current SharePoint Embedded MCP server article at
docs/embedded/build/sharepoint-embedded-mcp-server.md.

This follow-up preserves the reorganized documentation structure and later
editorial fixes from main.

What changed

  1. Available tools — Replaces the long bullet list with a scannable table
    grouped by provisioning, billing, app development, opt-in content operations,
    container lifecycle, and documentation.
  2. Operational configuration — Documents the user-facing CLI flags and
    environment variables for app identity, tenant, read-only mode, tool profiles,
    and per-instance data directories.
  3. Pre-provisioned app guidance — Distinguishes redirect URI setup for:
    • the MCP server's interactive public-client sign-in;
    • the React single-page application scaffold; and
    • the separately provisioned C# web application.

Conflict resolution

  • Merged the latest main without rebasing or force-pushing.
  • Kept the deleted docs/embedded/getting-started/ path deleted.
  • Ported the intended changes to the current docs/embedded/build/ article.
  • Preserved current front matter, including ms.date: 07/10/2026.
  • Rewrote stale links to current Learn paths.
  • Left client installation UX to companion PR Add attributed MCP install buttons across SharePoint Embedded articles #10953 to avoid overlapping edits.

Validation

  • Internal SPE documentation style, accuracy, and implementation review: no findings.
  • Final branch review: no issues.
  • Relative article links resolve.
  • PR diff is limited to the current MCP article.
  • The old article path remains deleted.
  • Learn Build passed.
  • PoliCheck found no issues.
  • Rendered preview verified in external Microsoft Edge.

…A auth guidance

Incorporates PM review feedback on the merged getting-started article (PR SharePoint#10940):

- Add an Available tools table grouped by task with representative tool names.

- Add a Configuration section documenting CLI flags and environment variables.

- Add brief per-client descriptions for VS Code and Claude Desktop.

- Add an IMPORTANT callout that bring-your-own app registrations must register the React sample origin as a Single-page application (SPA) redirect URI (http://localhost:5173 + deployed origin) to avoid AADSTS9002326, plus the public-client http://localhost redirect.
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 00ea84d:

✅ Validation status: passed

File Status Preview URL Details
docs/embedded/getting-started/sharepoint-embedded-mcp-server.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.

Remove the hardcoded sample-app port (http://localhost:5173), the http://localhost public-client redirect, the AADSTS9002326 error code, and the 'Allow public client flows' step from the pre-provisioned-app IMPORTANT callout. State the requirement conceptually (register the app's sign-in URL as a Single-page application redirect URI in Authentication to acquire a token) and defer the exact redirect URIs to the server README, so the Learn doc doesn't need edits when implementation details like the sample app port change.
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 697703b:

✅ Validation status: passed

File Status Preview URL Details
docs/embedded/getting-started/sharepoint-embedded-mcp-server.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.

@andrewconnell Andrew Connell (andrewconnell) added Needs: Author Feedback Awaiting response from the original poster of the issue. Marked as stale if no activity for 7 days. pr:do-not-merge Pull request not ready to be merged labels Jul 15, 2026

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Please fix merge conflicts before updating we can review the doc.

Also, do not update the ms.date. This is set for the doc creeation time & then let the rendering engine use the file's git history to render the last updated date.

@andrewconnell

Copy link
Copy Markdown
Collaborator

Gregory Joseph (@gnjoseph) bump... do you still want to make this change? waiting for you to address the edit issue & merge conflict before we can review & merge this

@andrewconnell

Copy link
Copy Markdown
Collaborator

Bump Gregory Joseph (@gnjoseph) - awaiting your feedback/fix for the merge conflict issues. Can't review until those are addressed. Will wait another week until this PR is closed due to no activity for a month.

FYI Diego Luces (@dluces) Cindy Lay (@cindylay) for visibility as I'm not sure Gregory Joseph (@gnjoseph) is aware of @mentions here from previous PRs...

Resolve the article move by preserving the current build-path article and metadata, then port the reviewed tools, operational configuration, and app-registration redirect guidance.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@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 f4445af:

✅ Validation status: passed

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

For more details, please refer to the build report.

@gnjoseph

Copy link
Copy Markdown
Contributor Author

Andrew Connell (@andrewconnell) Thanks for the reminders. This is ready for re-review.

  • Merged latest main without rebasing or force-pushing.
  • Resolved the article move by keeping the old getting-started path deleted and porting the intended changes to docs/embedded/build/sharepoint-embedded-mcp-server.md.
  • Preserved current main metadata, including ms.date: 07/10/2026.
  • Revalidated the changes against the public MCP server implementation.
  • Internal SPE style, accuracy, and code review now returns no findings.
  • GitHub reports the PR as mergeable.
  • Learn Build passed, and PoliCheck found no issues.
  • Verified the rendered preview in external Microsoft Edge.

I also kept client/install UX out of this change so companion PR #10953 remains the owner of that surface.

@dluces Diego Luces (dluces) removed the Needs: Author Feedback Awaiting response from the original poster of the issue. Marked as stale if no activity for 7 days. label Aug 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

pr:do-not-merge Pull request not ready to be merged

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants