Skip to content

OSDOCS-18936: adds MCP server registration to MCP gateway#109444

Merged
ShaunaDiaz merged 1 commit intoopenshift:mcp-gateway-docs-tpfrom
ShaunaDiaz:OSDOCS-18936
Apr 14, 2026
Merged

OSDOCS-18936: adds MCP server registration to MCP gateway#109444
ShaunaDiaz merged 1 commit intoopenshift:mcp-gateway-docs-tpfrom
ShaunaDiaz:OSDOCS-18936

Conversation

@ShaunaDiaz
Copy link
Copy Markdown
Contributor

@ShaunaDiaz ShaunaDiaz commented Apr 1, 2026

Version:
mcp-gateway-docs-tp

Issue:
https://redhat.atlassian.net/browse/OSDOCS-18936

Link to docs preview:
https://109444--ocpdocs-pr.netlify.app/rhcl/latest/mcp_gateway_config/mcp-gateway-register-on-prem-mcp-servers.html

QE review:

  • SME approved this change.
  • QE approved this change.
    NOTE: this PR is just for on-prem/vanilla mcp server

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.

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

openshift-ci-robot commented Apr 1, 2026

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

Details

In response to this:

mcp-gateway-docs-tp

Issue:

Link to docs preview:

QE review:

  • QE has approved this change.

Additional information:
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-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.

@openshift-ci-robot
Copy link
Copy Markdown

openshift-ci-robot commented Apr 1, 2026

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

Details

In response to this:

Version:
mcp-gateway-docs-tp

Issue:

Link to docs preview:

QE review:

  • QE has approved this change.

Additional information:
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-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.

@openshift-ci openshift-ci Bot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label Apr 1, 2026
@openshift-ci-robot
Copy link
Copy Markdown

openshift-ci-robot commented Apr 1, 2026

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

Details

In response to this:

Version:
mcp-gateway-docs-tp

Issue:
https://redhat.atlassian.net/browse/OSDOCS-18936

Link to docs preview:

QE review:

  • QE has approved this change.

Additional information:
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-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
Copy link
Copy Markdown

ocpdocs-previewbot commented Apr 1, 2026

@ShaunaDiaz ShaunaDiaz changed the title OSDOCS-18936: adds listener and route config MCP gateway [WIP] OSDOCS-18936: adds listener and route config MCP gateway Apr 1, 2026
@openshift-ci openshift-ci Bot added the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Apr 1, 2026
@ShaunaDiaz ShaunaDiaz changed the title [WIP] OSDOCS-18936: adds listener and route config MCP gateway [WIP] OSDOCS-18936: adds MCP server registration to MCP gateway Apr 1, 2026
Comment thread modules/ref-mcp-gateway-mcpserverregistation-crd.adoc Outdated
@openshift-ci-robot
Copy link
Copy Markdown

openshift-ci-robot commented Apr 2, 2026

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

Details

In response to this:

Version:
mcp-gateway-docs-tp

Issue:
https://redhat.atlassian.net/browse/OSDOCS-18936

Link to docs preview:
https://109444--ocpdocs-pr.netlify.app/rhcl/latest/mcp_gateway_config/mcp-gateway-register-servers.html

QE review:

  • QE has approved this change.

Additional information:
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-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.

@openshift-ci-robot
Copy link
Copy Markdown

openshift-ci-robot commented Apr 2, 2026

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

Details

In response to this:

Version:
mcp-gateway-docs-tp

Issue:
https://redhat.atlassian.net/browse/OSDOCS-18936

Link to docs preview:
https://109444--ocpdocs-pr.netlify.app/rhcl/latest/mcp_gateway_config/mcp-gateway-register-servers.html

QE review:

  • QE has approved this change.
    NOTE: this PR is just for on-prem/vanilla mcp server

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-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.

@ShaunaDiaz ShaunaDiaz changed the title [WIP] OSDOCS-18936: adds MCP server registration to MCP gateway OSDOCS-18936: adds MCP server registration to MCP gateway Apr 2, 2026
@openshift-ci 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 2, 2026
@jasonmadigan
Copy link
Copy Markdown

👀

Comment thread modules/ref-mcp-gateway-mcpserverregistation-crd.adoc Outdated
Comment thread modules/proc-mcp-gateway-register-mcp-server.adoc Outdated
Comment thread modules/proc-mcp-gateway-register-mcp-server.adoc Outdated
Comment thread modules/proc-mcp-gateway-register-mcp-server.adoc Outdated
Comment thread modules/ref-mcp-gateway-mcpserverregistration-cr.adoc
Comment thread modules/proc-mcp-gateway-register-mcp-server.adoc Outdated
Comment thread modules/proc-mcp-gateway-register-mcp-server.adoc Outdated
Comment thread modules/proc-mcp-gateway-register-mcp-server.adoc Outdated
Comment thread modules/proc-mcp-gateway-register-mcp-server.adoc Outdated
Comment thread modules/ref-mcp-gateway-mcpserverregistation-crd.adoc Outdated
@openshift-ci-robot
Copy link
Copy Markdown

openshift-ci-robot commented Apr 7, 2026

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

Details

In response to this:

Version:
mcp-gateway-docs-tp

Issue:
https://redhat.atlassian.net/browse/OSDOCS-18936

Link to docs preview:

QE review:

  • QE has approved this change.
    NOTE: this PR is just for on-prem/vanilla mcp server

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-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.

@openshift-ci-robot
Copy link
Copy Markdown

openshift-ci-robot commented Apr 7, 2026

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

Details

In response to this:

Version:
mcp-gateway-docs-tp

Issue:
https://redhat.atlassian.net/browse/OSDOCS-18936

Link to docs preview:
https://109444--ocpdocs-pr.netlify.app/rhcl/latest/mcp_gateway_config/mcp-gateway-register-on-prem-mcp-servers.html

QE review:

  • QE has approved this change.
    NOTE: this PR is just for on-prem/vanilla mcp server

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-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.

@jasonmadigan
Copy link
Copy Markdown

looks good! only thing we may want to consider is incorporating credentialRef into the example?

@openshift-ci-robot
Copy link
Copy Markdown

openshift-ci-robot commented Apr 8, 2026

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

Details

In response to this:

Version:
mcp-gateway-docs-tp

Issue:
https://redhat.atlassian.net/browse/OSDOCS-18936

Link to docs preview:
https://109444--ocpdocs-pr.netlify.app/rhcl/latest/mcp_gateway_config/mcp-gateway-register-on-prem-mcp-servers.html

QE review:

  • SME approved this change.
  • QE approved this change.
    NOTE: this PR is just for on-prem/vanilla mcp server

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-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.

@ShaunaDiaz 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 8, 2026
@openshift-ci-robot
Copy link
Copy Markdown

openshift-ci-robot commented Apr 8, 2026

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

Details

In response to this:

Version:
mcp-gateway-docs-tp

Issue:
https://redhat.atlassian.net/browse/OSDOCS-18936

Link to docs preview:
https://109444--ocpdocs-pr.netlify.app/rhcl/latest/mcp_gateway_config/mcp-gateway-register-on-prem-mcp-servers.html

QE review:

  • SME approved this change.
  • QE approved this change.
    NOTE: this PR is just for on-prem/vanilla mcp server

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.

@ShaunaDiaz ShaunaDiaz removed the merge-review-needed Signifies that the merge review team needs to review this PR label Apr 9, 2026
Comment thread mcp_gateway_config/mcp-gateway-register-on-prem-mcp-servers.adoc Outdated
Comment thread modules/proc-mcp-gateway-register-mcp-server.adoc Outdated
Comment thread modules/proc-mcp-gateway-register-mcp-server.adoc Outdated
Comment thread modules/proc-mcp-gateway-register-mcp-server.adoc Outdated
Comment thread modules/proc-mcp-gateway-register-mcp-server.adoc
Comment thread modules/proc-mcp-gateway-register-mcp-server.adoc Outdated
Comment thread modules/proc-mcp-gateway-register-mcp-server.adoc Outdated
Comment thread modules/proc-mcp-gateway-register-mcp-server.adoc Outdated
Comment thread modules/proc-mcp-gateway-register-mcp-server.adoc
Comment thread modules/proc-mcp-gateway-register-mcp-server.adoc Outdated
Comment thread modules/proc-mcp-gateway-verify-mcp-server-registration.adoc
Comment thread modules/proc-mcp-gateway-verify-mcp-server-registration.adoc Outdated
Comment thread modules/ref-mcp-gateway-mcpserverregistration-crd.adoc Outdated
Comment thread modules/ref-mcp-gateway-mcpserverregistration-crd.adoc Outdated
Comment thread modules/proc-mcp-gateway-register-mcp-server.adoc Outdated
Comment thread mcp_gateway_config/mcp-gateway-register-on-prem-mcp-servers.adoc
@mburke5678
Copy link
Copy Markdown
Contributor

Looking good! I just had a few comments, mostly other thoughts on format/style and such.

@mburke5678 mburke5678 removed the merge-review-in-progress Signifies that the merge review team is reviewing this PR label Apr 9, 2026
@ShaunaDiaz ShaunaDiaz force-pushed the OSDOCS-18936 branch 3 times, most recently from ac252c8 to 7bf9af4 Compare April 10, 2026 11:25
Copy link
Copy Markdown

@trepel trepel left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A few small suggestions, other than that, looks good to me.

Comment thread modules/proc-mcp-gateway-register-mcp-server.adoc Outdated
Comment thread modules/proc-mcp-gateway-verify-mcp-server-registration.adoc Outdated
Comment thread modules/proc-mcp-gateway-verify-mcp-server-registration.adoc Outdated
----
$ curl -s -D /tmp/mcp_headers -X POST http://mcp.127-0-0-1.sslip.io:8001/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2025-06-18", "capabilities": {}, "clientInfo": {"name": "test-client", "version": "1.0.0"}}}'
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

replace 2025-06-18 with 2025-11-25, this was recently fixed in upstream guide: https://github.com/Kuadrant/mcp-gateway/blob/main/docs/guides/register-mcp-servers.md

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Which makes me think, is there any process for updating upstream guides based on feedback here? If not, maybe we should introduce one...probably best would be to have a skill and/or slash command for this, wdyt?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That's a great idea. No idea how we'd implement it, but I game to experiment.

Comment thread modules/proc-mcp-gateway-register-mcp-server.adoc Outdated
name: _<mcp_api_key_server_route>_
namespace: _<mcp_test>_
labels:
mcp-server: 'true'
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this label is not used at all. It should be removed from upstream docs too. @jasonmadigan am I correct on this?

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yea that label isn't used by our controller. should be removed.

@ShaunaDiaz ShaunaDiaz removed the do-not-merge/hold Indicates that a PR should not merge because someone has issued a /hold command. label Apr 13, 2026
@openshift-ci
Copy link
Copy Markdown

openshift-ci Bot commented Apr 13, 2026

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

Copy link
Copy Markdown

@trepel trepel left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

@openshift-ci-robot
Copy link
Copy Markdown

openshift-ci-robot commented Apr 14, 2026

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

Details

In response to this:

Version:
mcp-gateway-docs-tp

Issue:
https://redhat.atlassian.net/browse/OSDOCS-18936

Link to docs preview:
https://109444--ocpdocs-pr.netlify.app/rhcl/latest/mcp_gateway_config/mcp-gateway-register-on-prem-mcp-servers.html

QE review:

  • SME approved this change.
  • QE approved this change.
    NOTE: this PR is just for on-prem/vanilla mcp server

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.

@ShaunaDiaz ShaunaDiaz merged commit c0723ee into openshift:mcp-gateway-docs-tp Apr 14, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

jira/valid-reference Indicates that this PR references a valid Jira ticket of any type. size/L Denotes a PR that changes 100-499 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants