Clarify MCP Gateway only supports containerized stdio and HTTP servers

[Copilot]

The MCP Gateway specification incorrectly implied support for direct command execution (stdio+command without containerization). This creates ambiguity about supported transport mechanisms.

Changes

Specification Updates (W3C style)

• Abstract & Purpose: Explicitly state only containerized stdio and HTTP servers are supported
• Section 3.2 Transport Support: Changed "stdio" to "stdio (containerized)" and added Section 3.2.1 documenting containerization rationale (isolation, reproducibility, versioning, portability)
• Section 4.1.2 Configuration Fields: Removed command and args fields, made container required for stdio servers with explicit note that command field is NOT supported
• Section 6.1 Server Isolation: Removed "Process and Container Isolation", now only "Container Isolation"
• Appendix A Examples: Updated all configurations to use container field instead of command field
• Appendix C Security: Changed "Process Security" to "Container Security" with container-specific recommendations

Example Configuration

Before:

{
  "mcpServers": {
    "example": {
      "command": "node",
      "args": ["server.js"]
    }
  }
}

After:

{
  "mcpServers": {
    "example": {
      "container": "ghcr.io/example/mcp-server:latest",
      "entrypointArgs": ["--verbose"]
    }
  }
}

The specification now uses RFC 2119 keywords (MUST, SHALL NOT) consistently to clarify that direct command execution is explicitly unsupported.

Original prompt

Update the mcp gateway spec in the following way:

• only containerized or http servers are supported. stdio+command servers are not supported as they cannot be containerized.

Remember: you are using a W3C specification style when make edits.

Custom agent used: technical-doc-writer
AI technical documentation writer for GitHub Actions library using Astro Starlight and GitHub Docs voice

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.