From 577bc43691069a0cc86895c402e6710f1b58c30b Mon Sep 17 00:00:00 2001 From: Fernanda Date: Wed, 21 Jan 2026 12:36:13 -0300 Subject: [PATCH 01/12] W-20897943-mcp-server-instances-fa --- modules/ROOT/nav.adoc | 1 + .../ROOT/pages/api-instance-landing-page.adoc | 1 + .../create-instance-public-exchange.adoc | 60 +++++++++++++++++++ 3 files changed, 62 insertions(+) create mode 100644 modules/ROOT/pages/create-instance-public-exchange.adoc diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc index f3c61c60..d8e6ac51 100644 --- a/modules/ROOT/nav.adoc +++ b/modules/ROOT/nav.adoc @@ -7,6 +7,7 @@ *** xref:create-instance-task-mule.adoc[Add a Mule Gateway API Instance] *** xref:create-instance-task-flex.adoc[Add a Flex Gateway API Instance] *** xref:create-instance-task-agent-tool.adoc[Add a Flex Gateway Agent or Tool instance] + *** xref:create-instance-public-exchange.adoc[Add an MCP Server or Agent Instance from Public Exchange] ** xref:find-api-id-task.adoc[Obtain an API Instance ID] ** xref:export-api-latest-task.adoc[Export an API Instance] ** xref:access-developer-portal-task.adoc[Access the Developer Portal] diff --git a/modules/ROOT/pages/api-instance-landing-page.adoc b/modules/ROOT/pages/api-instance-landing-page.adoc index ef4dcf10..14b2eda4 100644 --- a/modules/ROOT/pages/api-instance-landing-page.adoc +++ b/modules/ROOT/pages/api-instance-landing-page.adoc @@ -22,6 +22,7 @@ To manage instances in API Manager: ** xref:create-instance-task-mule.adoc[] ** xref:create-instance-task-flex.adoc[] ** xref:create-instance-task-agent-tool.adoc[] +** xref:create-instance-public-exchange.adoc[] . View an instance's summary for information or to export it: ** xref:find-api-id-task.adoc[] - API Manager generates the `apiId` of new APIs managed by API Manager for use with Mule 4. ** xref:export-api-latest-task.adoc[] - After creating an instance, you can export it. This exports the instance configuration and Exchange asset relationship. You can then import it into another environment in the same business group to create a new instance. diff --git a/modules/ROOT/pages/create-instance-public-exchange.adoc b/modules/ROOT/pages/create-instance-public-exchange.adoc new file mode 100644 index 00000000..04cb332e --- /dev/null +++ b/modules/ROOT/pages/create-instance-public-exchange.adoc @@ -0,0 +1,60 @@ += Adding an MCP Server or Agent Instance from Public Exchange +ifndef::env-site,env-github[] +include::_attributes.adoc[] +endif::[] + +This workflow describes how to create an MCP server or agent instance in API Manager by selecting an asset published in the Public Exchange (Provided by MuleSoft). + +You can use this workflow when you want to base a new instance on a publicly available asset, such as an MCP server, agent, or API specification published to Exchange and maintained outside your organization. + +== Before You Begin + +Ensure that you have the required permissions to create instances in API Manager and access assets in Exchange. + +== Add an MCP Server or Agent Instance from Public Exchange + +. Navigate to *Anypoint Platform* > *API Manager*. +. Depending on the instance type you want to create, do one of the following: +* To create an MCP server instance, click *MCP Server*. +* To create an agent instance, click *Agent*. +. Click *Add* to start the guided experience. +. Click *Next* until you reach the *Select asset from Exchange* step. + +. In *Organization*, select *Provided by MuleSoft*. ++ +Selecting *Provided by MuleSoft* lets you browse and search assets that are publicly available in Exchange. + +. Optional: Filter assets by tag. ++ +Use tags to narrow down the list of available assets. Tag filtering is supported when creating MCP server instances and helps you quickly find relevant public assets. + +. Select an asset from the list. ++ +The asset list shows the latest available version and the date it was published to Exchange. You can select a different version if needed. + +. Optional: Click *View in Exchange* to review the asset details before continuing. + +. Click *Next*. + +[NOTE] +-- +When you select an asset from *Provided by MuleSoft*, API Manager automatically populates the instance metadata from Exchange, including the asset name and version. +-- + +. Continue through the remaining steps of the guided experience to configure the instance. ++ +The remaining configuration steps are the same as when creating an instance from a private Exchange asset. + +. Review the configuration and click *Save*. + +== What Happens Next + +After the instance is created, you can manage it in API Manager like any other instance. This includes applying policies, viewing instance details, and monitoring its status. + +Public Exchange assets are treated as read-only sources. The instance maintains a reference to the original Exchange asset rather than copying it into your organization’s private Exchange. + +== See Also + +* xref:latest-overview-concept.adoc[] +* xref:anypoint-exchange::index.adoc[] +* xref:create-instance-task-mcp.adoc[] From 9f11d41c5116f369598df3b860fb2ca9b36a8bb1 Mon Sep 17 00:00:00 2001 From: Fernanda Date: Wed, 21 Jan 2026 14:15:02 -0300 Subject: [PATCH 02/12] Update create-instance-public-exchange.adoc --- modules/ROOT/pages/create-instance-public-exchange.adoc | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/modules/ROOT/pages/create-instance-public-exchange.adoc b/modules/ROOT/pages/create-instance-public-exchange.adoc index 04cb332e..c22e8879 100644 --- a/modules/ROOT/pages/create-instance-public-exchange.adoc +++ b/modules/ROOT/pages/create-instance-public-exchange.adoc @@ -1,11 +1,11 @@ -= Adding an MCP Server or Agent Instance from Public Exchange += Adding an MCP Server from Public Exchange ifndef::env-site,env-github[] include::_attributes.adoc[] endif::[] -This workflow describes how to create an MCP server or agent instance in API Manager by selecting an asset published in the Public Exchange (Provided by MuleSoft). +This workflow describes how to create an MCP server in API Manager by selecting an asset published in the Public Exchange (Provided by MuleSoft). -You can use this workflow when you want to base a new instance on a publicly available asset, such as an MCP server, agent, or API specification published to Exchange and maintained outside your organization. +You can use this workflow when you want to base a new instance on an MCP server published to Exchange and maintained outside your organization. == Before You Begin @@ -16,7 +16,6 @@ Ensure that you have the required permissions to create instances in API Manager . Navigate to *Anypoint Platform* > *API Manager*. . Depending on the instance type you want to create, do one of the following: * To create an MCP server instance, click *MCP Server*. -* To create an agent instance, click *Agent*. . Click *Add* to start the guided experience. . Click *Next* until you reach the *Select asset from Exchange* step. @@ -57,4 +56,4 @@ Public Exchange assets are treated as read-only sources. The instance maintains * xref:latest-overview-concept.adoc[] * xref:anypoint-exchange::index.adoc[] -* xref:create-instance-task-mcp.adoc[] +* xref:create-instance-task-agent-tool.adoc[] From 0f0acddb4176c3ba7fdd19c10c49e5698dd90e30 Mon Sep 17 00:00:00 2001 From: Fernanda Ailup <105381467+failup@users.noreply.github.com> Date: Wed, 21 Jan 2026 15:24:15 -0300 Subject: [PATCH 03/12] Update modules/ROOT/pages/create-instance-public-exchange.adoc Co-authored-by: Jenny Hajee <94015849+JennyHajee@users.noreply.github.com> --- modules/ROOT/pages/create-instance-public-exchange.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/create-instance-public-exchange.adoc b/modules/ROOT/pages/create-instance-public-exchange.adoc index c22e8879..a7c768e5 100644 --- a/modules/ROOT/pages/create-instance-public-exchange.adoc +++ b/modules/ROOT/pages/create-instance-public-exchange.adoc @@ -3,7 +3,7 @@ ifndef::env-site,env-github[] include::_attributes.adoc[] endif::[] -This workflow describes how to create an MCP server in API Manager by selecting an asset published in the Public Exchange (Provided by MuleSoft). +This workflow describes how to create an MCP server in API Manager by selecting an asset published in the public Exchange (Provided by MuleSoft). You can use this workflow when you want to base a new instance on an MCP server published to Exchange and maintained outside your organization. From e771761f001a1339766832c17915b345083dc4a1 Mon Sep 17 00:00:00 2001 From: Fernanda Ailup <105381467+failup@users.noreply.github.com> Date: Wed, 21 Jan 2026 15:24:22 -0300 Subject: [PATCH 04/12] Update modules/ROOT/pages/create-instance-public-exchange.adoc Co-authored-by: Jenny Hajee <94015849+JennyHajee@users.noreply.github.com> --- modules/ROOT/pages/create-instance-public-exchange.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/create-instance-public-exchange.adoc b/modules/ROOT/pages/create-instance-public-exchange.adoc index a7c768e5..6a12f60b 100644 --- a/modules/ROOT/pages/create-instance-public-exchange.adoc +++ b/modules/ROOT/pages/create-instance-public-exchange.adoc @@ -5,7 +5,7 @@ endif::[] This workflow describes how to create an MCP server in API Manager by selecting an asset published in the public Exchange (Provided by MuleSoft). -You can use this workflow when you want to base a new instance on an MCP server published to Exchange and maintained outside your organization. +To base a new instance on an MCP server published to Exchange and maintained outside your organization, use this workflow. == Before You Begin From c0d22113bfcb1f86ffb48bb0501b0a3d5f3e0aca Mon Sep 17 00:00:00 2001 From: Fernanda Ailup <105381467+failup@users.noreply.github.com> Date: Wed, 21 Jan 2026 15:24:30 -0300 Subject: [PATCH 05/12] Update modules/ROOT/pages/create-instance-public-exchange.adoc Co-authored-by: Jenny Hajee <94015849+JennyHajee@users.noreply.github.com> --- modules/ROOT/pages/create-instance-public-exchange.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/create-instance-public-exchange.adoc b/modules/ROOT/pages/create-instance-public-exchange.adoc index 6a12f60b..c96c1079 100644 --- a/modules/ROOT/pages/create-instance-public-exchange.adoc +++ b/modules/ROOT/pages/create-instance-public-exchange.adoc @@ -9,7 +9,7 @@ To base a new instance on an MCP server published to Exchange and maintained out == Before You Begin -Ensure that you have the required permissions to create instances in API Manager and access assets in Exchange. +Make sure you have the required permissions to create instances in API Manager and access assets in Exchange. == Add an MCP Server or Agent Instance from Public Exchange From eec524bc32f22fd315c9e41cc6ce5be0428c62db Mon Sep 17 00:00:00 2001 From: Fernanda Ailup <105381467+failup@users.noreply.github.com> Date: Wed, 21 Jan 2026 15:24:40 -0300 Subject: [PATCH 06/12] Update modules/ROOT/pages/create-instance-public-exchange.adoc Co-authored-by: Jenny Hajee <94015849+JennyHajee@users.noreply.github.com> --- modules/ROOT/pages/create-instance-public-exchange.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/create-instance-public-exchange.adoc b/modules/ROOT/pages/create-instance-public-exchange.adoc index c96c1079..0c505a74 100644 --- a/modules/ROOT/pages/create-instance-public-exchange.adoc +++ b/modules/ROOT/pages/create-instance-public-exchange.adoc @@ -23,7 +23,7 @@ Make sure you have the required permissions to create instances in API Manager a + Selecting *Provided by MuleSoft* lets you browse and search assets that are publicly available in Exchange. -. Optional: Filter assets by tag. +. To find an asset, search by name or filter using the *Provided by Mulesoft* tag. + Use tags to narrow down the list of available assets. Tag filtering is supported when creating MCP server instances and helps you quickly find relevant public assets. From 7e50d87f6e80350b68ce1e71f823d6d66e723adb Mon Sep 17 00:00:00 2001 From: Fernanda Ailup <105381467+failup@users.noreply.github.com> Date: Wed, 21 Jan 2026 15:24:50 -0300 Subject: [PATCH 07/12] Update modules/ROOT/pages/create-instance-public-exchange.adoc Co-authored-by: Jenny Hajee <94015849+JennyHajee@users.noreply.github.com> --- modules/ROOT/pages/create-instance-public-exchange.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/create-instance-public-exchange.adoc b/modules/ROOT/pages/create-instance-public-exchange.adoc index 0c505a74..3fbb6cf7 100644 --- a/modules/ROOT/pages/create-instance-public-exchange.adoc +++ b/modules/ROOT/pages/create-instance-public-exchange.adoc @@ -14,7 +14,7 @@ Make sure you have the required permissions to create instances in API Manager a == Add an MCP Server or Agent Instance from Public Exchange . Navigate to *Anypoint Platform* > *API Manager*. -. Depending on the instance type you want to create, do one of the following: +. Select an instance type. * To create an MCP server instance, click *MCP Server*. . Click *Add* to start the guided experience. . Click *Next* until you reach the *Select asset from Exchange* step. From 3e5e4376ff3548c493e73544b3198e8eaec23585 Mon Sep 17 00:00:00 2001 From: Fernanda Ailup <105381467+failup@users.noreply.github.com> Date: Wed, 21 Jan 2026 15:24:59 -0300 Subject: [PATCH 08/12] Update modules/ROOT/pages/create-instance-public-exchange.adoc Co-authored-by: Jenny Hajee <94015849+JennyHajee@users.noreply.github.com> --- modules/ROOT/pages/create-instance-public-exchange.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/create-instance-public-exchange.adoc b/modules/ROOT/pages/create-instance-public-exchange.adoc index 3fbb6cf7..fd72ef84 100644 --- a/modules/ROOT/pages/create-instance-public-exchange.adoc +++ b/modules/ROOT/pages/create-instance-public-exchange.adoc @@ -31,7 +31,7 @@ Use tags to narrow down the list of available assets. Tag filtering is supported + The asset list shows the latest available version and the date it was published to Exchange. You can select a different version if needed. -. Optional: Click *View in Exchange* to review the asset details before continuing. +. To review the asset details before continuing, click *View in Exchange*. . Click *Next*. From 7102b2cc13d88c373015ff8ae2084484472dab63 Mon Sep 17 00:00:00 2001 From: Fernanda Ailup <105381467+failup@users.noreply.github.com> Date: Thu, 22 Jan 2026 15:11:28 -0300 Subject: [PATCH 09/12] Update nav.adoc --- modules/ROOT/nav.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc index d8e6ac51..a510afe6 100644 --- a/modules/ROOT/nav.adoc +++ b/modules/ROOT/nav.adoc @@ -7,7 +7,7 @@ *** xref:create-instance-task-mule.adoc[Add a Mule Gateway API Instance] *** xref:create-instance-task-flex.adoc[Add a Flex Gateway API Instance] *** xref:create-instance-task-agent-tool.adoc[Add a Flex Gateway Agent or Tool instance] - *** xref:create-instance-public-exchange.adoc[Add an MCP Server or Agent Instance from Public Exchange] + *** xref:create-instance-public-exchange.adoc[Add an MCP Server from Public Exchange] ** xref:find-api-id-task.adoc[Obtain an API Instance ID] ** xref:export-api-latest-task.adoc[Export an API Instance] ** xref:access-developer-portal-task.adoc[Access the Developer Portal] From 6198ae665a59c585c231b7e1ea571e8bc06e425d Mon Sep 17 00:00:00 2001 From: Fernanda Ailup <105381467+failup@users.noreply.github.com> Date: Thu, 22 Jan 2026 15:17:13 -0300 Subject: [PATCH 10/12] Update create-instance-public-exchange.adoc --- modules/ROOT/pages/create-instance-public-exchange.adoc | 4 ---- 1 file changed, 4 deletions(-) diff --git a/modules/ROOT/pages/create-instance-public-exchange.adoc b/modules/ROOT/pages/create-instance-public-exchange.adoc index fd72ef84..c52a43ee 100644 --- a/modules/ROOT/pages/create-instance-public-exchange.adoc +++ b/modules/ROOT/pages/create-instance-public-exchange.adoc @@ -7,10 +7,6 @@ This workflow describes how to create an MCP server in API Manager by selecting To base a new instance on an MCP server published to Exchange and maintained outside your organization, use this workflow. -== Before You Begin - -Make sure you have the required permissions to create instances in API Manager and access assets in Exchange. - == Add an MCP Server or Agent Instance from Public Exchange . Navigate to *Anypoint Platform* > *API Manager*. From 455a911f6d237d12d7f2d348b16d3b56a543076f Mon Sep 17 00:00:00 2001 From: Fernanda Ailup <105381467+failup@users.noreply.github.com> Date: Thu, 22 Jan 2026 15:17:32 -0300 Subject: [PATCH 11/12] Update create-instance-public-exchange.adoc --- modules/ROOT/pages/create-instance-public-exchange.adoc | 1 - 1 file changed, 1 deletion(-) diff --git a/modules/ROOT/pages/create-instance-public-exchange.adoc b/modules/ROOT/pages/create-instance-public-exchange.adoc index c52a43ee..09b46a65 100644 --- a/modules/ROOT/pages/create-instance-public-exchange.adoc +++ b/modules/ROOT/pages/create-instance-public-exchange.adoc @@ -11,7 +11,6 @@ To base a new instance on an MCP server published to Exchange and maintained out . Navigate to *Anypoint Platform* > *API Manager*. . Select an instance type. -* To create an MCP server instance, click *MCP Server*. . Click *Add* to start the guided experience. . Click *Next* until you reach the *Select asset from Exchange* step. From cf49799b087aa79492128a0cbc6985a87c1f1ac2 Mon Sep 17 00:00:00 2001 From: Fernanda Ailup <105381467+failup@users.noreply.github.com> Date: Thu, 22 Jan 2026 15:18:22 -0300 Subject: [PATCH 12/12] Update create-instance-public-exchange.adoc --- modules/ROOT/pages/create-instance-public-exchange.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/create-instance-public-exchange.adoc b/modules/ROOT/pages/create-instance-public-exchange.adoc index 09b46a65..f1a6293c 100644 --- a/modules/ROOT/pages/create-instance-public-exchange.adoc +++ b/modules/ROOT/pages/create-instance-public-exchange.adoc @@ -20,7 +20,7 @@ Selecting *Provided by MuleSoft* lets you browse and search assets that are publ . To find an asset, search by name or filter using the *Provided by Mulesoft* tag. + -Use tags to narrow down the list of available assets. Tag filtering is supported when creating MCP server instances and helps you quickly find relevant public assets. +Use tags to narrow down the list of available assets. . Select an asset from the list. +