-
Notifications
You must be signed in to change notification settings - Fork 55
RHDHPAI-1087: MCP plugin doc - dev preview #1462
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Conversation
|
Updated preview: https://redhat-developer.github.io/red-hat-developers-documentation-rhdh/pr-1462/ @ 10/31/25 08:16:57 |
...les/model-context-protocol-tools/proc-configuring-mcp-clients-to-access-the-rhdh-server.adoc
Outdated
Show resolved
Hide resolved
...les/model-context-protocol-tools/proc-configuring-mcp-clients-to-access-the-rhdh-server.adoc
Outdated
Show resolved
Hide resolved
...les/model-context-protocol-tools/proc-configuring-mcp-clients-to-access-the-rhdh-server.adoc
Outdated
Show resolved
Hide resolved
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Just a couple small suggestions
modules/model-context-protocol-tools/con-understanding-model-context-protocol.adoc
Outdated
Show resolved
Hide resolved
modules/model-context-protocol-tools/proc-configuring-model-context-protocol.adoc
Show resolved
Hide resolved
modules/model-context-protocol-tools/proc-installing-the-mcp-server-and-tool-plugins.adoc
Outdated
Show resolved
Hide resolved
modules/model-context-protocol-tools/proc-verifying-successful-installation-of-mcp-plugins.adoc
Outdated
Show resolved
Hide resolved
modules/model-context-protocol-tools/proc-installing-the-mcp-server-and-tool-plugins.adoc
Outdated
Show resolved
Hide resolved
modules/model-context-protocol-tools/proc-configuring-model-context-protocol.adoc
Outdated
Show resolved
Hide resolved
modules/model-context-protocol-tools/proc-configuring-model-context-protocol.adoc
Show resolved
Hide resolved
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I used the following images and followed this documentation to successfully connect the mcp server to the cursor client.
plugins:
- package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-plugin-mcp-actions-backend:bs_1.42.5__0.1.2!backstage-plugin-mcp-actions-backend
disabled: false
- package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-software-catalog-mcp-tool:bs_1.42.5__0.2.3!red-hat-developer-hub-backstage-plugin-software-catalog-mcp-tool
disabled: false
- package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-techdocs-mcp-tool:bs_1.42.5__0.3.0!red-hat-developer-hub-backstage-plugin-techdocs-mcp-tool
disabled: false
MCP server connected in Cursor client:
Chat with tool calling:
...les/model-context-protocol-tools/proc-configuring-mcp-clients-to-access-the-rhdh-server.adoc
Outdated
Show resolved
Hide resolved
...les/model-context-protocol-tools/proc-configuring-mcp-clients-to-access-the-rhdh-server.adoc
Outdated
Show resolved
Hide resolved
5547c42 to
89a7b66
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Doc changes look good to me
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM!
89a7b66 to
e03a62e
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
|
|
||
| .Procedure | ||
|
|
||
| . Verify the authentication token. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Could we add a small section to this step (verify the authentication token).
Set this token as the bearer token in your MCP client could we also specify "ensure the authorization header in the configuration specifies Bearer before the token. E.g. Bearer <mcp-token>"`
(or something to that effect)
|
|
||
| If your MCP client connects to the server but cannot find deployed tools, an authentication or configuration issue is likely. | ||
|
|
||
| .Procedure |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Could we add an additional verification step here?
Something like: Verify app config changes:
"Verify that there are no duplicate backend entries in the app config and that indentation is accurate. The changes to configure the static token and mcp plugin sources should go under an existing backend field, if present. If there's confusion, consult the sample app config provided in proc-configuring-model-context-protocol_{context}"]"
IMPORTANT: Do Not Merge - To be merged by Docs Team Only
Version(s):
1.8.0, main
Issue:
RHDHPAI-1087
Preview:
https://redhat-developer.github.io/red-hat-developers-documentation-rhdh/pr-1462/model-context-protocol-tools/