Skip to content

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

Merged
yaron2 merged 19 commits into
dapr:v1.18from
sicoyle:feat/mcp-crd
Jun 3, 2026
Merged

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

Conversation

@sicoyle

@sicoyle sicoyle commented May 11, 2026

Copy link
Copy Markdown
Contributor

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

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

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>

@marcduiker marcduiker left a comment

Copy link
Copy Markdown
Contributor

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
Comment thread daprdocs/content/en/developing-ai/mcp/_index.md
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
Comment thread daprdocs/content/en/developing-ai/mcp/_index.md Outdated
Comment thread daprdocs/content/en/developing-ai/mcp/mcp-access-control.md Outdated
Signed-off-by: Samantha Coyle <sam@diagrid.io>
@yaron2
yaron2 merged commit 6769c6e into dapr:v1.18 Jun 3, 2026
4 checks passed
@sicoyle
sicoyle deleted the feat/mcp-crd branch June 3, 2026 20:48
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.

6 participants