MCP Developer Guide (#8499)

* First draft

* Update ToC and sitemap

* Fix link to MCP for beginners

* Update docs/copilot/guides/mcp-developer-guide.md

Co-authored-by: Connor Peet <[email protected]>

* Update docs/copilot/guides/mcp-developer-guide.md

Co-authored-by: Connor Peet <[email protected]>

* Fix URL handler

* Finalize content

* Edit pass

* Update docs/copilot/guides/mcp-developer-guide.md

Co-authored-by: Connor Peet <[email protected]>

* Update docs/copilot/guides/mcp-developer-guide.md

Co-authored-by: Connor Peet <[email protected]>

* Update docs/copilot/guides/mcp-developer-guide.md

Co-authored-by: Connor Peet <[email protected]>

* Update docs/copilot/guides/mcp-developer-guide.md

Co-authored-by: Connor Peet <[email protected]>

* Update docs/copilot/guides/mcp-developer-guide.md

Co-authored-by: Connor Peet <[email protected]>

* Update after review

* Update docs/copilot/guides/mcp-developer-guide.md

Co-authored-by: Harald Kirschner <[email protected]>

* Update docs/copilot/guides/mcp-developer-guide.md

Co-authored-by: Harald Kirschner <[email protected]>

* Update docs/copilot/guides/mcp-developer-guide.md

Co-authored-by: Harald Kirschner <[email protected]>

* Update docs/copilot/guides/mcp-developer-guide.md

Co-authored-by: Harald Kirschner <[email protected]>

* Update docs/copilot/guides/mcp-developer-guide.md

Co-authored-by: Harald Kirschner <[email protected]>

* Fix typo

* Update docs/copilot/guides/mcp-developer-guide.md

Co-authored-by: Tyler James Leonhardt <[email protected]>

* Update auth section after review

---------

Co-authored-by: Connor Peet <[email protected]>
Co-authored-by: Harald Kirschner <[email protected]>
Co-authored-by: Tyler James Leonhardt <[email protected]>

Author: 4 people

build/sitemap.xml

@@ -440,6 +440,11 @@
         <changefreq>weekly</changefreq>
         <priority>0.8</priority>
     </url>
+    <url>
+        <loc>https://code.visualstudio.com/docs/copilot/guides/mcp-developer-guide</loc>
+        <changefreq>weekly</changefreq>
+        <priority>0.8</priority>
+    </url>
     <url>
         <loc>https://code.visualstudio.com/docs/copilot/reference/copilot-vscode-features</loc>
         <changefreq>weekly</changefreq>

docs/copilot/chat/mcp-servers.md

@@ -359,7 +359,7 @@ VS Code also includes a URL handler that you can use to install an MCP server. T
 
 ```typescript
 // For Insiders, use `vscode-insiders` instead of `code`
-const link = `vscode:mcp/install?${encodeURIComponent(JSON.stringify(obj))`;
+const link = `vscode:mcp/install?${encodeURIComponent(JSON.stringify(obj))}`;
 ```
 
 This link can be used in a browser, or opened on the command line, for example via `xdg-open $LINK` on Linux.
@@ -398,16 +398,6 @@ You can enable _development mode_ for MCP servers by adding a `dev` key to the M
 > [!NOTE]
 > We currently only support debugging Node.js and Python servers launched with `node` and `python` respectively.
 
-## Create an MCP server
-
-VS Code has all the tools you need to develop your own MCP server. While MCP servers can be written in any language that can handle `stdout`, the MCP's official SDKs are a good place to start:
-
-* [TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk)
-* [Python SDK](https://github.com/modelcontextprotocol/python-sdk)
-* [Java SDK](https://github.com/modelcontextprotocol/java-sdk)
-* [Kotlin SDK](https://github.com/modelcontextprotocol/kotlin-sdk)
-* [C# SDK](https://github.com/modelcontextprotocol/csharp-sdk)
-
 ## Frequently asked questions
 
 ### Can I control which MCP tools are used?

docs/copilot/guides/images/mcp-developer-guide/manage-trusted-mcp.png

@@ -149,9 +149,10 @@
         "area": "copilot/guides",
         "noCollapse": true,
         "topics": [
-          ["Edit notebooks with AI", "/docs/copilot/guides/notebooks-with-ai"],
+          ["Edit Notebooks with AI", "/docs/copilot/guides/notebooks-with-ai"],
           ["Test with AI", "/docs/copilot/guides/test-with-copilot"],
-          ["Debug with AI", "/docs/copilot/guides/debug-with-copilot"]
+          ["Debug with AI", "/docs/copilot/guides/debug-with-copilot"],
+          ["MCP Dev Guide", "/docs/copilot/guides/mcp-developer-guide"]
         ]
       }
       ],