[release-1.10] RHIDP-13661: MCP JTBD implementation (#2225)

* MCP JTBD implementation

* MAysun's content update

* Incorporated Maysun's comments

---------

Co-authored-by: Priyanka Abel <pabel@redhat.com>

Author: openshift-cherrypick-robot

assemblies/integrate_interacting-with-model-context-protocol-tools-for-rhdh/assembly-configure-and-manage-mcp-settings.adoc

@@ -1,12 +1,12 @@
 :_mod-docs-content-type: ASSEMBLY
 ifdef::context[:parent-context: {context}]
 
-[id="install-the-mcp-server-and-tool-plugins-in-rhdh_{context}"]
-= Install the MCP server and tool plugins in {product}
+[id="install-mcp-server-and-tool-plugins-to-expose-portal-capabilities-to-the-ai_{context}"]
+= Install MCP server and tool plugins to expose portal capabilities to the AI
 :context: install-the-mcp-server-and-tool-plugins-in-rhdh
 
 [role="_abstract"]
-As an administrator, you can enable Model Context Protocol (MCP) support in {product} by installing the backend server and tool plugins. 
+Install the Model Context Protocol (MCP) server and its associated tool plugins to expose {product} portal capabilities, such as the Software Catalog and TechDocs, to your external AI assistant.
 
 The backend MCP server plugin runs the MCP tools, while the individual tool plugins expose specific capabilities for the Software Catalog, TechDocs, and Scaffolder features.
 

…mcp-server-and-tool-plugins-in-rhdh.adoc …xpose-portal-capabilities-to-the-ai.adocassemblies/integrate_interacting-with-model-context-protocol-tools-for-rhdh/assembly-install-the-mcp-server-and-tool-plugins-in-rhdh.adoc renamed to assemblies/integrate_interacting-with-model-context-protocol-tools-for-rhdh/assembly-install-mcp-server-and-tool-plugins-to-expose-portal-capabilities-to-the-ai.adoc assemblies/integrate_interacting-with-model-context-protocol-tools-for-rhdh/assembly-install-the-mcp-server-and-tool-plugins-in-rhdh.adoc renamed to assemblies/integrate_interacting-with-model-context-protocol-tools-for-rhdh/assembly-install-mcp-server-and-tool-plugins-to-expose-portal-capabilities-to-the-ai.adoc

@@ -0,0 +1,16 @@
+:_mod-docs-content-type: ASSEMBLY
+ifdef::context[:parent-context: {context}]
+
+[id="store-personal-access-tokens-securely-to-authorize-ai-workflows-on-your-behalf_{context}"]
+= Store personal access tokens securely to authorize AI workflows on your behalf
+:context: store-personal-access-tokens-securely-to-authorize-ai-workflows-on-your-behalf
+
+[role="_abstract"]
+When using third-party MCP integrations, you can store your personal access tokens securely and manage credentials in {ls-brand-name} so that the AI acts on your behalf.
+
+include::../modules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/proc-enable-encryption-and-database-storage-for-mcp-server-tokens.adoc[leveloffset=+1]
+
+include::../modules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/proc-toggle-mcp-tools-in-the-chat-interface-to-control-the-data-context-provided-to-the-ai.adoc[leveloffset=+1]
+
+ifdef::parent-context[:context: {parent-context}]
+ifndef::parent-context[:!context:]

assemblies/integrate_interacting-with-model-context-protocol-tools-for-rhdh/assembly-store-personal-access-tokens-securely-to-authorize-ai-workflows-on-your-behalf.adoc

@@ -1,10 +1,10 @@
 :_mod-docs-content-type: PROCEDURE
 
-[id="configure-model-context-protocol-in-rhdh_{context}"]
-= Configure Model Context Protocol in {product}
+[id="configure-mcp-tokens-and-endpoints-to-authorize-client-access_{context}"]
+= Configure MCP tokens and endpoints to authorize client access
 
 [role="_abstract"]
-Enable MCP client applications to access {product-very-short} information and workflows by configuring authentication tokens and server endpoints.
+Configure Model Context Protocol (MCP) server endpoints, database backends, and authentication tokens to securely authorize client applications to interact with your developer portal.
 
 This configuration is a prerequisite for MCP clients to use the defined MCP tools and access the exposed capabilities of {product-very-short}.
 

…gure-model-context-protocol-in-rhdh.adoc …ndpoints-to-authorize-client-access.adocmodules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/proc-configure-model-context-protocol-in-rhdh.adoc renamed to modules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/proc-configure-mcp-tokens-and-endpoints-to-authorize-client-access.adoc modules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/proc-configure-model-context-protocol-in-rhdh.adoc renamed to modules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/proc-configure-mcp-tokens-and-endpoints-to-authorize-client-access.adoc

@@ -1,10 +1,10 @@
 :_mod-docs-content-type: PROCEDURE
 
-[id="manage-mcp-settings-in-the-user-interface_{context}"]
-= Manage MCP settings in the user interface
+[id="toggle-mcp-tools-in-the-chat-interface-to-control-the-data-context-provided-to-the-ai_{context}"]
+= Toggle MCP tools in the chat interface to control the data context provided to the AI
 
 [role="_abstract"]
-To customize the tools and data sources available in the {ls-brand-name} chat interface, you can manage Model Context Protocol (MCP) server connections and personal authentication tokens.
+Use the {ls-brand-name} chat interface options to securely configure your personal tokens, toggle specific Model Context Protocol (MCP) services, and directly control the data context made available to the AI assistant.
 
 You can use the *MCP settings* panel in the {ls-short} chat interface to review server status and enable or disable specific tools for your session.
 

…-mcp-settings-in-the-user-interface.adoc …the-data-context-provided-to-the-ai.adocmodules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/proc-manage-mcp-settings-in-the-user-interface.adoc renamed to modules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/proc-toggle-mcp-tools-in-the-chat-interface-to-control-the-data-context-provided-to-the-ai.adoc modules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/proc-manage-mcp-settings-in-the-user-interface.adoc renamed to modules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/proc-toggle-mcp-tools-in-the-chat-interface-to-control-the-data-context-provided-to-the-ai.adoc

@@ -1,10 +1,10 @@
 :_mod-docs-content-type: REFERENCE
 
-[id="access-rhdh-data-using-the-software-catalog-mcp-tools_{context}"]
-= Access {product-very-short} data using the Software Catalog MCP tools
+[id="enable-software-catalog-mcp-tools-to-allow-the-ai-to-query-component-metadata_{context}"]
+= Enable Software Catalog MCP tools to allow the AI to query component metadata
 
 [role="_abstract"]
-Manage and retrieve Software Catalog entities including Components, Systems, Resources, APIs, Locations, Users, and Groups using MCP tools.
+Enable and use the Software Catalog MCP tools so that the AI assistant can seamlessly query internal software component metadata, relations, and ownership information on your behalf.
 
 Use Software Catalog MCP tools to manage and retrieve {product-very-short} entities such as *Components*, *Systems*, *Resources*, *APIs*, *Locations*, *Users*, and *Groups*. 
 

…sing-the-software-catalog-mcp-tools.adoc …-the-ai-to-query-component-metadata.adocmodules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/ref-access-rhdh-data-using-the-software-catalog-mcp-tools.adoc renamed to modules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/ref-enable-software-catalog-mcp-tools-to-allow-the-ai-to-query-component-metadata.adoc modules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/ref-access-rhdh-data-using-the-software-catalog-mcp-tools.adoc renamed to modules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/ref-enable-software-catalog-mcp-tools-to-allow-the-ai-to-query-component-metadata.adoc

@@ -1,10 +1,10 @@
 :_mod-docs-content-type: REFERENCE
 
-[id="access-and-analyze-documentation-using-the-techdocs-mcp-tools_{context}"]
-= Access and analyze documentation using the TechDocs MCP tools
+[id="enable-techdocs-mcp-tools-to-allow-the-ai-to-read-and-analyze-internal-documentation_{context}"]
+= Enable TechDocs MCP tools to allow the AI to read and analyze internal documentation
 
 [role="_abstract"]
-Use TechDocs MCP tools to search, retrieve, and analyze documentation content from {product-short} for AI applications.
+Enable and use TechDocs MCP tools to allow the AI assistant to search, read, and analyze your internal technical documentation to resolve queries with accurate portal data.
 
 The TechDocs MCP tool enables MCP clients to search and retrieve documentation from {product-very-short} for use as context in AI applications.
 

…tation-using-the-techdocs-mcp-tools.adoc …-and-analyze-internal-documentation.adocmodules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/ref-access-and-analyze-documentation-using-the-techdocs-mcp-tools.adoc renamed to modules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/ref-enable-techdocs-mcp-tools-to-allow-the-ai-to-read-and-analyze-internal-documentation.adoc modules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/ref-access-and-analyze-documentation-using-the-techdocs-mcp-tools.adoc renamed to modules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/ref-enable-techdocs-mcp-tools-to-allow-the-ai-to-read-and-analyze-internal-documentation.adoc

@@ -16,15 +16,15 @@ include::artifacts/attributes.adoc[]
 
 include::modules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/con-model-context-protocol.adoc[leveloffset=+1]
 
-include::assemblies/integrate_interacting-with-model-context-protocol-tools-for-rhdh/assembly-install-the-mcp-server-and-tool-plugins-in-rhdh.adoc[leveloffset=+1]
+include::assemblies/integrate_interacting-with-model-context-protocol-tools-for-rhdh/assembly-install-mcp-server-and-tool-plugins-to-expose-portal-capabilities-to-the-ai.adoc[leveloffset=+1]
 
-include::modules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/proc-configure-model-context-protocol-in-rhdh.adoc[leveloffset=+1]
+include::modules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/proc-configure-mcp-tokens-and-endpoints-to-authorize-client-access.adoc[leveloffset=+1]
 
 include::modules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/proc-configure-mcp-clients-to-access-the-rhdh-server.adoc[leveloffset=+2]
 
-include::assemblies/integrate_interacting-with-model-context-protocol-tools-for-rhdh/assembly-configure-and-manage-mcp-settings.adoc[leveloffset=+1]
+include::assemblies/integrate_interacting-with-model-context-protocol-tools-for-rhdh/assembly-store-personal-access-tokens-securely-to-authorize-ai-workflows-on-your-behalf.adoc[leveloffset=+1]
 
-include::modules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/ref-access-rhdh-data-using-the-software-catalog-mcp-tools.adoc[leveloffset=+1]
+include::modules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/ref-enable-software-catalog-mcp-tools-to-allow-the-ai-to-query-component-metadata.adoc[leveloffset=+1]
 
 include::modules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/ref-fetch-entities-using-fetch-catalog-entities.adoc[leveloffset=+2]
 
@@ -34,7 +34,7 @@ include::modules/integrate_interacting-with-model-context-protocol-tools-for-rhd
 
 include::modules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/ref-retrieve-software-template-metadata.adoc[leveloffset=+2]
 
-include::modules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/ref-access-and-analyze-documentation-using-the-techdocs-mcp-tools.adoc[leveloffset=+1]
+include::modules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/ref-enable-techdocs-mcp-tools-to-allow-the-ai-to-read-and-analyze-internal-documentation.adoc[leveloffset=+1]
 
 include::modules/integrate_interacting-with-model-context-protocol-tools-for-rhdh/ref-retrieve-techdocs-urls-and-metadata-using-fetch-techdocs.adoc[leveloffset=+2]