microsoft-foundry / microsoft-foundry/foundry-samples
Document private MCP hosting support for App Service Private Endpoints versus internal Container Apps
Nobody has claimed this yet.
- Dominant language
- Bicep
- Stars
- 445
- Forks
- 494
- Avg merge
- 11h 35m
- Merged PRs (30d)
- 38
Description
Problem
The Template 19 testing guide explains Azure Functions/App Service networking scenarios, but users evaluating a private MCP server hosted on App Service still need a concise support matrix for Foundry Data Proxy reachability.
The key distinction is easy to miss:
- Container Apps in an internal environment can be reached over the injected VNet path.
- App Service/Functions VNet Integration controls outbound traffic.
- An App Service Private Endpoint controls inbound traffic and may not be equivalent to an internal Container Apps endpoint for Foundry-hosted tool calls.
This ambiguity leads users to assume that "VNet integrated" or "has a Private Endpoint" automatically means a private MCP endpoint is supported by Foundry Agent Service.
Suggested improvement
Add an explicit hosting/support matrix for private MCP and OpenAPI tools covering at least:
| Hosting pattern | Inbound endpoint | Expected Foundry Data Proxy support | Evidence/test |
|---|---|---|---|
| Internal Azure Container Apps environment | Private/internal FQDN | Supported reference pattern | Private DNS + agent MCP call |
| App Service with VNet Integration only | Public inbound | Clarify that VNet Integration is outbound only | Agent call + private backend access |
| App Service with Private Endpoint and public access disabled | Private inbound | State current support/limitations | DNS, HTTP status, agent trace |
Please include the recommended pattern for customers whose existing MCP server is on App Service with a Private Endpoint, and state whether Container Apps is currently the preferred private hosting target.
Context
A clean Template 19 deployment with internal Azure Container Apps passed private DNS, direct MCP, and Foundry agent enumeration/invocation. A sanitized probe is available at:
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 testing guide and the sanitized probe at https://github.com/doruit/foundry-private-mcp-probe. Verify the three hosting patterns, including private DNS, agent MCP calls, HTTP status, and agent traces, then document the support matrix, current limitations, recommended App Service guidance, and whether internal Container Apps is preferred.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- azure
- Domain
- cloud, documentation
- Issue type
- Documentation
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 68/100