microsoft-foundry / microsoft-foundry/foundry-samples

Document private MCP hosting support for App Service Private Endpoints versus internal Container Apps

Open
#956 0 comments 0 reactions 0 assignees View on GitHub

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:

https://github.com/doruit/foundry-private-mcp-probe

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.