These instructions assume you have an ODC server.

Setup

Install your favorite MCP host

OutSystems also supports the following MCP hosts:

  • Claude Code
  • AWS Kiro
  • Cursor
  • Any other MCP host that supports the MCP Streamable HTTP transport with OAuth connects to the same endpoint, without validated setup

All things being equal, we recommend you use Claude Code.

Connect MCP hosts to OutSystems MCP

If you are connecting with Claude Code, this should be enough to get you started (replace HOSTNAME with your server’s address, e.g. personal-d1djz5kp.outsystems.dev)

$claude plugin marketplace add OutSystems/outsystems-mcp
$claude plugin install outsystems@outsystems --config tenant_hostname=HOSTNAME
$claude mcp list

On your MCP list you should see something like:

plugin:outsystems:outsystems: https://personal-d1djz5kp.outsystems.dev/mcp (HTTP) - ! Needs authentication

If you need additional instructions, follow this link. For other MCP hosts, please follow the instructions on this link.

After the plugin is installed, run Claude and call /mcp to authenticate.

Using the MCP Server

Kicking the tires

Inside Claude you can start inquiring about your environment. Here are some example prompts for you to try:

❯What can I do with the MCP server?

This gives you some inspiration on what you can do with the OutSystems MCP server. If you are connected to a factory, there are already some cool things you can try to explore your tenant. If not, don’t worry, we’ll build an app next.

❯What apps do I have installed?

Lists the apps available on your tenant.

Creating an application

You can use Claude to create a new app. Copy this prompt into Claude (use the Copy button; you don’t need to expand it):

You might have to tell Claude to publish the app once it’s done, and answer additional questions as the several stages of the plan are executed.

Before you can access the app, you must give yourself the right permissions. Currently, none of the OutSystems MCP tools manage users or end-user roles, but you can learn how to do it by asking your MCP host:

❯Tell me how I can give permissions to my user to access the app. Also, tell me the URL of the app.

Feel free to keep iterating on the app, and ask for changes. For more details on creating a full application with OutSystems MCP, check this link.

Visualize the architecture of your app

Run the following command in your MCP Host. Replace the name of the app for any other app you might have running in your server.

❯Run the outsystems-app-architecture on the IT Help Desk app

This will create a diagram of your application, its dependencies, UI flows, the works.