Skip to content

Add Azure DocumentDB control-plane MCP proposal - #102

Open
udsmicrosoft wants to merge 3 commits into
microsoft:mainfrom
udsmicrosoft:docs/documentdb-control-plane-mcp-proposal
Open

Add Azure DocumentDB control-plane MCP proposal#102
udsmicrosoft wants to merge 3 commits into
microsoft:mainfrom
udsmicrosoft:docs/documentdb-control-plane-mcp-proposal

Conversation

@udsmicrosoft

@udsmicrosoft udsmicrosoft commented Aug 28, 2026

Copy link
Copy Markdown

Summary

  • Proposes Azure MCP as the primary user entry point for the complete Azure DocumentDB control-plane capability.
  • Uses native Azure MCP commands by default for stateless ARM reads and mutations, with a DocumentDB-owned orchestration component only when durable state or independently constrained execution is required.
  • Defines identity, risk tiers, mutation safety, secret handling, long-running operations, durable workflows, delivery phases, and acceptance criteria.
  • Records what the read-only list/get POC demonstrated and which mutation and production questions remain unresolved.

Copilot-Session: f35a45d0-bef6-4341-91c5-7327b9667f06
Comment thread docs/azure-mcp-documentdb-control-plane-proposal.md Outdated
Comment thread docs/azure-mcp-documentdb-control-plane-proposal.md Outdated
Comment thread docs/azure-mcp-documentdb-control-plane-proposal.md Outdated

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Summary

The architecture direction is understandable, but the proposal often states it in implementation shorthand rather than decision-oriented language. These non-blocking edits clarify committed versus conditional scope, potentially misleading undo/redo terminology, undefined acronyms, and the full-feature exit criteria. Together with the concrete replacement text in the existing threads, they should make the proposal easier for product, security, and engineering approvers to evaluate consistently.

Comment thread docs/azure-mcp-documentdb-control-plane-proposal.md
Comment thread docs/azure-mcp-documentdb-control-plane-proposal.md Outdated
Comment thread docs/azure-mcp-documentdb-control-plane-proposal.md Outdated
Comment thread docs/azure-mcp-documentdb-control-plane-proposal.md Outdated
Copilot-Session: f35a45d0-bef6-4341-91c5-7327b9667f06

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Summary

The update addresses the earlier clarity feedback well: it now separates target from validated scope, explains the native versus orchestrated paths with examples, makes the Azure CLI POC-only, adds a glossary, and turns acceptance into a checklist. I found four remaining non-blocking consistency issues where wording or examples conflict with definitions elsewhere in the proposal.

Comment thread docs/azure-mcp-documentdb-control-plane-proposal.md Outdated
Comment thread docs/azure-mcp-documentdb-control-plane-proposal.md Outdated
Comment thread docs/azure-mcp-documentdb-control-plane-proposal.md Outdated
Comment thread docs/azure-mcp-documentdb-control-plane-proposal.md Outdated
Comment thread docs/azure-mcp-documentdb-control-plane-proposal.md Outdated
Comment thread docs/azure-mcp-documentdb-control-plane-proposal.md
Comment thread docs/azure-mcp-documentdb-control-plane-proposal.md Outdated
Comment thread docs/azure-mcp-documentdb-control-plane-proposal.md
Copilot-Session: f35a45d0-bef6-4341-91c5-7327b9667f06
@udsmicrosoft
udsmicrosoft marked this pull request as ready for review August 31, 2026 15:52
`microsoft/mcp` is the Azure MCP Server source and contribution repository.
`mcp/com.microsoft/azure` is its GitHub MCP Registry publication and discovery
page, which links to the source repository and released installation options.
DocumentDB tool code is developed in `microsoft/mcp`, not in the registry

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

There may be one step missing from the proposal. The question is: can we put all work in microsoft/mcp alone and deploy it from there? We need an end-to-end proposal before diving into feature details

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.

3 participants