From 4384f651d79ec5eceb2240cffceaece42584c899 Mon Sep 17 00:00:00 2001
From: Daniel morris <345234686+danmorris27@users.noreply.github.com>
Date: Sun, 1 Nov 2026 12:16:25 +0200
Subject: [PATCH] docs: make project-scoped MCP config example valid JSON

---
 docs/project-scoped-mcp-servers.md | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/docs/project-scoped-mcp-servers.md b/docs/project-scoped-mcp-servers.md
index 0ec6bfd3..0efb71e0 100644
--- a/docs/project-scoped-mcp-servers.md
+++ b/docs/project-scoped-mcp-servers.md
@@ -8,17 +8,20 @@ committed file serves both tools.
 
 ## The `.mcp.json` format
 
-```jsonc
+The `filesystem` example uses stdio; its `type` field may be omitted.
+For `internal-api`, `sse` and `streamable-http` are aliases for `http`.
+
+```json
 {
   "mcpServers": {
-    "filesystem": {                         // stdio: "type" may be omitted
+    "filesystem": {
       "type": "stdio",
       "command": "npx",
       "args": ["-y", "@modelcontextprotocol/server-filesystem", "."],
       "env": { "NODE_ENV": "production" }
     },
     "internal-api": {
-      "type": "http",                       // "sse" / "streamable-http" alias http
+      "type": "http",
       "url": "https://api.example.com/mcp",
       "headers": { "Authorization": "Bearer ${API_TOKEN}" }
     }