Split up "Managing CCA for an enterprise" (#60787)

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Author: isaacmbrown

content/copilot/concepts/agents/cloud-agent/access-management.md

@@ -19,7 +19,7 @@ redirect_from:
   - /copilot/concepts/agents/coding-agent/coding-agent-for-business-and-enterprise
   - /copilot/concepts/agents/coding-agent/managing-access
 contentType: concepts
-category: 
+category:
   - Manage Copilot for a team
 ---
 
@@ -48,7 +48,7 @@ Enterprise administrators and organization owners (for organization-owned reposi
 
 For information on disabling {% data variables.copilot.copilot_cloud_agent %} in some or all repositories owned by an organization, see [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-organization/add-copilot-cloud-agent).
 
-For information on disabling {% data variables.copilot.copilot_cloud_agent %} in all repositories owned by an enterprise, see [AUTOTITLE](/enterprise-cloud@latest/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/manage-copilot-cloud-agent).
+For information on disabling {% data variables.copilot.copilot_cloud_agent %} in all repositories owned by an enterprise, see [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/block-copilot-cloud-agent).
 
 For information on disabling {% data variables.copilot.copilot_cloud_agent %} in repositories owned by your personal user account, see [AUTOTITLE](/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/managing-your-copilot-plan/managing-copilot-policies-as-an-individual-subscriber#enabling-or-disabling-copilot-cloud-agent).
 

content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/block-copilot-cloud-agent.md

@@ -0,0 +1,25 @@
+---
+title: Blocking GitHub Copilot cloud agent in your enterprise
+intro: 'Disable use of {% data variables.copilot.copilot_cloud_agent %} for all users and repositories.'
+permissions: Enterprise owners and AI managers
+versions:
+  feature: copilot
+shortTitle: 'Block {% data variables.copilot.copilot_cloud_agent %}'
+contentType: how-tos
+category:
+  - Manage Copilot for a team
+allowTitleToDifferFromFilename: true
+---
+
+Most {% data variables.product.prodname_copilot_short %} policies, including "Enable {% data variables.copilot.copilot_cloud_agent %}", only affect users who receive a {% data variables.product.prodname_copilot_short %} license from your enterprise or organizations.
+
+If you want to disable {% data variables.copilot.copilot_cloud_agent %} in repositories completely, including for users who get access to {% data variables.product.prodname_copilot_short %} from a personal plan or another enterprise, you can use the "Block {% data variables.copilot.copilot_cloud_agent %}" policy.
+
+## Blocking {% data variables.copilot.copilot_cloud_agent %}
+
+>[!NOTE] This enterprise-level policy is a blanket restriction. Organization owners can block {% data variables.copilot.copilot_cloud_agent %} in specific repositories. See [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-organization/add-copilot-cloud-agent).
+
+{% data reusables.enterprise-accounts.access-enterprise %}
+{% data reusables.enterprise-accounts.ai-controls-tab %}
+{% data reusables.enterprise-accounts.cca-policies %}
+1. Next to **Block {% data variables.copilot.copilot_cloud_agent %} in all repositories owned by ENTERPRISE-NAME**, click the toggle.

content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/enable-copilot-cloud-agent.md

@@ -0,0 +1,51 @@
+---
+title: Enabling GitHub Copilot cloud agent in your enterprise
+intro: 'Choose which organizations can use {% data variables.copilot.copilot_cloud_agent %} and connect it to MCP servers.'
+allowTitleToDifferFromFilename: true
+permissions: Enterprise owners and AI managers
+product: '{% data reusables.gated-features.copilot-cloud-agent %}<br><a href="https://github.com/enterprise/contact?ref_product=copilot&ref_type=engagement&ref_style=button" target="_blank" class="btn btn-primary mt-3 mr-3 no-underline"><span>Contact Sales</span> {% octicon "link-external" height:16 %}</a>'
+versions:
+  feature: copilot
+shortTitle: 'Enable {% data variables.copilot.copilot_cloud_agent %}'
+redirect_from:
+  - /copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/manage-copilot-coding-agent
+  - /copilot/managing-copilot/managing-copilot-for-your-enterprise/adding-copilot-coding-agent-to-enterprise
+  - /copilot/managing-copilot/managing-copilot-for-your-enterprise/making-copilot-coding-agent-available-to-enterprise
+  - /copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-copilot-coding-agent-in-your-enterprise
+  - /copilot/how-tos/administer/enterprises/managing-copilot-coding-agent-in-your-enterprise
+  - /copilot/how-tos/administer/enterprises/manage-copilot-coding-agent
+  - /copilot/how-tos/administer/manage-for-enterprise/manage-copilot-coding-agent
+  - /copilot/how-tos/administer-copilot/manage-for-enterprise/manage-copilot-coding-agent
+  - /copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/manage-copilot-cloud-agent
+contentType: how-tos
+category:
+  - Manage Copilot for a team
+---
+
+## Prerequisites
+
+You may want to run a trial before enabling {% data variables.copilot.copilot_cloud_agent %} for the enterprise. See [AUTOTITLE](/copilot/tutorials/cloud-agent/pilot-cloud-agent).
+
+## Enabling {% data variables.copilot.copilot_cloud_agent %}
+
+{% data variables.copilot.copilot_cloud_agent %} and use of third-party MCP servers are disabled by default. You can enable these features for users who receive a {% data variables.product.prodname_copilot_short %} license from your enterprise or organizations.
+
+{% data reusables.enterprise-accounts.access-enterprise %}
+{% data reusables.enterprise-accounts.ai-controls-tab %}
+{% data reusables.enterprise-accounts.cca-policies %}
+1. Select a global policy for {% data variables.copilot.copilot_cloud_agent %}, then communicate your decision with your organizations.
+
+   >[!TIP] If you select **Enabled for selected organizations**, you can select individual organizations in the UI. To select organizations based on custom properties instead, use the REST API. See [AUTOTITLE](/rest/copilot/copilot-coding-agent-management#selecting-organizations-with-custom-properties).
+
+1. By default, the agent will be available in all repositories in selected organizations. If there are repositories where {% data variables.copilot.copilot_cloud_agent %} should be blocked for all users, tell organization owners to configure this setting. See [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-organization/add-copilot-cloud-agent#disabling-or-enabling-copilot-cloud-agent-in-your-repositories).
+
+## Enabling MCP servers
+
+{% data variables.copilot.copilot_cloud_agent %} automatically has access to a small number of default MCP servers. See [AUTOTITLE](/copilot/concepts/agents/cloud-agent/mcp-and-cloud-agent#default-mcp-servers).
+
+You can enable third-party MCP servers to allow developers to integrate {% data variables.copilot.copilot_cloud_agent %} with other services in your DevOps toolchain, such as error-tracking platforms or logging systems.
+
+{% data reusables.enterprise-accounts.view-mcp-policies %}
+1. Set a policy for **MCP servers in {% data variables.product.prodname_copilot_short %}**.
+
+>[!NOTE] The "MCP Registry URL" and "Restrict MCP access to registry servers" policies do **not** apply to {% data variables.copilot.copilot_cloud_agent %}.

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

@@ -1,13 +1,15 @@
 ---
 title: Managing agents in your enterprise
 shortTitle: Manage agents
-intro: 'Maintain your enterprise''s security and compliance standards and empower your developers by managing your agents.'
+intro: Maintain your enterprise's security and compliance standards and empower your developers by managing your agents.
 versions:
   feature: copilot
 children:
   - /prepare-for-custom-agents
   - /monitor-agentic-activity
-  - /manage-copilot-cloud-agent
+  - /enable-copilot-cloud-agent
+  - /block-copilot-cloud-agent
   - /manage-copilot-code-review
 contentType: how-tos
 ---
+

content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/manage-copilot-cloud-agent.md

@@ -0,0 +1,2 @@
+1. In the left sidebar, click {% octicon "agent" aria-hidden="true" aria-label="agent" %} **Agents**.
+1. Under "Available agents", click **Copilot Cloud Agent**.