OSDOCS-16078# MCP server for OCP (TP)#111327
Conversation
|
🤖 Thu May 21 14:02:20 - Prow CI generated the docs preview: https://111327--ocpdocs-pr.netlify.app/ |
34b97ff to
a36b672
Compare
b4933e0 to
cb887bc
Compare
| [role="_abstract"] | ||
| With MCP server for {product-title} installed, you can now prompt the Large Language Model (LLM) to learn more about your cluster. | ||
|
|
||
| // ???AI warning. Get legal blurb as an OCP snippet: https://docs.google.com/document/d/1eVk8pMiSTqjfQSwU_h21BBXJ5PN8jbSLcU0wBtUt7bs/edit?tab=t.0#heading=h.dyq1r89dkf3e??? |
There was a problem hiding this comment.
Looking to get some official (blessed by Legal) AI warning notice.
| [id="ai-app-mcp-server-ai-safety_{context}"] | ||
| = AI safety | ||
|
|
||
| // ???AI warning. Get legal blurb as an OCP snippet: https://docs.google.com/document/d/1eVk8pMiSTqjfQSwU_h21BBXJ5PN8jbSLcU0wBtUt7bs/edit?tab=t.0#heading=h.dyq1r89dkf3e??? |
There was a problem hiding this comment.
Same comment as above.
There was a problem hiding this comment.
+1 that we need to add the AI transparency notices. We may need guidance from Global Privacy or Legal to review for where these notices should be added.
|
Multiple files missing trailing newline:
|
| + | ||
| For information about how to install the MCP Gateway, see the _Red Hat Connectivity Link_ documentation, Section _Installing the MCP gateway_. | ||
| + | ||
| After installation, the controller automatically creates the HTTPRoute for gateway access. The MCP Gateway acts as a reverse proxy that aggregates multiple MCP servers into a single endpoint and provides a layer for authentication and rate limiting. |
There was a problem hiding this comment.
The HTTPRoute needs to be created manually /cc @Cali0707
like said in ai-app-mcp-server-configure-gateway.adoc
There was a problem hiding this comment.
@matzew Yes. And I believe that is covered in the following "Configure the MCP gateway" section. Is something else needed?
|
|
||
| * *Abstraction of complexity*: An MCP server hides the complicated parts of an integration. The LLM does not need to know how to write a SQL query or use a specific GitHub API. The server handles the code, the formatting, and the technical unique complexities, giving the LLM a clean, standardized result. | ||
|
|
||
| * *Execution and action*: Unlike the MCP Gateway, which just routes traffic, the Server is where the logic lives. When an AI decides to use a tool, the MCP server is the component that actually runs the Python script, queries the database, or calls the external API. |
|
|
||
| [id="ai-app-mcp-server-ai-safety-data-ownership_{context}"] | ||
| == Data ownership | ||
| The MCP server for Red Hat {product-title} does not store any information or state of the cluster. If you opt in, there are several telemetry metrics that are collected to understand the overall usage levels of the MCP server for Red Hat {product-title}: |
There was a problem hiding this comment.
@matzew Do we provide any mechanism for a user to disable / opt out for telemetry?
There was a problem hiding this comment.
telemetry of the server itself must be enabled. not done by default CC @nader-ziada
There was a problem hiding this comment.
Telemetry is disabled by default,
To enable it, you need to provide an OTLP endpoint via either:
Environment variable:
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317
Or TOML config:
[telemetry]
endpoint = "http://localhost:4317"
Setting the endpoint auto-enables telemetry. You can also explicitly control it with enabled = true/false in the [telemetry] section, which takes precedence over auto-detection.
There was a problem hiding this comment.
@julienlim The section explicitly states that you have to opt in for telmetry, so you do not need to disable/opt out in the default setup. Do you want me to provide info on how to opt in?
f50f278 to
4b1ef61
Compare
|
@matzew Not sure why you think I need the newline char?. It's not needed for publishing. Some other reason we need it? |
| ---- | ||
| $ helm upgrade -i -n openshift-mcp-server --create-namespace openshift-mcp-server \ | ||
| openshift-helm-charts/redhat-openshift-mcp-server \ | ||
| --set config.toolsets={core,helm,kubevirt} \ |
There was a problem hiding this comment.
@matzew should these be changed to core,openshift or as a placeholder like <hostname> and add further explanations below?
|
@lpettyjo: all tests passed! Full PR test history. Your PR dashboard. DetailsInstructions 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. |
Version(s): 4.22+
Issue: https://redhat.atlassian.net/browse/OSDOCS-16078
Link to docs preview: https://111327--ocpdocs-pr.netlify.app/openshift-enterprise/latest/ai_applications/mcp_server/mcp-server-overview.html
QE review:
Additional information:
PTAL: @mwerner2113, @gauravsingh85, @matzew, @Cali0707, @Kaustubh-pande, @lberk @CMurr