Ce contenu n'est pas disponible dans la langue sélectionnée.
Chapter 10. Using the MCP server for Satellite
The MCP (Model Context Protocol) technology is designed for easier integration of AI applications. It is an open protocol that standardizes how AI applications integrate with data sources. Satellite provides an MCP server to enable integration with your MCP-compatible AI applications.
MCP server for Satellite is a Technology Preview feature only. Technology Preview features are not supported with Red Hat production service level agreements (SLAs) and might not be functionally complete. Red Hat does not recommend using them in production. These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process.
For more information about the support scope of Red Hat Technology Preview features, see Technology Preview Features Support Scope.
10.1. Overview of Satellite MCP integration Copier lienLien copié sur presse-papiers!
Satellite provides a container image that you can use to run an MCP server locally. The MCP server for Satellite is designed for advanced reporting and data analysis that leverages AI capabilities. You can use it to generate dynamic and comprehensive reports from your Satellite inventory.
By connecting your MCP client to the MCP server for Satellite, you can enable the client to extract and process this inventory information. You can query the AI application through the MCP client to obtain dynamic and comprehensive reports from your Satellite environment.
The MCP server for Satellite runs in read-only mode. It does not make changes to your Satellite inventory.
Additional resources
10.2. Generating reports by using the MCP server for Satellite Copier lienLien copié sur presse-papiers!
Deploy the MCP server for Satellite and connect it to your MCP client. Then, use your AI application to query your Satellite Server for reports on your environment.
In this scenario, the MCP server and MCP client run on the same system. Each user deploys their own MCP server and uses their credentials to authenticate.
10.2.1. Configuring the MCP server for Satellite Copier lienLien copié sur presse-papiers!
Deploy the MCP server for Satellite as a container and make it accessible to your MCP client.
Perform these steps on the same system where your MCP client will run.
Prerequisites
- You are logged in to the registry.redhat.io container registry.
-
The CA bundle for your Satellite is available on your system. You can download it from
https://satellite.example.com/unattended/public/foreman_raw_ca.
Procedure
Optional: Pull the latest version of the MCP container image from the registry:
podman pull registry.redhat.io/satellite/foreman-mcp-server-rhel9:latest
$ podman pull registry.redhat.io/satellite/foreman-mcp-server-rhel9:latestCopy to Clipboard Copied! Toggle word wrap Toggle overflow Run the container:
podman run --interactive --tty --publish 127.0.0.1:8080:8080 \ --volume Path_to_My_CA_Bundle:/app/ca.pem:ro,Z \ registry.redhat.io/satellite/foreman-mcp-server-rhel9:latest \ --foreman-url https://satellite.example.com
$ podman run --interactive --tty --publish 127.0.0.1:8080:8080 \ --volume Path_to_My_CA_Bundle:/app/ca.pem:ro,Z \ registry.redhat.io/satellite/foreman-mcp-server-rhel9:latest \ --foreman-url https://satellite.example.comCopy to Clipboard Copied! Toggle word wrap Toggle overflow The options used in the command include the following:
--publish- Maps port 8080 from inside the container to port 8080 on the host, binding the port to the localhost.
--volumeMounts your CA certificate bundle from the host machine to the default location (
ca.pem) inside the container.-
romakes the read-only mode inside the container -
Zrelabels the file with a private, unshared label
-
--Path_to_My_CA_Bundle- Specifies the location of the Satellite CA bundle on the system. This is required to verify the connection to Satellite.
10.2.2. Configuring the MCP client to connect to the MCP server Copier lienLien copié sur presse-papiers!
Connect your MCP client to the MCP server.
Perform these steps on the same system where you initiated the MCP server.
Prerequisites
- Your MCP client must support setting custom HTTP headers.
You have a personal access token (PAT).
NoteRed Hat recommends to set an expiration date for a PAT used to configure the MCP client.
Procedure
Configure your client to pass credentials in an HTTP authorization request header. The exact configuration steps depend on your MCP client.
For example, some clients require you to create a configuration file with the following contents:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Additional resources
10.2.3. Querying the MCP server for Satellite Copier lienLien copié sur presse-papiers!
Submit queries in natural language in your AI application. The application retrieves and processes the relevant data from the Satellite inventory.
Always review content generated by AI before using it in production.
Prerequisites
- You have configured the MCP server for Satellite.
- Your MCP client is connected to the MCP server for Satellite.
Procedure
Type a query into your AI application. For example:
Show a list of hosts that require patching.
Show a list of hosts that require patching.Copy to Clipboard Copied! Toggle word wrap Toggle overflow The AI application interprets the query and asks the MCP client to retrieve the relevant data from Satellite inventory through the MCP server. The MCP client fetches the data and returns it to the AI application, which then processes it to provide an answer to the user.
Example 10.1. Query examples
- Querying hosts
To obtain a list of hosts that require patching and refine it, you can use the following prompts:
Show a list of hosts that require patching on my Satellite.
Show a list of hosts that require patching on my Satellite.Copy to Clipboard Copied! Toggle word wrap Toggle overflow Categorize the list into hosts that require security patches and hosts that require bug fix patches.
Categorize the list into hosts that require security patches and hosts that require bug fix patches.Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Querying subnets
To obtain a report of all subnets in Satellite inventory, you can use the following prompts:
Generate a static report of all subnets on my Satellite. Read API documentation for each of the needed resources before doing any searches.
Generate a static report of all subnets on my Satellite. Read API documentation for each of the needed resources before doing any searches.Copy to Clipboard Copied! Toggle word wrap Toggle overflow For each subnet, report its name, address, network mask, and number of hosts which are assigned to it.
For each subnet, report its name, address, network mask, and number of hosts which are assigned to it.Copy to Clipboard Copied! Toggle word wrap Toggle overflow