Repo sync

config/moda/secrets/production/secrets.yml

@@ -1,8 +1,66 @@
----
 secrets:
   COOKIE_SECRET:
     kind: latest_at_deployment_start
-    key: COOKIE_SECRET
     type: salt
     owner: '@github/docs-engineering'
     externally_usable: true
+  CSE_COPILOT_ENDPOINT:
+    kind: latest_at_deployment_start
+    type: salt
+    owner: '@github/docs-engineering'
+    externally_usable: true
+  CSE_COPILOT_SECRET:
+    kind: latest_at_deployment_start
+    type: salt
+    owner: '@github/docs-engineering'
+    externally_usable: true
+  DOCS_BOT_PAT_BASE:
+    kind: latest_at_deployment_start
+    type: github_pat
+    owner: '@github/docs-engineering'
+    externally_usable: true
+  DOCS_BOT_PAT_COPILOT:
+    kind: latest_at_deployment_start
+    type: github_pat
+    owner: '@github/docs-engineering'
+    externally_usable: true
+  DOCS_BOT_PAT_REPO_SYNC:
+    kind: latest_at_deployment_start
+    type: github_pat
+    owner: '@github/docs-engineering'
+    externally_usable: true
+  ELASTICSEARCH_URL:
+    kind: latest_at_deployment_start
+    type: elasticsearch
+    owner: '@github/docs-engineering'
+    externally_usable: true
+  FASTLY_API_TOKEN:
+    kind: latest_at_deployment_start
+    type: fastly
+    owner: '@github/docs-engineering'
+    externally_usable: true
+  FASTLY_SERVICE_ID:
+    kind: latest_at_deployment_start
+    type: fastly
+    owner: '@github/docs-engineering'
+    externally_usable: true
+  FASTLY_TOKEN:
+    kind: latest_at_deployment_start
+    type: fastly
+    owner: '@github/docs-engineering'
+    externally_usable: true
+  HAYSTACK_URL:
+    kind: latest_at_deployment_start
+    type: failbot
+    owner: '@github/docs-engineering'
+    externally_usable: true
+  HYDRO_ENDPOINT:
+    kind: latest_at_deployment_start
+    type: hydro_api_key
+    owner: '@github/docs-engineering'
+    externally_usable: true
+  HYDRO_SECRET:
+    kind: latest_at_deployment_start
+    type: hydro_api_key
+    owner: '@github/docs-engineering'
+    externally_usable: true

content/code-security/tutorials/trialing-github-advanced-security/explore-trial-code-scanning.md

@@ -84,11 +84,11 @@ Most enterprises put automatic checks in place to block the use of dependencies
 
 This allows you to update the configuration in a single location, but use the workflow in many repositories. You may want to use this central repository to maintain other workflows. For more information, see [AUTOTITLE](/actions/sharing-automations/reusing-workflows).
 
-### {% data variables.product.prodname_copilot_short %} review
+### {% data variables.copilot.copilot_code-review_short %}
 
 > [!NOTE]
 >
-> * If you get a {% data variables.product.prodname_copilot_short %} subscription from an organization, you will only be able to participate in the {% data variables.release-phases.public_preview %} on the {% data variables.product.github %} website if an owner of your organization or enterprise has enabled **Copilot in GitHub.com > Opt in to preview features** in the **{% data variables.product.prodname_copilot %} policies** page of the organization or enterprise settings. See [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization#enabling-copilot-features-in-your-organization) and [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise#copilot-in-githubcom){% ifversion fpt or ghes %} in the {% data variables.product.prodname_ghe_cloud %} documentation{% endif %}.
+> * If you get a {% data variables.product.prodname_copilot_short %} subscription from an organization, you will only be able to participate in the {% data variables.release-phases.public_preview %} on the {% data variables.product.github %} website if an owner of your organization or enterprise has enabled {% data variables.copilot.copilot_code-review_short %}. See [AUTOTITLE](/enterprise-cloud@latest/copilot/how-tos/administer-copilot/manage-for-organization/manage-policies#opting-in-to-previews-or-feedback) and [AUTOTITLE](/enterprise-cloud@latest/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-enterprise-policies){% ifversion fpt or ghes %} in the {% data variables.product.prodname_ghe_cloud %} documentation{% endif %}.
 
 By default, users request a review from {% data variables.product.prodname_copilot_short %} in the same way as they do from human reviewers. However, you can update or create an organization-level branch ruleset to automatically add {% data variables.product.prodname_copilot_short %} as a reviewer to all pull requests made to selected branches in all or selected repositories. See [AUTOTITLE](/enterprise-cloud@latest/copilot/how-tos/agents/copilot-code-review/automatic-code-review){% ifversion fpt or ghes %} in the {% data variables.product.prodname_ghe_cloud %} documentation{% endif %}.
 

content/copilot/concepts/agents/enterprise-management.md

@@ -11,21 +11,23 @@ category:
   - Learn about Copilot
 ---
 
-{% data reusables.enterprise-accounts.ai-controls-preview-note %}
-
 ## Overview
 
-The AI Controls view provides a centralized platform where you can manage and monitor agents across your enterprise. From this agent control plane, you can:
+The AI Controls view provides a centralized platform where you can manage and monitor AI policies and agents across your enterprise. From the "Agents" page, you can:
 * Manage the enterprise-level availability of agents like {% data variables.copilot.copilot_coding_agent %}, {% data variables.copilot.copilot_code-review_short %}, and {% data variables.copilot.copilot_custom_agents %}
 * Control who can manage your enterprise-level {% data variables.copilot.custom_agents_short %}
-* View a list of agent sessions in your enterprise over the last 24 hours
+* View and filter a list of agent sessions in your enterprise over the last 24 hours
 * Find a detailed record of agentic audit log events
 
 ## {% data variables.copilot.copilot_custom_agents %}
 
 {% data variables.copilot.copilot_custom_agents %} are specialized versions of {% data variables.copilot.copilot_coding_agent %} that you can configure with tailored prompts, tools, and context, making them excel at specific tasks. {% data variables.copilot.custom_agents_caps_short %} can be defined and managed at the enterprise level for greater control and compliance, or at the organization and repository levels to allow teams the flexibility to build for their specific needs.
 
-Before you start configuring agentic settings for your enterprise, you should have a strong understanding of {% data variables.copilot.custom_agents_short %}. To learn more, see [AUTOTITLE](/copilot/concepts/agents/coding-agent/about-custom-agents).
+You can manage your enterprise-level {% data variables.copilot.custom_agents_short %}:
+* From the AI Controls view
+* Using the REST API. See [AUTOTITLE](/rest/copilot/copilot-custom-agents).
+
+For more detailed information on {% data variables.copilot.custom_agents_short %}, see [AUTOTITLE](/copilot/concepts/agents/coding-agent/about-custom-agents).
 
 ## Agent sessions
 
@@ -39,3 +41,7 @@ For billing information on agent sessions, see [AUTOTITLE](/billing/concepts/pro
 ## Next steps
 
 To get started with {% data variables.copilot.custom_agents_short %}, see [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/prepare-for-custom-agents).
+
+## Further reading
+
+* [AUTOTITLE](/copilot/concepts/agents/about-third-party-agents)

content/copilot/concepts/context/mcp.md

@@ -99,6 +99,7 @@ The {% data variables.product.github %} MCP Registry is a curated list of MCP se
 
 ## Next steps
 
+* [AUTOTITLE](/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers)
 * [AUTOTITLE](/copilot/how-tos/context/model-context-protocol/extending-copilot-chat-with-mcp)
 * [AUTOTITLE](/copilot/how-tos/context/model-context-protocol/using-the-github-mcp-server)
 * [AUTOTITLE](/copilot/tutorials/enhancing-copilot-agent-mode-with-mcp)

content/copilot/concepts/prompting/response-customization.md

@@ -93,6 +93,8 @@ Here are some common use cases and examples for each type of custom instructions
   * Preferred language for a company which exclusively speaks a single language: `Always respond in Portuguese.`
   * Organization-wide preferences: `Do not generate code blocks in responses.`
 
+{% data reusables.copilot.code-review.custom-instructions-limit %}
+
 {% data reusables.copilot.custom-instructions-effective %}
 
 ## Next steps

content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/manage-copilot-code-review.md

@@ -11,7 +11,7 @@ shortTitle: 'Manage {% data variables.copilot.copilot_code-review_short %}'
 redirect_from:
   - /copilot/how-tos/administer-copilot/manage-for-enterprise/manage-copilot-code-review
 contentType: how-tos
-category: 
+category:
   - Manage Copilot for a team
 ---
 
@@ -28,7 +28,6 @@ You can allow your members to use {% data variables.copilot.copilot_code-review_
 > [!NOTE]
 >
 > {% data reusables.copilot.code-review.preview-note %}
-> * To participate in the {% data variables.release-phases.public_preview %}, you must first enable **{% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_dotcom_the_website %} > Opt in to preview features** from the "{% data variables.product.prodname_copilot_short %}" page of your enterprise's AI Controls.
 
 {% data reusables.enterprise-accounts.policy-enablement-next-steps %}
 

content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/monitor-agentic-activity.md

@@ -12,13 +12,12 @@ category:
   - Manage Copilot for a team
 ---
 
-{% data reusables.enterprise-accounts.ai-controls-preview-note %}
-
 ## Viewing active and recent agentic sessions in your enterprise
 
 {% data reusables.enterprise-accounts.access-enterprise %}
 {% data reusables.enterprise-accounts.ai-controls-tab %}
 1. Towards the top of the page, in the "Agent sessions" section, you will see the three most recent agent sessions in your enterprise. To view all agent sessions from the last 24 hours, click **View all**.
+1. To see available filters for agent sessions, click the search bar at the top of the list, then press <kbd>Space</kbd>. Use the dropdown menu that appears to create your filter criteria.
 
 ## Tracking agentic activity in your enterprise through the audit log
 

content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/prepare-for-custom-agents.md

@@ -13,8 +13,6 @@ category:
   - Manage Copilot for a team
 ---
 
-{% data reusables.enterprise-accounts.ai-controls-preview-note %}
-
 Enterprise-level {% data variables.copilot.custom_agents_short %} are defined in a specific repository within an organization in your enterprise. Before you can create and use {% data variables.copilot.custom_agents_short %}, you need to create this repository and configure the relevant enterprise settings.
 
 ## Creating a repository for your {% data variables.copilot.custom_agents_short %}

content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-enterprise-policies.md

@@ -16,7 +16,7 @@ redirect_from:
   - /copilot/how-tos/administer/enterprises/manage-enterprise-policies
   - /copilot/how-tos/administer/manage-for-enterprise/manage-enterprise-policies
 contentType: how-tos
-category: 
+category:
   - Manage Copilot for a team
 ---
 
@@ -41,11 +41,9 @@ Enterprise owners can define a policy for the whole enterprise, or delegate the
 
 {% data reusables.copilot.mcp-servers-policy-note %}
 
-## Opting in to previews or feedback
+## Opting in to feedback collection
 
-If your enterprise has a {% data variables.copilot.copilot_business_short %} or {% data variables.copilot.copilot_enterprise_short %} plan and you enable "{% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_dotcom_the_website %}" from the "{% data variables.product.prodname_copilot_short %}" page of the "AI Controls" tab, two additional options are displayed:
-
-  {% data reusables.copilot.policies-for-dotcom %}
+If you enable "{% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_dotcom_the_website %}" from the "{% data variables.product.prodname_copilot_short %}" page of the "AI Controls" tab, you can also opt in to user feedback collection to help {% data variables.product.github %} improve {% data variables.product.prodname_copilot_short %} features.
 
 ## Further reading
 

content/copilot/how-tos/configure-content-exclusion/exclude-content-from-copilot.md

@@ -24,7 +24,7 @@ redirect_from:
 topics:
   - Copilot
 contentType: how-tos
-category: 
+category:
   - Configure Copilot
 ---
 
@@ -194,6 +194,12 @@ You can verify that content exclusions you have configured are working as expect
 
      If the file is excluded, {% data variables.copilot.copilot_chat_short %} will not be able to use the file to generate a response. The file will not be listed as a reference in {% data variables.product.prodname_copilot_short %}'s response.
 
+## Manage content exclusions with the REST API
+
+Organization owners and enterprise owners can also manage content exclusions programmatically using the {% data variables.product.github %} REST API.
+
+For more information, see [AUTOTITLE](/rest/copilot/copilot-content-exclusion-management).
+
 ## Further reading
 
 * [AUTOTITLE](/copilot/concepts/content-exclusion-for-github-copilot)

content/copilot/how-tos/copilot-cli/cli-best-practices.md

@@ -483,6 +483,9 @@ To submit private feedback to {% data variables.product.github %} about {% data
 /feedback
 ```
 
+## Hands-on practice
+Try the [Creating applications with {% data variables.copilot.copilot_cli_short %}](https://github.com/skills/create-applications-with-the-copilot-cli) Skills exercise for practical experience building an application with {% data variables.copilot.copilot_cli_short %}.
+
 ## Further reading
 
 * [AUTOTITLE](/copilot/concepts/agents/about-copilot-cli)

content/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers.md

@@ -0,0 +1,105 @@
+---
+title: Adding MCP servers for {% data variables.copilot.copilot_cli %}
+shortTitle: Add MCP servers
+allowTitleToDifferFromFilename: true
+intro: 'Extend {% data variables.product.prodname_copilot_short %}''s capabilities by connecting Model Context Protocol (MCP) servers to provide additional tools and context.'
+versions:
+  feature: copilot
+topics:
+  - Copilot
+contentType: how-tos
+category:
+  - Configure Copilot CLI # Copilot CLI bespoke page
+  - Author and optimize with Copilot # Copilot discovery page
+---
+
+The Model Context Protocol (MCP) is an open standard that defines how applications share context with large language models (LLMs). You can connect MCP servers to {% data variables.copilot.copilot_cli %} to give {% data variables.product.prodname_copilot_short %} access to external tools, data sources, and services. For an overview of MCP, see [AUTOTITLE](/copilot/concepts/about-mcp).
+
+## Adding an MCP server
+
+> [!NOTE]
+> The {% data variables.product.github %} MCP server is built into {% data variables.copilot.copilot_cli_short %} and is already available without any additional configuration. The steps below are for adding other MCP servers.
+
+You can add MCP servers using the interactive `/mcp add` command within the CLI, or by editing the configuration file directly.
+
+For installation instructions, available tools, and URLs for specific MCP servers, see the [{% data variables.product.github %} MCP Registry](https://github.com/mcp).
+
+### Using the `/mcp add` command
+
+1. In interactive mode, enter `/mcp add`. A configuration form is displayed. Use <kbd>Tab</kbd> to navigate between fields.
+1. Next to **Server Name**, enter a unique name for the MCP server. This is the name you will use to refer to the server.
+1. Next to **Server Type**, select a type by pressing the corresponding number. The following types are available:
+
+   * **Local** or **STDIO**: starts a local process and communicates over standard input/output (`stdin`/`stdout`). Both options work the same way. **STDIO** is the standard MCP protocol type name, so choose this if you want your configuration to be compatible with {% data variables.product.prodname_vscode_shortname %}, the {% data variables.copilot.copilot_coding_agent %}, and other MCP clients.
+   * **HTTP** or **SSE**: connects to a remote MCP server. **HTTP** uses the Streamable HTTP transport. **SSE** uses the legacy HTTP with Server-Sent Events transport, which is deprecated in the MCP specification but still supported for backwards compatibility. <!-- markdownlint-disable-line GHD046 -->
+
+1. The remaining fields depend on the server type you selected:
+
+   * If you chose **Local** or **STDIO**:
+
+     * Next to **Command**, enter the command to start the server, including any arguments. For example, `npx @playwright/mcp@latest`. This corresponds to both the `command` and `args` properties in the JSON configuration file.
+     * Next to **Environment Variables**, optionally specify environment variables the server needs, such as API keys or tokens, as JSON key-value pairs. For example, `{"API_KEY": "YOUR-API-KEY"}`. The `PATH` variable is automatically inherited from your environment. All other environment variables must be configured here.
+
+   * If you chose **HTTP** or **SSE**:
+
+     * Next to **URL**, paste the remote server URL. For example, `https://mcp.context7.com/mcp`.
+     * Next to **HTTP Headers**, optionally specify HTTP headers as JSON. For example, `{"CONTEXT7_API_KEY": "YOUR-API-KEY"}`.
+
+1. Next to **Tools**, specify which tools from the server should be available. Enter `*` to include all tools, or provide a comma-separated list of tool names (no quotes needed). The default is `*`.
+1. Press <kbd>Ctrl</kbd>+<kbd>S</kbd> to save the configuration. The MCP server is added and available immediately without restarting the CLI.
+
+### Editing the configuration file
+
+You can also add MCP servers by editing the configuration file at `~/.copilot/mcp-config.json`. This is useful if you want to share configurations or add multiple servers at once.
+
+The following example shows a configuration file with a local server and a remote HTTP server:
+
+```json copy
+{
+  "mcpServers": {
+    "playwright": {
+      "type": "local",
+      "command": "npx",
+      "args": ["@playwright/mcp@latest"],
+      "env": {},
+      "tools": ["*"]
+    },
+    "context7": {
+      "type": "http",
+      "url": "https://mcp.context7.com/mcp",
+      "headers": {
+        "CONTEXT7_API_KEY": "YOUR-API-KEY"
+      },
+      "tools": ["*"]
+    }
+  }
+}
+```
+
+For more information on MCP server configuration, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/extend-coding-agent-with-mcp#writing-a-json-configuration-for-mcp-servers).
+
+## Managing MCP servers
+
+You can manage your configured MCP servers using the following `/mcp` commands in {% data variables.copilot.copilot_cli_short %}.
+
+* **List configured MCP servers:** Use the command `/mcp show`. This displays all configured MCP servers and their current status.
+
+* **View details about a specific server:** Use the command `/mcp show SERVER-NAME`. This displays the status of the specified server and the list of tools it provides.
+
+* **Edit a server's configuration:** Use the command `/mcp edit SERVER-NAME`.
+
+* **Delete a server:** Use the command `/mcp delete SERVER-NAME`.
+
+* **Disable a server:** Use the command `/mcp disable SERVER-NAME`. A disabled server remains configured but is not used by {% data variables.product.prodname_copilot_short %} for the current session.
+
+* **Enable a previously disabled server:** Use the command `/mcp enable SERVER-NAME`.
+
+## Using MCP servers
+
+Once you have added an MCP server, {% data variables.product.prodname_copilot_short %} can automatically use the tools it provides when relevant to your prompt. You can also directly reference an MCP server and specific tools in a prompt to ensure they are used.
+
+## Further reading
+
+* [AUTOTITLE](/copilot/concepts/about-mcp)
+* [AUTOTITLE](/copilot/how-tos/provide-context/use-mcp/extend-copilot-chat-with-mcp)
+* [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/extend-coding-agent-with-mcp)

content/copilot/how-tos/copilot-cli/customize-copilot/index.md

@@ -10,6 +10,7 @@ children:
   - /add-custom-instructions
   - /use-hooks
   - /create-skills
+  - /add-mcp-servers
   - /create-custom-agents-for-cli
   - /plugins-finding-installing
   - /plugins-creating