Peer review

Author: pabel-rh

assemblies/assembly-resolving-common-problems-with-mcp-clients-and-tools.adoc

@@ -4,10 +4,16 @@
 = Troubleshooting MCP server and client problems
 :context: assembly-troubleshooting-mcp-server-and-client-problems
 
+The following procedures guide you through resolving common issues when using a Model Communication Protocol (MCP) server and tool.
+
 include::modules/model-context-protocol-tools/proc-verifying-successful-installation-of-mcp-plugins.adoc[leveloffset=+1]
 
 include::modules/model-context-protocol-tools/proc-checking-logs-for-mcp-tool-execution-and-errors.adoc[leveloffset=+1]
 
 include::modules/model-context-protocol-tools/con-understand-and-respond-to-mcp-tool-error-messages.adoc[leveloffset=+1]
 
-include::assembly-resolving-common-problems-with-mcp-clients-and-tools.adoc[leveloffset=+1]
+include::modules/model-context-protocol-tools/proc-resolving-the-model-does-not-support-tool-calling-error.adoc[leveloffset=+1]
+
+include::modules/model-context-protocol-tools/proc-resolving-authentication-issues-when-tool-are-not-found.adoc[leveloffset=+1]
+
+include::modules/model-context-protocol-tools/proc-nonsensical-mcp-tool-output.adoc[leveloffset=+1]

assemblies/assembly-troubleshooting-mcp-server-and-client-problems.adoc

@@ -1,7 +1,7 @@
 :_mod-docs-content-type: PROCEDURE
 
 [id="proc-checking-logs-for-mcp-tool-execution-and-errors.adoc_{context}"]
-= Checking logs for MCP tool execution and errors
+= Checking MCP tool logs for status and errors
 
 The {backstage} `LoggerService` target name starts with the name of the MCP tool (either `software-catalog-mcp-tool` or `techdocs-mcp-tool`). The MCP tools generate a log by default. For example:
 

modules/model-context-protocol-tools/proc-checking-logs-for-mcp-tool-execution-and-errors.adoc

@@ -8,7 +8,7 @@ If your MCP client connects to the server but cannot find deployed tools, an aut
 .Procedure
 
 . Verify the authentication token.
-.. Configure a static token for the RHDH MCP server.
+.. Configure a static token for the {product-very-short} MCP server.
 .. Set this token as the bearer token in your MCP client and make sure the authorization header is the configuration specifies `Bearer` before the token, for example, `Bearer <mcp_token>`.
 . Check the MCP endpoint configuration.
 .. Confirm that the MCP server URL properly resolves, particularly if you are using a desktop client.