Skip to content

MCP Server Resource Type for durable MCP Servers and Tools#5160

Open
sicoyle wants to merge 18 commits into
dapr:v1.18from
sicoyle:feat/mcp-crd
Open

MCP Server Resource Type for durable MCP Servers and Tools#5160
sicoyle wants to merge 18 commits into
dapr:v1.18from
sicoyle:feat/mcp-crd

Conversation

@sicoyle
Copy link
Copy Markdown
Contributor

@sicoyle sicoyle commented May 11, 2026

Thank you for helping make the Dapr documentation better!

Please follow this checklist before submitting:

  • Commits are signed with Developer Certificate of Origin (DCO - learn more)
  • Read the contribution guide
  • Commands include options for Linux, MacOS, and Windows within tabpane
  • New file and folder names are globally unique
  • Page references use shortcodes instead of markdown or URL links
  • Images use HTML style and have alternative text
  • Places where multiple code/command options are given have tabpane

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

sicoyle added 3 commits May 7, 2026 19:35
Signed-off-by: Samantha Coyle <sam@diagrid.io>
Signed-off-by: Samantha Coyle <sam@diagrid.io>
Signed-off-by: Samantha Coyle <sam@diagrid.io>
Copilot AI review requested due to automatic review settings May 11, 2026 13:26
@sicoyle sicoyle requested review from a team as code owners May 11, 2026 13:26
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

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 MCPServer behavior, transports, auth, middleware hooks, and workflow-based tool invocation.
  • Adds a new MCPServer spec reference page under resource specs.
  • Updates MCP landing page and adds MCPServer to 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.

Comment thread daprdocs/content/en/reference/resource-specs/mcpserver-schema.md Outdated
Comment thread daprdocs/content/en/reference/resource-specs/mcpserver-schema.md Outdated
Comment thread daprdocs/content/en/reference/resource-specs/mcpserver-schema.md Outdated
Comment thread daprdocs/content/en/reference/resource-specs/mcpserver-schema.md Outdated
Comment thread daprdocs/content/en/reference/resource-specs/mcpserver-schema.md Outdated
Comment thread daprdocs/content/en/developing-ai/mcp/howto-use-mcpserver.md Outdated
Comment thread daprdocs/content/en/developing-ai/mcp/howto-use-mcpserver.md
Comment thread daprdocs/content/en/developing-ai/mcp/howto-use-mcpserver.md
Comment thread daprdocs/content/en/developing-ai/mcp/mcp-server-resource.md Outdated
Comment thread daprdocs/content/en/developing-ai/mcp/mcp-server-resource.md Outdated
@msfussell
Copy link
Copy Markdown
Member

This is in review with @bibryam and @sicoyle

@msfussell msfussell requested review from bibryam and msfussell May 23, 2026 18:05
@msfussell msfussell changed the title Feat/mcp crd MCP Server Resource Type for durable MCP Servers and Tools May 23, 2026
Comment thread daprdocs/content/en/developing-ai/mcp/_index.md Outdated
Comment thread daprdocs/content/en/developing-ai/mcp/mcp-server-resource.md Outdated
Comment thread daprdocs/content/en/developing-ai/mcp/howto-use-mcpserver.md Outdated
Comment thread daprdocs/content/en/developing-ai/mcp/mcp-authentication.md
Comment thread daprdocs/content/en/developing-ai/mcp/mcp-server-resource.md Outdated
Comment thread daprdocs/content/en/developing-ai/mcp/mcp-service-invocation.md Outdated
sicoyle added 2 commits June 1, 2026 14:25
Signed-off-by: Samantha Coyle <sam@diagrid.io>
Copy link
Copy Markdown
Contributor

@marcduiker marcduiker left a comment

Choose a reason for hiding this comment

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

LGTM

@marcduiker
Copy link
Copy Markdown
Contributor

Please don't merge yet! @sicoyle will make a few more updates to this PR.

@marcduiker marcduiker added this to the v1.18 milestone Jun 1, 2026
Comment thread daprdocs/content/en/developing-ai/mcp/mcp-server-resource.md
Comment thread daprdocs/content/en/developing-ai/mcp/mcp-server-resource.md
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

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: ".

Comment thread daprdocs/content/en/developing-ai/mcp/howto-use-mcpserver.md Outdated
Comment thread daprdocs/content/en/developing-ai/mcp/howto-use-mcpserver.md Outdated
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

remove all catalog refs

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

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.

Comment thread daprdocs/content/en/developing-ai/mcp/mcp-access-control.md Outdated
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.

5 participants