Skip to content

Fix: add required 'start' subcommand to SPE MCP server launch examples#10952

Merged
dluces merged 1 commit into
SharePoint:mainfrom
gnjoseph:users/grjoseph/mcp-start-arg-fix
Jul 16, 2026
Merged

Fix: add required 'start' subcommand to SPE MCP server launch examples#10952
dluces merged 1 commit into
SharePoint:mainfrom
gnjoseph:users/grjoseph/mcp-start-arg-fix

Conversation

@gnjoseph

Copy link
Copy Markdown
Contributor

Summary

The Use the MCP server to build apps with a coding agent article shows the SharePoint Embedded MCP server being launched as npx -y @microsoft/spe-mcp without the required start subcommand.

The @microsoft/spe-mcp CLI exposes start / auth / logout subcommands. It only auto-defaults to start when no other arguments are present (process.argv.length <= 2). As soon as a user adds any flag to a start-less config the server prints help and exits with code 1, and the examples diverge from the canonical invocation documented in the package README ("args": ["-y", "@microsoft/spe-mcp", "start"]).

Changes

Adds the start subcommand to all four launch examples in docs/embedded/build/sharepoint-embedded-mcp-server.md:

  • Visual Studio Code (.vscode/mcp.json)
  • Claude Desktop (claude_desktop_config.json)
  • Cursor and other MCP clients (inline npx command)
  • Pre-provisioned-app mode config (with SPE_CLIENT_ID / SPE_TENANT_ID)

No other content changes. 4 insertions, 4 deletions.

The SharePoint Embedded MCP server article's launch examples invoked
'npx -y @microsoft/spe-mcp' without the 'start' subcommand. The CLI only
falls back to 'start' when no other arguments are present, so a config
that omits 'start' breaks as soon as any flag is added, and it diverges
from the canonical invocation documented in the @microsoft/spe-mcp README.

Add 'start' to all four launch examples (VS Code, Claude Desktop, the
Cursor/other-clients note, and the pre-provisioned-app config).

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 ce1f75d:

✅ 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.

@dluces dluces merged commit c87a04b into SharePoint:main Jul 16, 2026
3 checks passed
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