OSDOCS-18945: adds troubleshooting MCP gateway by ShaunaDiaz · Pull Request #110076 · openshift/openshift-docs

ShaunaDiaz · 2026-04-14T17:40:16Z

Version(s):
mcp-gateway-docs-tp

Link to docs preview:
https://110076--ocpdocs-pr.netlify.app/rhcl/latest/observe_troubleshoot/mcp-gateway-troubleshooting.html
https://110076--ocpdocs-pr.netlify.app/rhcl/latest/mcp_gateway_config/mcp-gateway-register-ext-mcp-servers.html#proc-register-ext-mcp-server-mcpserverregistration_mcp-gateway-register-ext-mcp-servers (added IMPORTANT note to extension creation)
https://110076--ocpdocs-pr.netlify.app/rhcl/latest/mcp_gateway_config/mcp-gateway-register-ext-mcp-servers.html#proc-register-ext-mcp-server-mcpserverregistration_mcp-gateway-register-ext-mcp-servers (added IMPORTANT note to extension creation)

QE review:

QE approved this change.

Additional information:
Docs merge reviewer, the mcp-gateway-docs-tp is a Release branch, so content work is incremental. The entire branch will be integrated into the rhcl-docs-main, rhcl-docs-1.3, and rhcl-docs-1.4 docs in late April, and therefore, not published anywhere now.

Awaiting QE, please do not merge. Merge freeze is Monday, April 27.

Second half: #110691

openshift-ci-robot · 2026-04-14T17:40:21Z

@ShaunaDiaz: This pull request references OSDOCS-18945 which is a valid jira issue.

Details

In response to this:

Version(s):
mcp-gateway-docs-tp

Issue:
OSDOCS-18945

Link to docs preview:

QE review:

SME approved this change.

QE approved this change.

Additional information:
Docs merge reviewer, the mcp-gateway-docs-tp is a Release branch, so content work is incremental. The entire branch will be integrated into the rhcl-docs-main, rhcl-docs-1.3, and rhcl-docs-1.4 docs in late April, and therefore, not published anywhere now.

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 · 2026-04-14T17:55:22Z

🤖 Mon Apr 27 15:49:24 - Prow CI generated the docs preview:

https://110076--ocpdocs-pr.netlify.app/rhcl/latest/mcp_gateway_config/mcp-gateway-register-ext-mcp-servers.html
https://110076--ocpdocs-pr.netlify.app/rhcl/latest/mcp_gateway_config/mcp-gateway-register-on-prem-mcp-servers.html
https://110076--ocpdocs-pr.netlify.app/rhcl/latest/observe_troubleshoot/mcp-gateway-troubleshooting.html

openshift-ci-robot · 2026-04-15T12:23:46Z

@ShaunaDiaz: This pull request references OSDOCS-18945 which is a valid jira issue.

Details

In response to this:

Version(s):
mcp-gateway-docs-tp

Issue:
OSDOCS-18945

Link to docs preview:
https://110076--ocpdocs-pr.netlify.app/rhcl/latest/observe_troubleshoot/mcp-gateway-troubleshooting.html

QE review:

SME approved this change.

QE approved this change.

Additional information:
Docs merge reviewer, the mcp-gateway-docs-tp is a Release branch, so content work is incremental. The entire branch will be integrated into the rhcl-docs-main, rhcl-docs-1.3, and rhcl-docs-1.4 docs in late April, and therefore, not published anywhere now.

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.

trepel

A few minor comments.

The major issue is with the EnvoyFilter Troubleshooting where the commands did not work for me and it is not clear to me how to workaround it

lahinson

@ShaunaDiaz Just a few minor things to double-check. Feel free to merge this when you have QE sign-off and you're ready.

openshift-ci · 2026-04-27T15:50:52Z

@ShaunaDiaz: 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.

trepel

A few additional comments

trepel · 2026-04-27T15:53:46Z

+
+[source,terminal,subs="+quotes"]
+----
+$ oc exec -n _<gateway_namespace>_ deploy/_<gateway_name>_-istio -- curl -s localhost:15000/config_dump | jq '.configs[] | select(.["@type"] | contains("ListenersConfigDump")) | .dynamic_listeners[0.0.0.0_8080] | select(.name | contains("_<gateway_port>_"))'


The commands like this one does not work because curl binary is missing but even if there's no time to fix them let's keep them anyway - they still show valuable info on how to debug issues

should we do something different, like:
$ oc debug -n <gateway_namespace> deploy/<gateway_name>-istio -- curl -s localhost:15000/config_dump

openshift-ci-robot added the jira/valid-reference Indicates that this PR references a valid Jira ticket of any type. label Apr 14, 2026

ShaunaDiaz changed the title ~~OSDOCS-18945: adds troubleshooting MCP gateway~~ [WIP] OSDOCS-18945: adds troubleshooting MCP gateway Apr 14, 2026

openshift-ci Bot added do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. size/L Denotes a PR that changes 100-499 lines, ignoring generated files. labels Apr 14, 2026

ShaunaDiaz force-pushed the OSDOCS-18945 branch from bd295b0 to 4d0fda9 Compare April 14, 2026 18:53

ShaunaDiaz force-pushed the OSDOCS-18945 branch 7 times, most recently from 69e956e to 10e6223 Compare April 20, 2026 13:57

openshift-ci Bot added size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. and removed size/L Denotes a PR that changes 100-499 lines, ignoring generated files. labels Apr 20, 2026

ShaunaDiaz force-pushed the OSDOCS-18945 branch 4 times, most recently from 3e436c1 to 24792a0 Compare April 21, 2026 17:30

openshift-ci Bot added size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. and removed size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. labels Apr 21, 2026

ShaunaDiaz force-pushed the OSDOCS-18945 branch from 24792a0 to 18c6743 Compare April 21, 2026 18:19

ShaunaDiaz changed the title ~~[WIP] OSDOCS-18945: adds troubleshooting MCP gateway~~ OSDOCS-18945: adds troubleshooting MCP gateway Apr 21, 2026

openshift-ci Bot removed the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Apr 21, 2026

ShaunaDiaz added do-not-merge/hold Indicates that a PR should not merge because someone has issued a /hold command. merge-review-needed Signifies that the merge review team needs to review this PR labels Apr 21, 2026

ShaunaDiaz force-pushed the OSDOCS-18945 branch from 18c6743 to daa59d1 Compare April 23, 2026 12:59

ShaunaDiaz mentioned this pull request Apr 23, 2026

OSDOCS-18945-2: adds troubleshooting MCP gateway #110691

Open

1 task

openshift-ci Bot added size/L Denotes a PR that changes 100-499 lines, ignoring generated files. and removed size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. labels Apr 23, 2026

ShaunaDiaz force-pushed the OSDOCS-18945 branch from daa59d1 to ffb1816 Compare April 24, 2026 12:12

trepel suggested changes Apr 24, 2026

View reviewed changes

ShaunaDiaz force-pushed the OSDOCS-18945 branch from ffb1816 to 51d5626 Compare April 24, 2026 16:41

trepel reviewed Apr 27, 2026

View reviewed changes

Comment thread modules/proc-mcp-gateway-ts-requests-fail-or-bypass-router.adoc Outdated

ShaunaDiaz force-pushed the OSDOCS-18945 branch 2 times, most recently from 11cef53 to e70d9ba Compare April 27, 2026 11:42

lahinson added merge-review-in-progress Signifies that the merge review team is reviewing this PR and removed merge-review-needed Signifies that the merge review team needs to review this PR labels Apr 27, 2026

lahinson reviewed Apr 27, 2026

View reviewed changes

lahinson added ok-to-merge and removed merge-review-in-progress Signifies that the merge review team is reviewing this PR labels Apr 27, 2026

ShaunaDiaz force-pushed the OSDOCS-18945 branch from e70d9ba to 4bd48f6 Compare April 27, 2026 15:34

ShaunaDiaz removed the do-not-merge/hold Indicates that a PR should not merge because someone has issued a /hold command. label Apr 27, 2026

trepel suggested changes Apr 27, 2026

View reviewed changes

OSDOCS-18945: adds troubleshooting MCP gateway

f08cbf8

ShaunaDiaz force-pushed the OSDOCS-18945 branch from 4bd48f6 to f08cbf8 Compare April 27, 2026 16:40

Conversation

ShaunaDiaz commented Apr 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

openshift-ci-robot commented Apr 14, 2026 • edited by openshift-ci Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

ocpdocs-previewbot commented Apr 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

openshift-ci-robot commented Apr 15, 2026 • edited by openshift-ci Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

trepel left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

lahinson left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

openshift-ci Bot commented Apr 27, 2026

Uh oh!

trepel left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

trepel Apr 27, 2026

Choose a reason for hiding this comment

Uh oh!

ShaunaDiaz Apr 27, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

ShaunaDiaz commented Apr 14, 2026 •

edited

Loading

openshift-ci-robot commented Apr 14, 2026 •

edited by openshift-ci Bot

Loading

ocpdocs-previewbot commented Apr 14, 2026 •

edited

Loading

openshift-ci-robot commented Apr 15, 2026 •

edited by openshift-ci Bot

Loading