Configuring the MCP Stream Server

PeopleSoft delivers the MCP Stream Server with the PeopleTools environment. You can connect this server to an MCP-compatible LLM client to build your own AI solution.

Prerequisites

Before configuring an external LLM client for MCP Server integration, ensure that you have the PeopleSoft Application Service API details required to execute the intended use case. You must configure the OpenAPI specification details for getting the Application Service details, like the service URL, API endpoint, HTTP method, required parameters, and request-body information.

Starting the MCP Server

The PeopleSoft MCP Stream Server exposes tools that the client can discover and invoke to access PeopleSoft Application Services. Specify the MCP Stream Server settings in a response file to start the MCP Stream Server.

Follow these steps to start the MCP Stream Server:

1. Log in to the server via SSH as the psadm2 user, then change to the PS_HOME directory.

2. Create the following response file:

   /tmp/psft_mcp_stream_response.json

3. Use the following MCP configuration file to define your MCP Stream Server setup:

   {
     "openApiSpecsStreamServer": [],
     "genericConfig": {
       "fastMcpHost": "0.0.0.0",
       "fastMcpPort": 8002,
       "sslCertFile": ""
     }
   }

   For details about the MCP Stream Server configuration parameters and a configuration example, see the Configuration Parameters and Example for the MCP Stream Server section later in this topic.

4. Login as the psadm2 user and run the following command to start the server:

   nohup python "$PS_HOME/bin/ai_agent/psft_mcp_server_stream.py" --response-file /tmp/psft_mcp_stream_response.json > /tmp/psft_mcp_server_stream.out 2>&1 &

Configuration Parameters and Example for the MCP Stream Server

Use the following configuration parameters for configuring the MCP Stream Server.

Parameter	Description
openApiSpecsStreamServer	List of Application Service OpenAPI Specification Paths Supported by the MCP Server.
fastMcpHost	MCP stream server host.
fastMcpPort	Port number used for MCP stream server
sslCertFile	The certificate path that has to be used for Application Services.

This example illustrates a sample MCP server configuration file, where the administrator has defined the PeopleSoft search service for their MCP-enabled integration.

{
    "openApiSpecsStreamServer": [
        "/opt/oracle/psft/pt/tools/bin/ai_agent/config/psft_search_service.json",
        "/opt/oracle/psft/pt/tools/bin/ai_agent/config/psft_absence_service.json"
    ],
    "genericConfig": {
        "fastMcpHost": "0.0.0.0",
        "fastMcpPort": 8002,
        "sslCertFile": "/slot/ems4550/psft/pt/tools/bin/ai_agent/config/CAcert.pem"
    }
}

Connecting an External LLM Client to the PeopleSoft MCP Server

Follow these configuration steps to connect an MCP-compatible external LLM client, such as Codex or Cline, to the PeopleSoft MCP Stream Server:

• Add the PeopleSoft MCP Stream Server URL in the LLM client MCP Server configuration.
  Use the following sample PeopleSoft MCP Stream Server URL:

  http://<mcp_server_host>:<mcp_port>/mcp

• Generate PS_TOKEN for invoking Application Service APIs. The user must provide the Authentication ID, Authentication Password, and Authentication URL to the MCP Server, which uses these details to generate the PS_TOKEN. For example http://<pia_host_name>:<port_name>/psp/ps/?cmd=login
• Use this PS_TOKEN for executing the Application Service APIs.