Fix broken docs links and MCP plugin docs

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot-Session: 4215785a-7e6e-49c5-abaa-c39b0793a11e

README.md

@@ -6,7 +6,7 @@ A community-created collection of custom agents, instructions, skills, hooks, wo
 > [!TIP]
 > **Explore the full collection on the website →** [awesome-copilot.github.com](https://awesome-copilot.github.com)
 >
-> The website offers full-text search and filtering across hundreds of resources, plus the [Tools](https://awesome-copilot.github.com/tools) section for MCP servers and developer tooling, and the [Learning Hub](https://awesome-copilot.github.com/learning-hub) for guides and tutorials.
+> The website offers full-text search and filtering across hundreds of resources, plus the [Learning Hub](https://awesome-copilot.github.com/learning-hub) for guides and tutorials.
 >
 > **Using this collection in an AI agent?** A machine-readable [`llms.txt`](https://awesome-copilot.github.com/llms.txt) is available with structured listings of all agents, instructions, and skills.
 

eng/generate-website-data.mjs

@@ -618,8 +618,11 @@ function generatePluginsData(gitDates, resourceIndex = {}) {
       const mcpItems = [];
       if (data.mcpServers) {
         let mcpServersObj = null;
+        let mcpConfigPath = relPath;
         if (typeof data.mcpServers === "string") {
-          const mcpJsonPath = path.join(pluginDir, data.mcpServers.replace(/^\.\//, ""));
+          const manifestMcpPath = data.mcpServers.replace(/^\.\//, "");
+          mcpConfigPath = manifestMcpPath ? `${relPath}/${manifestMcpPath}` : relPath;
+          const mcpJsonPath = path.join(pluginDir, manifestMcpPath);
           if (fs.existsSync(mcpJsonPath)) {
             try {
               const mcpJson = JSON.parse(fs.readFileSync(mcpJsonPath, "utf-8"));
@@ -633,7 +636,7 @@ function generatePluginsData(gitDates, resourceIndex = {}) {
         }
         if (mcpServersObj) {
           for (const serverName of Object.keys(mcpServersObj)) {
-            mcpItems.push({ kind: "mcp", path: serverName, title: serverName });
+            mcpItems.push({ kind: "mcp", path: mcpConfigPath, title: serverName });
           }
         }
       }

plugins/awesome-copilot/README.md

@@ -9,6 +9,11 @@ Meta prompts that help you discover and generate curated GitHub Copilot agents,
 copilot plugin install awesome-copilot@awesome-copilot
 ```
 
+## Prerequisites
+
+- [Docker](https://www.docker.com/) must be installed and available on your `PATH`.
+- The plugin starts its bundled MCP server by running `docker run ... ghcr.io/microsoft/mcp-dotnet-samples/awesome-copilot:latest`.
+
 ## What's Included
 
 ### Commands (Slash Commands)
@@ -26,6 +31,10 @@ copilot plugin install awesome-copilot@awesome-copilot
 |-------|-------------|
 | `meta-agentic-project-scaffold` | Meta agentic project creation assistant to help users create and manage project workflows effectively. |
 
+### MCP server
+
+This plugin includes the `awesome-copilot` MCP server configured in [`./.mcp.json`](./.mcp.json). If Docker is unavailable, MCP startup will fail.
+
 ## Source
 
 This plugin is part of [Awesome Copilot](https://github.com/github/awesome-copilot), a community-driven collection of GitHub Copilot extensions.

website/src/content/docs/learning-hub/agentic-workflows.md

@@ -77,7 +77,7 @@ Agentic Workflows are ideal when you need **autonomous, event-driven automation*
 
 ## Using Workflows from Awesome Copilot
 
-The [Awesome Copilot workflows page](../../workflows/) hosts a growing collection of community-contributed workflows. Here's how to install and use them.
+The [repository workflows directory](https://github.com/github/awesome-copilot/tree/main/workflows) hosts a growing collection of community-contributed workflows. Here's how to install and use them.
 
 ### Prerequisites
 
@@ -89,7 +89,7 @@ gh extension install github/gh-aw
 
 ### Installing a Workflow
 
-1. **Browse** the [workflows collection](../../workflows/) and find one that fits your needs
+1. **Browse** the [workflows collection](https://github.com/github/awesome-copilot/tree/main/workflows) and find one that fits your needs
 2. **Copy** the workflow `.md` file into your repository's `.github/workflows/` directory
 3. **Compile** the workflow to generate the Actions lock file:
 

website/src/content/docs/learning-hub/using-copilot-coding-agent.md

@@ -327,7 +327,7 @@ This repository provides a curated collection of agents, skills, and hooks desig
 
 ### Adding Hooks from This Repo
 
-1. Browse the [Hooks Directory](../../hooks/) for automation hooks
+1. Browse the [Hooks documentation](https://github.com/github/awesome-copilot/blob/main/docs/README.hooks.md) for automation hooks
 2. Copy the `hooks.json` content into a file in `.github/hooks/` in your repository
 3. Copy any referenced scripts alongside it
 4. The hooks will run automatically during coding agent sessions