MCP Server - Documentation (O11)

Stable version 1.0.2 (Compatible with OutSystems 11)

Uploaded

on 28 Aug (23 hours ago)

Mediaweb

5.0

(2 ratings)

Documentation

1.0.2

Quick Start

Full documentation available in the application
This page provides a quick overview. After installing the component, open the Documentation and Installation Guide pages inside the MCP Server application for detailed setup instructions, examples, schemas and client configuration.

1. Install

Install MCP Server (O11) from the Forge and publish the MCPServer and MCPServer_CS modules.

2. Create an MCP Server

Open the Server Manager and create your MCP Server.

From there, you can configure the tools and prompts that will be exposed to MCP clients.

3. Create your Tools

Expose your OutSystems logic through a REST API named:

InternalMCP

The REST method name must exactly match the Tool Name configured in the Server Manager.

4. Register the Tool

Configure the tool in the Server Manager with:

Tool name and description
Application/module name
Input Schema
API Key, when applicable

5. Connect your MCP Client

Use the Copy URL action in the Server Manager to get the MCP endpoint and connect it to a compatible client such as Claude, Codex or the MCP Inspector.

For the complete setup, implementation examples and validation steps, follow the Installation Guide and Documentation included with the application.

1.0.0

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.