Disclaimer: This component was first developed by Tiago Rodrigues for ODC platforms.

We just made the adaptation to be able to use it also on O11.

The MCP Server application is divided in two components: the MCP Server API and the OutSystems MCP Server Manager.

For more detailed information about this application and how to use it, check these videos:

https://youtu.be/i0519jioKRQ

https://youtu.be/bvgN2Kjfrbo

1. MCP Server API

The API is ready to be used upon configuration of a server on the management application.

Before using it, configure the Bearer Token for the Authentication in the Settings.

2. OutSystems MCP Server Manager

This application allows users to configure different OutSystems MCP servers and its capabilities.

To create a server:

• In the MCP Servers screen, go to Add MCP Server;
• In the MCP Server Detail screen, add the name, the version and some instructions (the purpose of the current server);
• Indicate the capabilities you want to expose with the server by ticking the checkboxes for Prompts, Resources and Tools.
• (note: the Allows SSE checkbox does not produce any direct effect since the SSE is currently not support in OutSystems)
• Add the respective Prompts, Resources and Tools in the capabilities Tabs below.

To add a tool:

• The tools capability is the only that cannot be fully configured by the user (in the management app). The setup of the tool is made in the application, but the call of the tool needs to be performed in the code.
• To create a tool, follow these steps:
  1. Create an API on the business application where the tool logic should exist.
  2. Give the API the standard name of "InternalMCP".
  3. Create a POST method for each tool, using the same name as the tool in the URI.
    3.1. Create an Request input of the desired structure (OS deals with the conversion from
    text to the structure.
    3.2. Always create the same structure for the Response output, following the same design
    as the Content structure of the MCP protocol defined here.
  4. In the MCP Server app, go to the Tool detail page and add the App Name and the API-key
  where the API was deployed.

To test the MCP Server:

• Anthropic (the author of MCP) created an Inspector application that connects to MCP Servers and allows to inspect the different capabilities (https://modelcontextprotocol.io/docs/tools/inspector).
• It is also possible to test the MCP Server in Postman. If you are interested in the Collection file with request examples, send an email to tiagorodrigues@hso.com.
• Test each MCP Server using Chat feature in OpenAI. In customizable Chats, it is possible to configure an MCP server and then test it with the chatbot.