microsoft-foundry / microsoft-foundry/foundry-samples
Template 19: add a private MCP evidence checklist and clarify internal ACA ingress
Nobody has claimed this yet.
- Dominant language
- Bicep
- Stars
- 445
- Forks
- 494
- Avg merge
- 11h 35m
- Merged PRs (30d)
- 38
Description
Problem
Template 19 documents the individual deployment and test steps, but users troubleshooting private MCP connectivity still need to infer which screenshots and runtime signals together prove the intended private path.
The sample also uses az containerapp create --ingress external inside an internal Container Apps environment. Without an explicit note, external is easy to misread as internet-facing even though the environment boundary remains internal.
Suggested improvement
Add a short "private MCP evidence checklist" to the Template 19 README and testing guide:
- Foundry configuration: Standard Agent service network injection, delegated agent subnet, and customer-managed/BYO VNet.
- MCP hosting: Container Apps public network access disabled, VNet subnet configured, and virtual IP internal.
- Runtime: private DNS answer plus successful
initialize,tools/list,tools/call, and Foundry response itemsmcp_list_toolsandmcp_call.
Please also clarify that app-level --ingress external is external to the app within the Container Apps environment boundary; it does not create an internet-reachable endpoint when the environment is internal and public network access is disabled.
Reproduction evidence
I validated the current Template 19 pattern in a clean environment with an internal-only Container Apps MCP server. Private DNS, direct VNet MCP calls, and Foundry agent tool enumeration/invocation all passed.
A sanitized reusable probe and evidence checklist are available here:
https://github.com/doruit/foundry-private-mcp-probe
No private resource identifiers or request/response IDs are included.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the Template 19 README and testing guide, then compare their deployment and test steps with the reported internal-only Container Apps evidence. Done means both documents contain the private MCP evidence checklist and clearly explain that app-level external ingress remains inside an internal environment without public network access.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- azure
- Domain
- cloud, documentation
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-2 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 75/100