These instructions assume you have already signed up and activated your Outsystems Personal Edition.

Setup an MCP Host for ODC

Install your favorite MCP host

OutSystems also supports the following MCP hosts:

  • AWS Kiro
  • Claude Code
  • 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 AWS Kiro or Claude Code.

If you need more detaied instructions or help in setting up your coding agent, follow this link. For other MCP hosts, please follow the instructions on this link.

Log In to your Personal Edition

Open the Personal Edition home page and click the Start Building button. That will set up your Personal Edition environment and take you to it. Note the URL on top (e.g. personal-xxxxxxxx.outsystems.dev), as that is your tenant address. You will need it for your coding agent.

Launch your coding agent, start a new project if needed, and on the prompt paste the following:

$Read https://outsystems.com/mcp/outsystems-get-started.md and follow it.

Your coding agent will help you set it up interactively. You may be asked to perform some steps in your IDE to configure your coding agent's connection to OutSystems, add the integration manually, or authenticate depending on your tool of choice.

Building Your First App

After the setup, it may prompt you what you want to do next, and you may select Build a first app.

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

That app works for the sake of this campaign, and at the time of writing we have tested that it can be built within the free AWS Kiro token quota. You can build something else as long as it gets deployed and you can run it!

After you build the app, submit this form, send us the URL to the app for us to check, and select the AWS Certification you'd like to win and you'll be in the draw. You won't enter the draw without submitting this form for us to validate your entry.

Accessing the app

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.

Troubleshooting

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

Other things you can do with 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 your agent to create a new app if you haven't yet. Copy this prompt into the agent to create the tested, sample app (use the Copy button; you don’t need to expand it):

You might have to tell it 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.