Merge branch '001-spoke-home-assistant-integration' into main: enable MCP workspace configuration

Author: subsubl

.gitignore

@@ -7,8 +7,11 @@ obj/
 *.suo
 *.cache
 
-# IDE files
 .vscode/
+# Allow tracking a specific VS Code workspace file(s) used for sharing MCP server configuration
+!.vscode/mcp.json
+!.vscode/extensions.json
+!.vscode/README.md
 .idea/
 
 # OS files
@@ -24,12 +27,12 @@ Thumbs.db
 .fake
 
 # .NET SDK
-
+.vscode/*
 # Node / JavaScript
 node_modules/
-dist/
-build/
-
+!.vscode/mcp.json
+!.vscode/extensions.json
+!.vscode/README.md
 # Environment files
 .env
 .env.*

.vscode/README.md

@@ -0,0 +1,25 @@
+# MCP (Model Context Protocol) configuration for this workspace
+
+This workspace includes an `mcp.json` (which configures MCP servers for GitHub Copilot and Microsoft Learn documentation) and recommends a few extensions to enable MCP features in VS Code.
+
+## Recommended setup
+
+1. Install the recommended extensions (copilot, copilot-labs, C#):
+   - `github.copilot`
+   - `github.copilot-labs`
+   - `ms-dotnettools.csharp`
+
+2. Sign into GitHub Copilot and (optionally) Copilot Labs in VS Code.
+
+3. When prompted by the MCP client or the Copilot extension, provide a GitHub PAT or App token. This repository has an `mcp.json` that defines an input named `Authorization` that the extension will ask for.
+
+4. After installing extensions and signing in, open `Command Palette (Ctrl+Shift+P)` and look for MCP or Copilot commands to connect to the ``io.github.github/github-mcp-server`` server and the ``microsoftdocs/mcp`` server.
+
+## Privacy & security
+
+- Do not commit secrets (PATs, tokens or credentials). The `mcp.json` file expects the token to be provided via the editor prompt and does not store it in the repository.
+
+## Troubleshooting
+
+- If you don't see the MCP options in Copilot, update Copilot and Copilot Labs to the latest version.
+- Ensure your GitHub token has appropriate scopes (usually `repo`, `read:org`, or other scopes Copilot/extension documents require).

.vscode/extensions.json

@@ -0,0 +1,7 @@
+{
+  "recommendations": [
+    "github.copilot",
+    "github.copilot-labs",
+    "ms-dotnettools.csharp"
+  ]
+}

.vscode/mcp.json

@@ -0,0 +1,27 @@
+{
+	"servers": {
+		"io.github.github/github-mcp-server": {
+			"type": "http",
+			"url": "https://api.githubcopilot.com/mcp/",
+			"headers": {
+				"Authorization": "${input:Authorization}"
+			},
+			"gallery": "https://api.mcp.github.com",
+			"version": "0.23.0"
+		},
+		"microsoftdocs/mcp": {
+			"type": "http",
+			"url": "https://learn.microsoft.com/api/mcp",
+			"gallery": "https://api.mcp.github.com",
+			"version": "1.0.0"
+		}
+	},
+	"inputs": [
+		{
+			"id": "Authorization",
+			"type": "promptString",
+			"description": "Authentication token (PAT or App token)",
+			"password": true
+		}
+	]
+}