MCP Server Resource Type for durable MCP Servers and Tools#5160
MCP Server Resource Type for durable MCP Servers and Tools#5160sicoyle wants to merge 18 commits into
Conversation
Signed-off-by: Samantha Coyle <sam@diagrid.io>
Signed-off-by: Samantha Coyle <sam@diagrid.io>
Signed-off-by: Samantha Coyle <sam@diagrid.io>
There was a problem hiding this comment.
Pull request overview
Adds documentation for the new MCPServer Dapr resource (Model Context Protocol server integration) including an overview, how-to guide, and a schema/spec reference, and wires it into the MCP docs section and terminology list.
Changes:
- Introduces new MCP docs pages describing
MCPServerbehavior, transports, auth, middleware hooks, and workflow-based tool invocation. - Adds a new
MCPServerspec reference page under resource specs. - Updates MCP landing page and adds
MCPServerto the terminology glossary.
Reviewed changes
Copilot reviewed 5 out of 5 changed files in this pull request and generated 19 comments.
Show a summary per file
| File | Description |
|---|---|
| daprdocs/content/en/reference/resource-specs/mcpserver-schema.md | New MCPServer schema/spec reference page (format + field tables). |
| daprdocs/content/en/developing-ai/mcp/mcp-server-resource.md | New conceptual/overview page explaining MCPServer behavior and patterns. |
| daprdocs/content/en/developing-ai/mcp/howto-use-mcpserver.md | New how-to guide for defining MCPServer resources and calling tools via Workflows. |
| daprdocs/content/en/developing-ai/mcp/_index.md | Updates MCP landing page to point to the new MCPServer docs. |
| daprdocs/content/en/concepts/terminology.md | Adds MCPServer to the docs terminology table. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Signed-off-by: Samantha Coyle <sam@diagrid.io>
Signed-off-by: Samantha Coyle <sam@diagrid.io>
Signed-off-by: Samantha Coyle <sam@diagrid.io>
|
Please don't merge yet! @sicoyle will make a few more updates to this PR. |
There was a problem hiding this comment.
Let's update this page so that it talks about service invocation as though it is the only path. I.e., something like "Dapr supports MCP by using its service invocation API....", and move the comparison discussion under the MCPServer resource page instead.
At the very end of the page, we can add a short section that says something to the tone of: "there is actually another way you can use MCP with Dapr, which is via the MCPServer resource, and you can read all about that + how it relates to the standard, service invocation path here: ".
There was a problem hiding this comment.
Actually, per your comment about the catalog appearing as part of the resource definition, let's leave the level of detail you have here currently on it, unless @yaron2 says otherwise.
Signed-off-by: Samantha Coyle <sam@diagrid.io>
Thank you for helping make the Dapr documentation better!
Please follow this checklist before submitting:
In addition, please fill out the following to help reviewers understand this pull request:
Description
Docs for the new MCPServer resource for this PR dapr/dapr#9731
Issue reference