docs(cli): add mcpservers reference and refresh the command list#5261
Open
ihopenre-eng wants to merge 2 commits into
Open
docs(cli): add mcpservers reference and refresh the command list#5261ihopenre-eng wants to merge 2 commits into
ihopenre-eng wants to merge 2 commits into
Conversation
`dapr mcpservers` ships in CLI v1.18.0 but has no page under the CLI reference, and the overview's pasted `dapr --help` output predates it. `scheduler` and `workflow` have pages that the overview never links to either. Add the mcpservers page in the shape the other command pages use, with the flags, defaults and examples taken from `dapr mcpservers --help` on v1.18.0, and bring the overview back in sync with that release: the three missing commands, the `--runtime-path` global flag, the `dapr [flags]` usage line, and the reworded `upgrade` description. Signed-off-by: ihopenre-eng <247072151+ihopenre-eng@users.noreply.github.com>
Author
|
The CI workflows on this PR are queued at Could a maintainer approve the workflow runs when convenient? Happy to rebase if anything has drifted in the meantime. |
cicoyle
approved these changes
Jul 23, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
dapr mcpserversships in CLI v1.18.0, but the CLI reference has no page for it, while every other command has one. The overview page's pasteddapr --helpoutput also predates several v1.18 changes, andschedulerandworkflowhave pages that the overview never links to.Verified against a
daprbinary built from the v1.18.0 tag of dapr/cli:This PR:
dapr-mcpservers.md, following the layout of the other command pages. Flags, defaults and examples come fromdapr mcpservers --helpon v1.18.0, with the defaults cross-checked against the flag registrations incmd/mcpservers.go.cli-overview.md: themcpservers,schedulerandworkflowentries, the--runtime-pathglobal flag, thedapr [flags]usage line, and the rewordedupgradedescription.mcpservers,schedulerandworkflowfrom the command reference list.The new page links to the existing [MCPServer spec]({{% ref mcpserver-schema.md %}}) and [MCP how-to]({{% ref howto-use-mcpserver.md %}}) pages; both
reftargets resolve to a single file.Issue reference
N/A, documentation gap found by diffing the CLI reference against
dapr --helpon v1.18.0.Checklist