Connect an MCP client to AIRO Connect ​

Choose your client to view connection steps. This page covers shared prerequisites and configuration tasks.

Choose your client ​

Before you connect ​

You must have the following before you configure AIRO Connect:

  • A Workato account with AIRO access
  • Access to an MCP-compatible AI client, such as Claude Code, Claude Desktop, Cursor, ChatGPT, or Codex CLI

Some client configurations use npx. Install Node.js and add it to your PATH. Run node -v in your terminal to verify your installation.

API token authentication also requires a Workato API token. Refer to Create an API token for instructions.

Use OAuth 2.0 when you can sign in interactively in a browser. Use an API token for headless or configuration-driven connections. Refer to Choose an authentication method for a comparison of each method's access model.

WORKSPACE AND ENVIRONMENT SCOPE

OAuth 2.0 scopes each AIRO Connect connection to the Workato workspace and environment active in your browser session. Sign in to the target workspace and environment before you start authorization.

Claude Code, Claude Desktop, and Cursor cache the OAuth sign-in by server URL rather than by server name, so separate OAuth 2.0 entries to the same AIRO Connect URL share one sign-in and can't provide simultaneous access to more than one workspace or environment.

Find your AIRO Connect server URL ​

Use the server URL for the data center where your Workato workspace is hosted. Developer Sandbox workspaces use the trial URL.

Data centerAIRO Connect server URL
UShttps://app.workato.com/airo_mcp
EUhttps://app.eu.workato.com/airo_mcp
JPhttps://app.jp.workato.com/airo_mcp
SGhttps://app.sg.workato.com/airo_mcp
AUhttps://app.au.workato.com/airo_mcp
ILhttps://app.il.workato.com/airo_mcp
KRhttps://app.kr.workato.com/airo_mcp
UKhttps://app.uk.workato.com/airo_mcp
Developer Sandboxhttps://app.trial.workato.com/airo_mcp

AIRO Connect isn't available in the CN data center. Refer to feature availability in the China data center for more information.

VIRTUAL PRIVATE WORKATO (VPW) CUSTOMERS

This page provides general guidance for all Workato users. If you're a Virtual Private Workato (VPW) customer, refer to your private documentation for detailed configuration guidance specific to your instances.

Create an API token for AIRO Connect ​

Create an API token only if your client uses API token authentication.

API TOKENS HAVE ENVIRONMENT-WIDE ACCESS

API token connections act as the workspace owner within the API client's environment. The AIRO MCP Server permission on an API client role gives the token access to all AIRO Connect tools and projects in that environment. Other privileges assigned to the role, and the API client's project access settings, don't limit that access.

Use OAuth 2.0 when the connection should respect an individual user's permissions.

API TOKEN ENVIRONMENT SCOPE

Each API client belongs to one environment in workspaces with environments enabled. Create a separate API client and token for every environment you plan to connect.

Complete the following steps to create an API token for AIRO Connect:

1

Sign in to Workato.

2

Go to Workspace admin > API clients > Client roles.

3

Open an existing client role or create a client role.

4

Go to the Tools tab.

5

Select the AIRO MCP Server checkbox in the AIRO MCP tools section.

The AIRO MCP Server checkbox selected in the AIRO MCP tools section of a client roleSelect AIRO MCP Server on the Tools tab of the client role

6

Click Save changes.

7

Assign this client role to an existing API client, or select the role when you create a new API client.

8

Copy and securely store the API client token.

Last updated: