OCPBUGS-90079: Updated the MCP Server examples with multiple fixes

[dfitzmau]

Version(s):
4.22+

Issue:
OCPBUGS-90079

Link to docs preview:

• https://113895--ocpdocs-pr.netlify.app/openshift-enterprise/latest/ai_applications/mcp_server/mcp-server-overview.html

• SME has approved this change (Yiyong He).
• QE has approved this change (Michal Vinkler).

#111327

[openshift-ci-robot]

@dfitzmau: This pull request references Jira Issue OCPBUGS-90079, which is invalid:

• expected the bug to target the "5.0.0" version, but no target version was set
• expected the bug to be in one of the following states: NEW, ASSIGNED, POST, but it is MODIFIED instead

Comment /jira refresh to re-evaluate validity if changes to the Jira bug are made, or edit the title of this pull request to link to a different bug.

The bug has been updated to refer to the pull request using the external bug tracker.

Details

In response to this:

Version(s):
4.16+

Issue:
OCPBUGS-90079

Link to docs preview:

• SME has approved this change.
• QE has approved this change.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the openshift-eng/jira-lifecycle-plugin repository.

[openshift-ci-robot]

@dfitzmau: This pull request references Jira Issue OCPBUGS-90079, which is invalid:

• expected the bug to target the "5.0.0" version, but no target version was set
• expected the bug to be in one of the following states: NEW, ASSIGNED, POST, but it is MODIFIED instead

Comment /jira refresh to re-evaluate validity if changes to the Jira bug are made, or edit the title of this pull request to link to a different bug.

Details

In response to this:

Version(s):
4.22+

Issue:
OCPBUGS-90079

Link to docs preview:

• SME has approved this change.
• QE has approved this change.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the openshift-eng/jira-lifecycle-plugin repository.

[ocpdocs-previewbot]

🤖 Tue Jun 23 13:48:37 - Prow CI generated the docs preview:

https://113895--ocpdocs-pr.netlify.app/openshift-enterprise/latest/ai_applications/mcp_server/mcp-server-overview.html

[SirVL]

Thanks for working on this update. I think a few issues still need to be adjusted before this PR can be merged.

1. The namespace changes still look inconsistent with the Jira requirement. The Jira says: “The openshift-mcp-server namespace is separate and must remain unchanged for the MCP Server, its HTTPRoute, and its MCPServerRegistration.”
   So I think the fix should be:

   • Keep openshift-mcp-server unchanged for the MCP Server side.
   • Normalize the Gateway-side namespaces gateway-namespace, gateway-system, and mcp-system to gateway-namespace.

2. Some verification commands still appear to use the old namespace mcp-system, for example:

   oc logs -n mcp-system deployment/mcp-gateway
   oc get pods -n mcp-system -l "app.kubernetes.io/name=mcp-gateway"

   These should be updated to use gateway-namespace.

3. The Helm repo add/update steps seem to have been added to the verification section. They should be placed in section 1.1.6.1. Installing the MCP Server Helm chart, before step 1, because the openshift-helm-charts repo alias must exist before the documented Helm installation command can reference openshift-helm-charts/redhat-openshift-mcp-server.

4. The oc get mcpgatewayextension -A example output still looks incorrect. It looks like the value that should have been changed is the NAMESPACE value from mcp-system to gateway-namespace, but the PR changed the NAME value from mcp-gateway to gateway-namespace instead. The NAME should remain mcp-gateway, and the namespace should be updated to gateway-namespace.

Could you please check these points?

[SirVL]

LGTM

[openshift-ci]

@dfitzmau: all tests passed!

Full PR test history. Your PR dashboard.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.

[openshift-ci-robot]

@dfitzmau: This pull request references Jira Issue OCPBUGS-90079, which is invalid:

• expected the bug to target the "5.0.0" version, but no target version was set

Comment /jira refresh to re-evaluate validity if changes to the Jira bug are made, or edit the title of this pull request to link to a different bug.

Details

In response to this:

Version(s):
4.22+

Issue:
OCPBUGS-90079

Link to docs preview:

• https://113895--ocpdocs-pr.netlify.app/openshift-enterprise/latest/ai_applications/mcp_server/mcp-server-overview.html

• SME has approved this change (Yiyong He).
• QE has approved this change.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the openshift-eng/jira-lifecycle-plugin repository.