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.

Important

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

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

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

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

  1. Optional: Pull the latest version of the MCP container image from the registry:

    $ podman pull registry.redhat.io/satellite/foreman-mcp-server-rhel9:latest
    Copy to Clipboard Toggle word wrap
  2. 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
    Copy to Clipboard Toggle word wrap

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

    Mounts your CA certificate bundle from the host machine to the default location (ca.pem) inside the container.

    • ro makes the read-only mode inside the container
    • Z relabels 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.

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

    Note

    Red 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:

    "my-mcp-server": {
    	"url": "http://localhost:8080/mcp/sse",
    	"type": "http",
    	"headers": {
    		"FOREMAN_USERNAME": "My_Username",
    		"FOREMAN_TOKEN": "My_PAT"
    	}
    }
    Copy to Clipboard Toggle word wrap

10.2.3. Querying the MCP server for Satellite

Submit queries in natural language in your AI application. The application retrieves and processes the relevant data from the Satellite inventory.

Warning

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.
    Copy to Clipboard Toggle word wrap

    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.
Copy to Clipboard Toggle word wrap
Categorize the list into hosts that require security patches
and hosts that require bug fix patches.
Copy to Clipboard Toggle word wrap
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.
Copy to Clipboard Toggle word wrap
For each subnet, report its name, address, network mask,
and number of hosts which are assigned to it.
Copy to Clipboard Toggle word wrap
Retour au début
Red Hat logoGithubredditYoutubeTwitter

Apprendre

Essayez, achetez et vendez

Communautés

À propos de la documentation Red Hat

Nous aidons les utilisateurs de Red Hat à innover et à atteindre leurs objectifs grâce à nos produits et services avec un contenu auquel ils peuvent faire confiance. Découvrez nos récentes mises à jour.

Rendre l’open source plus inclusif

Red Hat s'engage à remplacer le langage problématique dans notre code, notre documentation et nos propriétés Web. Pour plus de détails, consultez le Blog Red Hat.

À propos de Red Hat

Nous proposons des solutions renforcées qui facilitent le travail des entreprises sur plusieurs plates-formes et environnements, du centre de données central à la périphérie du réseau.

Theme

© 2025 Red Hat