Developer APIとEmbedded API MCPサーバー

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

Developer APIEmbedded API MCPサーバーを使用すると、Claude DesktopやCursorなどのAI搭載Developer EnvironmentからWorkatoワークスペースにプログラムでアクセスできます。 次の認証を使用してリモートMCPサーバーとして公開されるWorkato Developer APIとEmbedded APIで、アセットとプロジェクトをプログラムで管理できます。

  • Developer API: 標準のDeveloper APIトークン認証を使用します。
  • Embedded API: Embedded管理者ワークスペースで作成されたAPIトークンを使用します。

アセットの検査と変更、一括操作の実行、およびDevelopmentツールから直接Developer APIエンドポイントまたはEmbedded APIエンドポイントの呼び出しを行うことができます。 APIエンドポイントで構築されたMCPツールを使用すると、API呼び出しで認証ヘッダーを渡すこともできます。

機能の提供状況

MCPは、US、EU、AU、JP、SGデータセンターのすべてのユーザーが利用できます。 MCPサーバーはUS、EU、APACリージョンでホストされ、可能な限りデータレジデンシー要件を尊重します。 MCPはCNデータセンターのワークスペースでは利用できません。 これは現地の規制要件と、データ主権に対するWorkatoの取り組みを反映したものであり、当社のマルチテナントおよびVirtual Private Workato(VPW)オファリングに適用されます。

MCPの使用に関心がある場合、または追加情報が必要な場合は、カスタマーサクセス担当者にお問い合わせください。

MCPサーバーは、APIクライアントロールで構成されたすべてのDeveloper APIとEmbedded APIの権限およびプロジェクトスコープに従います。 つまり、ワークスペース管理者>APIクライアントでAPIクライアント設定を構成することで、特定のプロジェクトまたはエンドポイントへのアクセスを制限できます。

MCP URLとAPIトークンの統合

次の設定により、リモートMCPサーバーとローカルMCPサーバーの両方でDeveloper APIとEmbedded APIを管理できます。

json
"YOUR-API-REMOTE-NAME": {
      "url": "https://app.workato.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_TOKEN>"
      }
    }

Developer APIとEmbedded APIをMCPサーバーとして設定する

Developer APIエンドポイントまたはEmbedded APIエンドポイントをLLMでMCPサーバーとして使用するには、次の手順を完了します。

1

Workatoにサインインします。

2

ワークスペース管理者>APIクライアントに移動して、アクセスできるツールを定義するAPIクライアントロールを表示するか、使用する予定のツールでクライアントロールを作成します。 たとえば、LLMで使用する予定のツールである場合は、フォルダを一覧表示プロジェクトまたはフォルダを作成フォルダを更新を有効にします。

EMBEDDED APIクライアントとトークンの要件

MCPサーバーを通じてEmbedded APIを管理するには、Embedded管理者ワークスペースで作成されたトークンを使用する必要があります。

LLMツールの可用性はクライアントロールで定義されますLLMツールの可用性はクライアントロールで定義されます

3

APIクライアントトークンを取得するか、APIクライアントを作成し、生成されたAPIトークンをコピーして保存します。

4

APIクライアントロールで定義されたエンドポイントを使用するようにLLMを構成します。

MCPを通じてDeveloper APIとEmbedded APIを管理する

MCP JSONファイルを構成した後、APIクライアントロールで有効化されたDeveloper APIエンドポイントとEmbedded APIエンドポイントを管理できます。

LLMを通じてDeveloper APIまたはEmbedded APIのプロジェクトとアセットを管理するには、次の手順を完了します。

1

LLMで新しいチャットを開始し、プロンプトを入力します。

プロジェクトとアセット管理のプロンプト例

1

次のプロンプトを入力します。

plaintext

ワークスペースのアクティビティに基づいて、最大3つのタグを提案してください。

LLMからタグを作成LLMからタグを作成

2

提案を確認し、提案されたタグを作成するようLLMに依頼します。

3

ワークスペース管理者>Settings>タグに移動し、タグを管理をクリックして、LLMによって作成されたタグを表示します。

LLMによって作成されたタグLLMによって作成されたタグ

2

より自然な言語のプロンプトを使用して、プロジェクトとアセットを管理します。例:

  • Move folder 12345 to parent folder 67890.
  • List all folders in my Acme test project.
  • Start analyzing recipe health for recipe 68000123.
  • List all connections and group by active and inactive status.
  • List jobs from recipe 68000123.

API呼び出しで認証ヘッダーを渡す

Workatoレシピアクション内で、認証ヘッダーを使用してAPIを呼び出すことができます。 APIMコレクションベースのMCPサーバーでは、Workatoレシピ内でヘッダーX-Wkt-Ext-Authorizationデータピルを使用する必要があります。

API呼び出しで認証ヘッダーを渡すには、次の手順を完了します。

1

プロジェクトに移動し、Create > Recipeをクリックするか、C+Rを押します。

新しいレシピを作成新しいレシピを作成

2

Nameフィールドにレシピの名前を入力します。

3

Locationドロップダウンメニューを使用して、レシピを保存するプロジェクトを選択します。

4

ビルドを開始をクリックします。

レシピの構築を開始レシピの構築を開始

5

開始点を選択をクリックし、アプリからのトリガーを選択します。

6

Select an app and trigger eventをクリックします。

7

API platform by Workatoを検索して選択します。

8

新規APIリクエストトリガーを選択します。 このユースケースのNew API requestトリガーでは、コネクションを確立する必要はありません。

新規APIリクエストトリガー新規APIリクエストトリガー

9

次の手順を実行して、リクエストスキーマを設定します。

1

リクエストヘッダーセクションに移動し、ヘッダーを追加をクリックします。

2

Nameフィールドに次の名前を入力します。

bash
X-Wkt-Ext-Authorization
3

任意です。 Labelフィールドにヘッダーのわかりやすいラベルを指定します。

4

フィールドを追加をクリックします。 ヘッダー値は、New API requestステップ出力の下のデータピルとしてアクセスできるようになりました。

5
X-Wkt-Ext-AuthorizationStep 1データピルを、ヘッダー認証を渡す予定のフィールドにマッピングします。

ヘッダー認証データピルをマッピングX-Wkt-Ext-AuthorizationStep 1データピルをマッピング

6

変更を保存します。

10

AI Hub > MCP serversに移動し、前の手順で作成したレシピを使用するMCPサーバーを選択します。

11

Settings > End user accessに移動し、Access MethodToken-based accessに設定されていることを確認します。

12

wkt_tokenを含むDeveloper MCP Token URLをコピーします。

Developer MCP Token URLをコピーDeveloper MCP Token URLをコピー

13

リクエストスキーマセクションに戻り、+フィールドを追加をクリックします。

14

NameフィールドとLabelフィールドにdescriptionを入力します。

15

データ型ドロップダウンメニューを使用して、文字列を選択します。

16

任意ドロップダウンメニューを使用して、いいえを選択します。

17

Nest underドロップダウンメニューを使用してpayloadを選択します。

18

保存をクリックします。

19

リクエストスキーマセクションに戻り、+フィールドを追加をクリックします。

20

NameフィールドとLabelフィールドにtitleを入力します。

21

データ型ドロップダウンメニューを使用して、文字列を選択します。

22

任意ドロップダウンメニューを使用して、いいえを選択します。

23

Nest underドロップダウンメニューを使用してpayloadを選択します。

24

保存をクリックします。

リクエストスキーマリクエストスキーマ

制限事項

Workato Developer APIおよびEmbedded API MCPサーバーには、次の制限があります。

サポートされていないエンドポイント

次のDeveloper APIエンドポイントとEmbedded APIエンドポイントはサポートされていません。

Developer API

Embedded API

Last updated: