製品アップデートステータスページWorkato Academy
English
日本語
無料で開始
AIRO

AIRO MCPサーバー ​

このページは機械翻訳により提供されています。翻訳内容と英語版に相違がある場合は、英語版が優先されます。

AIRO MCPサーバーは、Claude Code、Claude Desktop、Cursor、ChatGPT、Codex CLIなどのMCP互換AIクライアントにWorkato AIROのプラットフォーム機能全体を公開します。これにより、自然言語を使用してAI Development Environmentから直接、レシピの構築、Geniesの管理、MCPサーバーの作成、およびData tablesスキーマの管理を行えます。

MCPサーバーとしてのAIROMCPサーバーとしてのAIRO

仕組み ​

AIRO MCPサーバーは、2つの認証方法をサポートしています。

  • OAuth 2.0：インタラクティブクライアントに推奨されます。初回接続時に、MCPクライアントによってブラウザーウィンドウが開きます。ウィンドウにはWorkatoの認可画面が表示され、クライアントが要求する権限が一覧表示されます。 Authorizeをクリックしてコネクションを完了します。設定手順については、OAuth 2.0を使用して接続するを参照してください。
  • APIトークン：ヘッドレスまたは設定駆動型のセットアップに推奨されます。 Workato APIトークンをベアラーヘッダーとして渡します。設定手順については、APIトークンを使用して接続するを参照してください。

サーバーは、次のカテゴリに整理されたツールを公開します。

カテゴリ実行できること
レシピステップレベルの操作、フィールドマッピング、条件、コネクションを含む、レシピの作成、編集、検索、管理
スキルとMCPレシピをスキルに変換し、MCPサーバーを作成または管理する
カスタムコネクターカスタムコネクタのConnector SDKコードを構築、編集、保存する
GenieとナレッジベースGenieの作成と設定、ナレッジベースの管理、ナレッジソースの割り当て
ブループリントとアセットブループリント、アセットマップ、アセットメタデータを操作する
データData tablesスキーマの作成と管理
ジョブとテストジョブ履歴を調査し、テストケースを管理する

利用可能なツールは、ワークスペースの機能と、コネクションが使用するアイデンティティによって異なります。

  • OAuth 2.0: サーバーは認証されたユーザーの権限を使用します。
  • API token: サーバーはワークスペース所有者のアイデンティティと権限を使用します。 APIクライアントロールの AIRO MCP Server 権限により、そのトークンはサーバーと、ワークスペース内で利用可能なすべてのツールにアクセスできます。ロールに割り当てられたその他の特権や、APIクライアントのプロジェクトアクセス設定は、ワークスペース内のツールやプロジェクトへのトークンのアクセスを制限しません。

活動監査ログは、AIRO MCPサーバーが実行したアクションを、OAuth 2.0コネクションの場合は認証済みユーザーに、APIトークンコネクションの場合はワークスペース所有者に「(via AIRO)」ラベル付きで帰属させます。

エージェントは docs_get ツールを呼び出して、手順書、ツールごとのガイド、および利用可能なツールのライブインデックスを取得します。特定のツールに関する情報が必要なときは、MCPクライアントに docs_get を呼び出すようプロンプトしてください。

前提条件 ​

AIRO MCPサーバーを設定する前に、次のものが必要です:

  • AIROアクセス権を持つWorkatoアカウント
  • Claude Code、Claude Desktop、Cursor、ChatGPT、Codex CLIなど、インストール済みのMCP互換クライアント

一部のMCPクライアント設定ではnpxを使用します。これらの設定では、Node.jsがインストールされ、PATHで使用可能になっている必要があります。ターミナルでnode -vを実行して、インストールを確認します。

APIトークン認証には、Workato APIトークンも必要です。手順については、APIトークンを生成するを参照してください。

データセンターサーバーURL ​

AIRO MCPサーバーURLは、Workatoワークスペースがホストされているデータセンターによって異なります。 Developer Sandboxワークスペースでは、常にトライアルURLが使用されます。ワークスペースリージョンに一致するサーバーURLを使用します。

データセンターAIRO MCPサーバー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 MCPサーバーはCNデータセンターでは使用できません。詳細については、中国データセンターでの機能の可用性を参照してください。

VIRTUAL PRIVATE WORKATO (VPW)のお客様

このページでは、すべてのWorkatoユーザー向けの一般的なガイダンスを提供します。 Virtual Private Workato (VPW)のお客様は、お客様のインスタンスに固有の詳細な設定ガイダンスについて、プライベートドキュメントを参照してください。

OAuth 2.0 を使用して接続 ​

次の手順を完了して、OAuth 2.0 を使用してAIRO MCPサーバーをMCPクライアントに接続します。

ワークスペースとEnvironmentのスコープ

OAuth 2.0は、各AIRO MCPサーバーコネクションを、ブラウザーセッションでアクティブになっているWorkatoワークスペースおよびEnvironmentにスコープします。認可を開始する前に、対象のワークスペースとEnvironmentにサインインします。別のワークスペースまたはEnvironmentに接続する場合は認可手順を繰り返すか、同時にアクセスする必要がある各ワークスペースおよびEnvironmentごとに個別のコネクションを作成します。

APIトークンを使用した接続 ​

APIトークン認証には、Workato APIトークンが必要です。

APIトークンはワークスペースへフルアクセス可能

APIトークンで認証するコネクションは、ワークスペース所有者のユーザー情報と権限でアクションを実行します。クライアントロールの AIRO MCP Server 権限により、サーバーと、ワークスペース内で利用可能なすべてのツールにアクセスできます。ロールのその他の特権やAPIクライアントのプロジェクトアクセス設定は適用されないため、MCPクライアントはワークスペース内のすべてのプロジェクトにアクセスできます。 MCPクライアントがアクセスできる範囲を制限するには、OAuth 2.0 を使用して接続します。

APIトークンを生成する ​

APIトークンを取得するには、次の手順を完了します:

1

Workatoにサインインします。

2

ワークスペース管理者＞APIクライアント＞クライアントロールに移動します。

3

既存のクライアントロールを開くか、クライアントロールを作成します。

4

Tools タブに移動します。

5

AIRO MCP tools セクションで AIRO MCP Server チェックボックスを選択します。

The AIRO MCP Server checkbox selected in the AIRO MCP tools section of a client roleクライアントロールの Tools タブで AIRO MCP Server を選択

6

変更を保存をクリックします。

7

このクライアントロールを既存のAPIクライアントに割り当てるか、新しいAPIクライアントを作成するときにロールを選択します。

8

APIクライアントトークンをコピーし、安全に保管します。

MCPクライアントの設定 ​

MCPクライアントに応じた手順を完了します:

複数のワークスペースまたはEnvironmentへの接続 ​

各コネクションのMCP構成に個別のサーバーエントリを追加することで、複数のWorkatoワークスペースまたはEnvironmentに接続できます。各エントリに一意のサーバー名とAPIトークンを使用します。

Environmentが有効なワークスペースでは、各APIクライアントが1つのEnvironmentに割り当てられます。そのAPIトークンは、そのEnvironmentでのみ機能します。

たとえば、次のClaude Desktop設定では、ご利用のデータセンターのURLを使用して、同じワークスペース内のDevelopment EnvironmentとプロダクションEnvironmentに接続します:

json
{
  "mcpServers": {
    "workato-airo-mcp-server-dev": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://YOUR_DATA_CENTER/airo_mcp",
        "--transport",
        "http-first",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <DEV_API_TOKEN>"
      }
    },
    "workato-airo-mcp-server-prod": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://YOUR_DATA_CENTER/airo_mcp",
        "--transport",
        "http-first",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <PROD_API_TOKEN>"
      }
    }
  }
}

たとえば、USデータセンターの場合、上記の両方のサーバーエントリのURLは https://app.workato.com/airo_mcp です。

その他のMCPクライアントでも同じ方法を使用します。各コネクションに対して、個別のサーバー名とトークンでセットアップ手順を繰り返します。

ユースケース ​

次の例は、AIRO MCPサーバーでの一般的なワークフローを示しています。

レシピを構築してテストする ​

AIROを使用して自然言語の説明から複数ステップのレシピを作成し、Development Environmentを離れずに保存してテストします。

Create a recipe that syncs new Salesforce opportunities to Jira issues.
Add an OpenAI step to summarize the opportunity before creating the Jira issue.
Save the recipe and show me the test cases.

ナレッジソースを使用してGenieを作成する ​

Genieをセットアップし、関連するナレッジベースに接続して、ドメイン固有の質問に回答できるようにします。

"Sales Intelligence"という新しいGenieを作成し、CRMナレッジベースを割り当てます。

MCPサーバーを構築する ​

ワークスペースアセットからMCPサーバーを作成し、他のAIクライアントがツールに接続できるようにします。

Build an MCP server called "Sales Tools" using the lead enrichment and deal scoring skills from the Sales Automation project.

ジョブの失敗を調査する ​

最近のジョブ履歴を調査して、プロダクションレシピのエラーを診断します。エージェントは job_list を呼び出して失敗したジョブを見つけ、次に job_get を呼び出してジョブのステータスを分析し、そのレシピに対する修正案を提案します。

List the last 10 jobs for recipe 1555928 and show me any errors.

Data tablesを管理 ​

Development Environmentを離れることなく、Data tablesを作成し、そのスキーマを定義します。

地域別の承認者しきい値を保存するData tablesを作成します。

カスタムコネクターの構築 ​

Workato SDKエディターではなく独自のDevelopment Environmentを使用して、プラットフォームコネクターとして利用できないAPI用のコネクターを構築します。

Build a connector for the National Weather Service API at https://www.weather.gov/documentation/services-web-api.
Add an action that retrieves active weather alerts for a state or territory.

保存とリリースの変更の仕組みを含む完全なワークフローについては、AIRO MCPを使用したカスタムコネクターの構築を参照してください。

最終更新日: