Embedded API - MCPサーバー

これらのリソースを使用して、カスタマーワークスペース内のMCP（Model Context Protocol）サーバーをプログラムで管理します。

トークン認証とハッシュ化トークン認証

hashed_tokenは、トークンベースのMCPサーバーのデフォルト認証タイプです。 token 認証タイプはレガシーとして扱われます。 tokenを使用している既存のサーバーは引き続き動作しますが、新しいサーバーはhashed_tokenを使用します。 hashed_token サーバー上のトークンを管理するには、MCP hashed tokens を参照してください。

クイックリファレンス

タイプ	リソース	説明
GET	/api/managed_users/:managed_user_id/mcp_servers	顧客ワークスペース内のMCPサーバーを一覧表示します。
POST	/api/managed_users/:managed_user_id/mcp_servers	顧客ワークスペース内にMCPサーバーを作成します。
GET	/api/managed_users/:managed_user_id/mcp_servers/:handle	顧客ワークスペース内のMCPサーバーの詳細を取得します。
PUT	/api/managed_users/:managed_user_id/mcp_servers/:handle	顧客ワークスペース内のMCPサーバーを更新します。
DELETE	/api/managed_users/:managed_user_id/mcp_servers/:handle	顧客ワークスペース内のMCPサーバーを削除します。
POST	/api/managed_users/:managed_user_id/mcp_servers/:handle/token_renew	顧客ワークスペース内のMCPサーバー認証トークンを更新します。
POST	/api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/tokens	カスタマーワークスペースでハッシュトークンを作成します。
DELETE	/api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/tokens/:id	カスタマーワークスペースでハッシュトークンを削除します。
POST	/api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/tokens/:id/refresh	カスタマーワークスペースでハッシュトークンを更新します。
POST	/api/managed_users/:managed_user_id/mcp_servers/:handle/assign_tools	顧客ワークスペース内のMCPサーバーにツールを割り当てます。
POST	/api/managed_users/:managed_user_id/mcp_servers/:handle/assign_user_groups	顧客ワークスペース内のMCPサーバーにユーザーグループを割り当てます。
POST	/api/managed_users/:managed_user_id/mcp_servers/:handle/remove_user_groups	顧客ワークスペース内のMCPサーバーからユーザーグループを削除します。
PUT	/api/managed_users/:managed_user_id/mcp_servers/:handle/update_folder	顧客ワークスペース内のMCPサーバーを別のフォルダに移動します。
GET	/api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/server_policies	カスタマーワークスペース内のサーバーポリシー設定を取得します。
PUT	/api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/server_policies	カスタマーワークスペース内のサーバーポリシー設定を更新します。
GET	/api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/tools	顧客ワークスペース内のMCPサーバーのツールを一覧表示します。
PUT	/api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/tools/:id	カスタマーワークスペース内のツールの説明を更新します。
DELETE	/api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/tools/:id	顧客ワークスペース内のツールを削除します。
GET	/api/managed_users/:managed_user_id/user_groups	顧客ワークスペース内のIDプロバイダーユーザーグループを一覧表示します。
GET	/api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/access_assignments	顧客ワークスペース内の MCP アクセス割り当てを一覧表示します。
POST	/api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/access_assignments	顧客ワークスペース内で MCP アクセス割り当てを作成します。
GET	/api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/access_assignments/:id	顧客ワークスペース内の MCP アクセス割り当てを取得します。
PUT	/api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/access_assignments/:id	顧客ワークスペース内の MCP アクセス割り当てを更新します。
DELETE	/api/managed_users/:managed_user_id/mcp_servers/:managed_user_id/mcp_servers/:mcp_server_handle/access_assignments/:id	顧客ワークスペース内の MCP アクセス割り当てを削除します。

カスタマーワークスペース内のMCPサーバーのリスト表示

カスタマーワークスペース内のMCPサーバーのリストを返します。

GET https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers

URLパラメータ

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。

クエリパラメーター

名前	タイプ	説明
project_id	number optional	プロジェクトIDでフィルタリングします。
folder_id	number optional	フォルダIDでフィルタリングします。
authentication_method	string optional	認証方法でフィルタリングします。使用可能な値: `hashed_token`、`token`（レガシー）、`workato_idp`。
page	number optional	ページ番号。デフォルトは1です。
per_page	number optional	ページごとの項目数。最大値は50です。

サンプルリクエスト

shell

curl  -X GET 'https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers?folder_id=:folder_id' \
      -H 'Authorization: Bearer <api_token>'

サンプルレスポンス

json

{
    "data": [
        {
            "id": 1001,
            "name": "Sales Tools MCP Server",
            "description": "Provides CRM and deal management tools for AI clients",
            "folder_id": 27180380,
            "project_id": 13595198,
            "authentication_method": "hashed_token",
            "tools_count": 5
        },
        {
            "id": 1002,
            "name": "HR Automation Server",
            "description": "HR onboarding and employee management tools",
            "folder_id": 27180380,
            "project_id": 13595198,
            "authentication_method": "workato_idp",
            "tools_count": 3
        }
    ],
    "count": 2,
    "page": 1,
    "per_page": 50
}

カスタマーワークスペース内でのMCPサーバーの作成

カスタマーワークスペース内に新しいMCPサーバーを作成します。

POST https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers

URLパラメーター

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。

ペイロード

名前	タイプ	説明
name	string 必須	サーバー名。
folder_id	number 必須	MCPサーバーのフォルダID。
説明	string optional	サーバーの説明。
asset_id	number optional	APIコレクションID。プロジェクトアセットサーバーを作成する場合は省略します。
tools	array of objects optional	作成時にサーバーに割り当てるツール。各オブジェクトには`trigger_application`（string）と`id`（string）が必要です。 `workato_recipe_function`および`workato_api_platform`ツールを使用する場合、`id`は数値です。 `workato_genie`ツールを使用する場合、`id`は文字列ハンドルです。

デフォルトの認証タイプとしてのハッシュ化トークン

MCPサーバーは、別の認証タイプを指定しない限り、デフォルトのauth_typeとしてhashed_tokenを使用します。 hashed_token サーバー上のトークンを管理するには、MCP hashed tokens エンドポイントを使用します。

サンプルリクエスト

shell

curl  -X POST 'https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers' \
      -H 'Authorization: Bearer <api_token>' \
      -H 'Content-Type: application/json' \
      -d '{
            "name": ":name",
            "description": ":description",
            "folder_id": :folder_id,
            "tools": [
              {
                "trigger_application": ":trigger_application",
                "id": ":id"
              }
            ]
          }'

サンプルレスポンス

json

{
    "data": {
        "id": 1001,
        "name": "Sales Tools MCP Server",
        "description": "Provides CRM and deal management tools for AI clients",
        "asset_type": "api_collection",
        "logo_url": "https://www.workato.com/images/mcp-server-logo.png",
        "tools_count": 1,
        "mcp_url": "https://www.workato.com/mcp/servers/sales-tools-mcp-server?token=abc123xyz",
        "auth_type": "hashed_token",
        "idp_user_group_ids": [],
        "api_collection": null,
        "created_at": "2025-10-15T13:41:05.207-07:00",
        "updated_at": "2025-10-15T13:41:05.207-07:00"
    }
}

カスタマーワークスペース内のMCPサーバー詳細の取得

カスタマーワークスペース内の特定のMCPサーバーの詳細を取得します。

GET https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:handle

URLパラメーター

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。
handle	string 必須	MCPサーバーハンドル。使用するMCPサーバーを選択するときに AI Hub > Enterprise MCP > Custom servers に移動すると、URL内で `mcp_server_handle` を見つけることができます。例えば、URL が `https://app.workato.com/mcp/mcps-AxbxNxNz-wsB-SM/overview` の場合、MCPサーバーハンドルは `mcps-AxbxNxNz-wsB-SM` です。

サンプルリクエスト

shell

curl  -X GET 'https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:handle' \
      -H 'Authorization: Bearer <api_token>'

サンプルレスポンス

json

{
    "data": {
        "id": 1001,
        "name": "Sales Tools MCP Server",
        "description": "Provides CRM and deal management tools for AI clients",
        "asset_type": "api_collection",
        "logo_url": "https://www.workato.com/images/mcp-server-logo.png",
        "tools_count": 5,
        "mcp_url": "https://www.workato.com/mcp/servers/sales-tools-mcp-server?token=abc123xyz",
        "auth_type": "hashed_token",
        "idp_user_group_ids": [],
        "api_collection": null,
        "created_at": "2025-10-15T13:41:05.207-07:00",
        "updated_at": "2025-10-16T09:22:11.100-07:00"
    }
}

カスタマーワークスペース内のMCPサーバーの更新

カスタマーワークスペース内の既存のMCPサーバーを更新します。

PUT https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:handle

URLパラメーター

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。
handle	string 必須	MCPサーバーハンドル。使用するMCPサーバーを選択するときに AI Hub > Enterprise MCP > Custom servers に移動すると、URL内で `mcp_server_handle` を見つけることができます。例えば、URL が `https://app.workato.com/mcp/mcps-AxbxNxNz-wsB-SM/overview` の場合、MCPサーバーハンドルは `mcps-AxbxNxNz-wsB-SM` です。

ペイロード

名前	タイプ	説明
name	string optional	サーバー名。
説明	string optional	サーバーの説明。
auth_type	string optional	認証タイプ。使用可能な値: `hashed_token`、`token`（レガシー）、`workato_idp`。
idp_user_group_ids	array of strings optional	サーバーにアクセスできるIDプロバイダーユーザーグループID。 `auth_type`が`workato_idp`の場合にのみ適用されます。
folder_id	number optional	サーバーの移動先フォルダID。

サンプルリクエスト

shell

curl  -X PUT 'https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:handle' \
      -H 'Authorization: Bearer <api_token>' \
      -H 'Content-Type: application/json' \
      -d '{
            "name": ":name",
            "description": ":description",
            "auth_type": ":auth_type"
          }'

サンプルレスポンス

json

{
    "data": {
        "id": 1001,
        "name": "Sales & CRM Tools MCP Server",
        "description": "Provides CRM, deal management, and pipeline tools for AI clients",
        "asset_type": "api_collection",
        "logo_url": "https://www.workato.com/images/mcp-server-logo.png",
        "tools_count": 5,
        "mcp_url": "https://www.workato.com/mcp/servers/sales-tools-mcp-server?token=abc123xyz",
        "auth_type": "hashed_token",
        "idp_user_group_ids": [],
        "api_collection": null,
        "created_at": "2025-10-15T13:41:05.207-07:00",
        "updated_at": "2025-10-17T11:05:33.812-07:00"
    }
}

カスタマーワークスペース内のMCPサーバーの削除

カスタマーワークスペース内のMCPサーバーを削除します。

DELETE https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:handle

URLパラメーター

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。
handle	string 必須	MCPサーバーハンドル。使用するMCPサーバーを選択するときに AI Hub > Enterprise MCP > Custom servers に移動すると、URL内で `mcp_server_handle` を見つけることができます。例えば、URL が `https://app.workato.com/mcp/mcps-AxbxNxNz-wsB-SM/overview` の場合、MCPサーバーハンドルは `mcps-AxbxNxNz-wsB-SM` です。

サンプルリクエスト

shell

curl  -X DELETE 'https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:handle' \
      -H 'Authorization: Bearer <api_token>'

サンプルレスポンス

成功時に204 No Contentを返します。

カスタマーワークスペース内のMCPサーバー認証トークンの更新

カスタマーワークスペース内のMCPサーバー用の新しい認証トークンを生成し、以前のトークンを無効にします。セキュリティイベント後、または定期的な認証情報ローテーションポリシーの一環として、認証情報をローテーションするためにこのエンドポイントを使用します。

レガシーエンドポイント

このエンドポイントは、単一のサーバーレベルのトークンを持つレガシーtoken認証タイプを使用するサーバーに適用されます。 hashed_token サーバーについては、個別の名前付きトークンプロファイルを操作する Refresh a hashed token in a customer workspace を使用してください。

POST https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:handle/token_renew

URLパラメーター

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。
handle	string 必須	MCPサーバーハンドル。使用するMCPサーバーを選択するときに AI Hub > Enterprise MCP > Custom servers に移動すると、URL内で `handle` を見つけることができます。例えば、URL が `https://app.workato.com/mcp/mcps-AxbxNxNz-wsB-SM/overview` の場合、MCPサーバーハンドルは `mcps-AxbxNxNz-wsB-SM` です。

サンプルリクエスト

shell

curl  -X POST 'https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:handle/token_renew' \
      -H 'Authorization: Bearer <api_token>'

サンプルレスポンス

更新されたトークンを含む新しいmcp_urlを持つ、更新済みのMCPサーバーオブジェクトを返します。

json

{
    "data": {
        "id": 1001,
        "name": "Sales & CRM Tools MCP Server",
        "description": "Provides CRM, deal management, and pipeline tools for AI clients",
        "asset_type": "api_collection",
        "logo_url": "https://www.workato.com/images/mcp-server-logo.png",
        "tools_count": 5,
        "mcp_url": "https://www.workato.com/mcp/servers/sales-tools-mcp-server?token=newtoken789",
        "auth_type": "token",
        "idp_user_group_ids": [],
        "api_collection": null,
        "created_at": "2025-10-15T13:41:05.207-07:00",
        "updated_at": "2025-10-18T08:00:00.000-07:00"
    }
}

MCPハッシュ化トークン

MCP hashed token エンドポイントは、カスタマーワークスペース内で auth_type が hashed_token の MCP サーバーに対し、個別の名前付きトークンプロファイルを管理します。これは、トークンの更新を通じて単一のサーバーレベルトークンのみをサポートするレガシーな token 認証タイプを拡張するものです。 hashed_tokenは、サーバーごとに最大50個の名前付きで個別に取り消し可能なトークンプロファイルをサポートします。

カスタマーワークスペースでハッシュトークンを作成

カスタマーワークスペース内で、auth_type が hashed_token のサーバー用トークンプロファイルを作成します。

MCPサーバーは、最大50個のアクティブなハッシュ化トークンをサポートします。

POST https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/tokens

URL パラメーター

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。
mcp_server_handle	string 必須	MCPサーバーハンドル。使用するMCPサーバーを選択するときに AI Hub > Enterprise MCP > Custom servers に移動すると、URL内で `mcp_server_handle` を見つけることができます。例えば、URL が `https://app.workato.com/mcp/mcps-AxbxNxNz-wsB-SM/overview` の場合、MCPサーバーハンドルは `mcps-AxbxNxNz-wsB-SM` です。

ペイロード

名前	タイプ	説明
name	string 必須	トークンプロファイル名。空白不可、100文字以下、かつサーバーのアクティブなトークン内で大文字と小文字を区別せずに一意である必要があります。

追加の制約

このエンドポイントはhashed_tokenサーバーでのみ使用できます。このエンドポイントをtokenまたはworkato_idpサーバーで呼び出すとエラーが返されます。

サンプルリクエスト

shell

curl  -X POST 'https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/tokens' \
      -H 'Authorization: Bearer <api_token>' \
      -H 'Content-Type: application/json' \
      -d '{
            "name": ":name"
          }'

サンプルレスポンス

dataの下にネストされるのではなく、レスポンスルートにトークンプロファイルを含む201 Createdを返します。

json

{
    "id": 731,
    "name": "Production token",
    "auth_type": "hashed_token",
    "created_at": "2026-07-10T10:00:00.000Z",
    "created_by": {
        "id": 42,
        "full_name": "Example User"
    },
    "token_first_symbols": "abc",
    "token_last_symbols": "wxyz",
    "plain_token": "<plain_token>"
}

プレーンテキストトークンは一度だけ表示されます

plain_tokenは作成時にのみ返され、後で取得することはできません。トークンを安全に保存してください。必要に応じて新しいトークンを生成するには、refresh the token エンドポイントを使用できます。

カスタマーワークスペースでハッシュトークンを削除

ハッシュ化トークンを削除しても、データベースからは削除されません。ハッシュ化トークンプロファイルは非アクティブとしてマークされます。トークンは直ちに機能しなくなり、MCPリクエストの認証に使用できなくなります。

DELETE https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/tokens/:id

URL パラメーター

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。
mcp_server_handle	string 必須	MCPサーバーハンドル。使用するMCPサーバーを選択するときに AI Hub > Enterprise MCP > Custom servers に移動すると、URL内で `mcp_server_handle` を見つけることができます。例えば、URL が `https://app.workato.com/mcp/mcps-AxbxNxNz-wsB-SM/overview` の場合、MCPサーバーハンドルは `mcps-AxbxNxNz-wsB-SM` です。
id	number 必須	トークンプロファイルID。

サンプルリクエスト

shell

curl  -X DELETE 'https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/tokens/:id' \
      -H 'Authorization: Bearer <api_token>'

サンプルレスポンス

空のレスポンス本文で200 OKを返します。

このエンドポイントはhashed_tokenサーバーでのみ使用できます。削除されたプロファイルは、サーバーのmcp_profiles配列に表示されなくなります。

カスタマーワークスペースでハッシュトークンを更新

プロファイルの現在のトークン値を無効化し、新しいプレーンテキストトークンを返します。

POST https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/tokens/:id/refresh

URL パラメーター

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。
mcp_server_handle	string 必須	MCPサーバーハンドル。使用するMCPサーバーを選択するときに AI Hub > Enterprise MCP > Custom servers に移動すると、URL内で `mcp_server_handle` を見つけることができます。例えば、URL が `https://app.workato.com/mcp/mcps-AxbxNxNz-wsB-SM/overview` の場合、MCPサーバーハンドルは `mcps-AxbxNxNz-wsB-SM` です。
id	number 必須	アクティブなトークンプロファイルID。

サンプルリクエスト

shell

curl  -X POST 'https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/tokens/:id/refresh' \
      -H 'Authorization: Bearer <api_token>'

サンプルレスポンス

200 OKを返します。レスポンスのルートレベルの構造は token creation と同じであり、plain_token、token_first_symbols、token_last_symbols を含みます。

json

{
    "id": 731,
    "name": "Production token",
    "auth_type": "hashed_token",
    "created_at": "2026-07-10T10:00:00.000Z",
    "created_by": {
        "id": 42,
        "full_name": "Example User"
    },
    "token_first_symbols": "def",
    "token_last_symbols": "uvwx",
    "plain_token": "<new_plain_token>"
}

このエンドポイントはhashed_tokenサーバーでのみ使用できます。返されたplain_tokenは、このレスポンスでのみ公開されます。トークンを安全に保存してください。後から取得することはできません。

カスタマーワークスペース内のMCPサーバーへのツールの割り当て

カスタマーワークスペース内のMCPサーバーに1つ以上のツールを割り当てます。サーバーにすでに割り当てられているツールは重複されません。

POST https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:handle/assign_tools

URLパラメーター

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。
handle	string 必須	MCPサーバーハンドル。使用するMCPサーバーを選択するときに AI Hub > Enterprise MCP > Custom servers に移動すると、URL内で `handle` を見つけることができます。例えば、URL が `https://app.workato.com/mcp/mcps-AxbxNxNz-wsB-SM/overview` の場合、MCPサーバーハンドルは `mcps-AxbxNxNz-wsB-SM` です。

ペイロード

名前	タイプ	説明
tools	オブジェクトの配列必須	割り当てるツール。各オブジェクトには`trigger_application`（string）と`id`（string）が必要です。

サンプルリクエスト

shell

curl  -X POST 'https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:handle/assign_tools' \
      -H 'Authorization: Bearer <api_token>' \
      -H 'Content-Type: application/json' \
      -d '{
            "tools": [
              {
                "trigger_application": ":trigger_application_1",
                "id": ":id_1"
              },
              {
                "trigger_application": ":trigger_application_2",
                "id": ":id_2"
              }
            ]
          }'

サンプルレスポンス

更新済みのMCPサーバーオブジェクトを返します。

json

{
    "data": {
        "id": 1001,
        "name": "Sales & CRM Tools MCP Server",
        "description": "Provides CRM, deal management, and pipeline tools for AI clients",
        "asset_type": "api_collection",
        "logo_url": "https://www.workato.com/images/mcp-server-logo.png",
        "tools_count": 7,
        "mcp_url": "https://www.workato.com/mcp/servers/sales-tools-mcp-server?token=newtoken789",
        "auth_type": "hashed_token",
        "idp_user_group_ids": [],
        "api_collection": null,
        "created_at": "2025-10-15T13:41:05.207-07:00",
        "updated_at": "2025-10-18T09:15:22.000-07:00"
    }
}

カスタマーワークスペース内のMCPサーバーへのユーザーグループの割り当て

カスタマーワークスペース内のMCPサーバーにIDプロバイダーのユーザーグループを割り当てます。サーバーのauth_typeがworkato_idpの場合にのみ適用されます。

POST https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:handle/assign_user_groups

URLパラメーター

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。
handle	string 必須	MCPサーバーハンドル。使用するMCPサーバーを選択するときに AI Hub > Enterprise MCP > Custom servers に移動すると、URL内で `handle` を見つけることができます。例えば、URL が `https://app.workato.com/mcp/mcps-AxbxNxNz-wsB-SM/overview` の場合、MCPサーバーハンドルは `mcps-AxbxNxNz-wsB-SM` です。

ペイロード

名前	タイプ	説明
idp_user_group_ids	文字列の配列必須	追加するユーザーグループのID。

サンプルリクエスト

shell

curl  -X POST 'https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:handle/assign_user_groups' \
      -H 'Authorization: Bearer <api_token>' \
      -H 'Content-Type: application/json' \
      -d '{
            "idp_user_group_ids": [":idp_user_group_ids_1", ":idp_user_group_ids_2"]
          }'

サンプルレスポンス

割り当てられたユーザーグループIDがidp_user_group_idsに反映された、更新済みのMCPサーバーオブジェクトを返します。

json

{
    "data": {
        "id": 1002,
        "name": "HR Automation Server",
        "description": "HR onboarding and employee management tools",
        "asset_type": "project_asset",
        "logo_url": "https://www.workato.com/images/mcp-server-logo.png",
        "tools_count": 3,
        "mcp_url": "https://www.workato.com/mcp/servers/hr-automation-server?token=hrtoken456",
        "auth_type": "workato_idp",
        "idp_user_group_ids": ["group-abc123", "group-def456"],
        "api_collection": null,
        "created_at": "2025-10-15T10:00:00.000-07:00",
        "updated_at": "2025-10-18T10:30:00.000-07:00"
    }
}

カスタマーワークスペース内のMCPサーバーからのユーザーグループの削除

カスタマーワークスペース内のMCPサーバーからIDプロバイダーのユーザーグループを削除します。

POST https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:handle/remove_user_groups

URLパラメーター

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。
handle	string 必須	MCPサーバーハンドル。使用するMCPサーバーを選択するときに AI Hub > Enterprise MCP > Custom servers に移動すると、URL内で `handle` を見つけることができます。例えば、URL が `https://app.workato.com/mcp/mcps-AxbxNxNz-wsB-SM/overview` の場合、MCPサーバーハンドルは `mcps-AxbxNxNz-wsB-SM` です。

ペイロード

名前	タイプ	説明
idp_user_group_ids	文字列の配列必須	削除するユーザーグループのID。

サンプルリクエスト

shell

curl  -X POST 'https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:handle/remove_user_groups' \
      -H 'Authorization: Bearer <api_token>' \
      -H 'Content-Type: application/json' \
      -d '{
            "idp_user_group_ids": [":idp_user_group_ids"]
          }'

サンプルレスポンス

指定されたグループがidp_user_group_idsから削除された、更新済みのMCPサーバーオブジェクトを返します。

json

{
    "data": {
        "id": 1002,
        "name": "HR Automation Server",
        "description": "HR onboarding and employee management tools",
        "asset_type": "project_asset",
        "logo_url": "https://www.workato.com/images/mcp-server-logo.png",
        "tools_count": 3,
        "mcp_url": "https://www.workato.com/mcp/servers/hr-automation-server?token=hrtoken456",
        "auth_type": "workato_idp",
        "idp_user_group_ids": ["group-def456"],
        "api_collection": null,
        "created_at": "2025-10-15T10:00:00.000-07:00",
        "updated_at": "2025-10-18T11:00:00.000-07:00"
    }
}

カスタマーワークスペース内のMCPサーバーの別フォルダへの移動

カスタマーワークスペース内のMCPサーバーを指定したフォルダに移動します。

PUT https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:handle/update_folder

URLパラメーター

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。
handle	string 必須	MCPサーバーハンドル。使用するMCPサーバーを選択するときに AI Hub > Enterprise MCP > Custom servers に移動すると、URL内で `handle` を見つけることができます。例えば、URL が `https://app.workato.com/mcp/mcps-AxbxNxNz-wsB-SM/overview` の場合、MCPサーバーハンドルは `mcps-AxbxNxNz-wsB-SM` です。

ペイロード

名前	タイプ	説明
folder_id	number 必須	移動先フォルダID。

サンプルリクエスト

shell

curl  -X PUT 'https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:handle/update_folder' \
      -H 'Authorization: Bearer <api_token>' \
      -H 'Content-Type: application/json' \
      -d '{
            "folder_id": :folder_id
          }'

サンプルレスポンス

新しいフォルダを反映した、更新済みのMCPサーバーオブジェクトを返します。

json

{
    "data": {
        "id": 1002,
        "name": "HR Automation Server",
        "description": "HR onboarding and employee management tools",
        "asset_type": "project_asset",
        "logo_url": "https://www.workato.com/images/mcp-server-logo.png",
        "tools_count": 3,
        "mcp_url": "https://www.workato.com/mcp/servers/hr-automation-server?token=hrtoken456",
        "auth_type": "workato_idp",
        "idp_user_group_ids": ["group-def456"],
        "api_collection": null,
        "created_at": "2025-10-15T10:00:00.000-07:00",
        "updated_at": "2025-10-18T12:00:00.000-07:00"
    }
}

カスタマーワークスペース内のサーバーポリシー設定の取得

MCPサーバーのセキュリティポリシー設定を取得します。これには、レート制限、利用状況の上限、Classless Inter-Domain Routing（CIDR）、およびIPアドレスが含まれます。

GET https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/server_policies

URLパラメーター

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。
mcp_server_handle	string 必須	MCPサーバーハンドル。使用するMCPサーバーを選択するときに AI Hub > Enterprise MCP > Custom servers に移動すると、URL内で `mcp_server_handle` を見つけることができます。例えば、URL が `https://app.workato.com/mcp/mcps-AxbxNxNz-wsB-SM/overview` の場合、MCPサーバーハンドルは `mcps-AxbxNxNz-wsB-SM` です。

サンプルリクエスト

shell

curl  -X GET 'https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/server_policies' \
      -H 'Authorization: Bearer <api_token>'

サンプルレスポンス

json

{
    "id": 501,
    "mcp_server_id": 1001,
    "rate_limits": {
        "per_minute": 60
    },
    "quota_limits": {
        "per_day": 10000
    },
    "ip_allow_list": ["203.0.113.0/24"],
    "ip_deny_list": [],
    "created_at": "2025-10-15T13:41:05.207-07:00",
    "updated_at": "2025-10-16T09:22:11.100-07:00"
}

カスタマーワークスペース内のサーバーポリシー設定の更新

カスタマーワークスペース内のMCPサーバーのセキュリティポリシー設定を更新します。

PUT https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/server_policies

URLパラメーター

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。
mcp_server_handle	string 必須	MCPサーバーハンドル。使用するMCPサーバーを選択するときに AI Hub > Enterprise MCP > Custom servers に移動すると、URL内で `mcp_server_handle` を見つけることができます。例えば、URL が `https://app.workato.com/mcp/mcps-AxbxNxNz-wsB-SM/overview` の場合、MCPサーバーハンドルは `mcps-AxbxNxNz-wsB-SM` です。

ペイロード

名前	タイプ	説明
mcp_server_policy	object required	ポリシー設定オブジェクト。
mcp_server_policy[rate_limits]	object optional	レート制限設定。
mcp_server_policy[quota_limits]	object optional	クォータ制限の設定。
mcp_server_policy[ip_allow_list]	array of strings optional	許可するIPアドレスまたはCIDR範囲。
mcp_server_policy[ip_deny_list]	array of strings optional	拒否するIPアドレスまたはCIDR範囲。

サンプルリクエスト

shell

curl  -X PUT 'https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/server_policies' \
      -H 'Authorization: Bearer <api_token>' \
      -H 'Content-Type: application/json' \
      -d '{
            "mcp_server_policy": {
              "rate_limits": { "per_minute": :per_minute },
              "quota_limits": { "per_day": :per_day },
              "ip_allow_list": [":ip_allow_list_1", ":ip_allow_list_2"],
              "ip_deny_list": []
            }
          }'

サンプルレスポンス

json

{
    "id": 501,
    "mcp_server_id": 1001,
    "rate_limits": {
        "per_minute": 30
    },
    "quota_limits": {
        "per_day": 5000
    },
    "ip_allow_list": ["203.0.113.0/24", "198.51.100.42"],
    "ip_deny_list": [],
    "created_at": "2025-10-15T13:41:05.207-07:00",
    "updated_at": "2025-10-18T14:00:00.000-07:00"
}

カスタマーワークスペース内のMCPサーバーのツールのリスト表示

カスタマーワークスペース内のMCPサーバーに割り当てられたツールのページ分割されたリストを返します。

GET https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/tools

URLパラメーター

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。
mcp_server_handle	string 必須	MCPサーバーハンドル。使用するMCPサーバーを選択するときに AI Hub > Enterprise MCP > Custom servers に移動すると、URL内で `mcp_server_handle` を見つけることができます。例えば、URL が `https://app.workato.com/mcp/mcps-AxbxNxNz-wsB-SM/overview` の場合、MCPサーバーハンドルは `mcps-AxbxNxNz-wsB-SM` です。

クエリパラメーター

名前	タイプ	説明
vua_required	boolean optional	VUA（Verified User Authentication）が必要かどうかでフィルタリングします。
search	string optional	ツールを名前でフィルタリングする検索語句。
page	number optional	ページ番号。デフォルトは1です。
per_page	number optional	ページごとの項目数。デフォルトは100です。最大は100です。

サンプルリクエスト

shell

curl  -X GET 'https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/tools' \
      -H 'Authorization: Bearer <api_token>'

サンプルレスポンス

json

{
    "data": [
        {
            "id": 3001,
            "name": "Create Salesforce Lead",
            "description": "Creates a new lead record in Salesforce CRM",
            "trigger_application": "workato_api_platform",
            "action_applications": ["salesforce"],
            "flow_id": 66870001,
            "vua_required": false
        },
        {
            "id": 3002,
            "name": "Send Deal Notification",
            "description": "Sends a Slack notification when a deal stage changes",
            "trigger_application": "workato_recipe_function",
            "action_applications": ["slack"],
            "flow_id": 66870002,
            "vua_required": true
        }
    ],
    "count": 2,
    "page": 1,
    "per_page": 100
}

カスタマーワークスペース内のツールの説明の更新

カスタマーワークスペース内のMCPサーバー内にあるツールの説明を更新します。基盤となるレシピやAPIエンドポイントに影響を与えずに、AIクライアントに表示される説明を変更します。

PUT https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/tools/:id

URLパラメーター

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。
mcp_server_handle	string 必須	MCPサーバーハンドル。使用するMCPサーバーを選択するときに AI Hub > Enterprise MCP > Custom servers に移動すると、URL内で `mcp_server_handle` を見つけることができます。例えば、URL が `https://app.workato.com/mcp/mcps-AxbxNxNz-wsB-SM/overview` の場合、MCPサーバーハンドルは `mcps-AxbxNxNz-wsB-SM` です。
id	number 必須	ツールID。

ペイロード

名前	タイプ	説明
説明	string optional	ツールの新しい説明。

サンプルリクエスト

shell

curl  -X PUT 'https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/tools/:id' \
      -H 'Authorization: Bearer <api_token>' \
      -H 'Content-Type: application/json' \
      -d '{
            "description": ":description"
          }'

サンプルレスポンス

json

{
    "id": 3001,
    "name": "Create Salesforce Lead",
    "description": "Creates a new lead record in Salesforce CRM with name, email, and company details",
    "trigger_application": "workato_api_platform",
    "action_applications": ["salesforce"],
    "flow_id": 66870001,
    "vua_required": false
}

カスタマーワークスペース内のツールの削除

カスタマーワークスペース内のMCPサーバーからツールを削除します。

APIエンドポイントは削除できません

レシピ関数またはGenieエージェントに基づくツールのみ削除できます。 APIエンドポイントツールを削除しようとすると、400 Bad Requestエラーが返されます。

DELETE https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/tools/:id

URLパラメーター

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。
mcp_server_handle	string 必須	MCPサーバーハンドル。使用するMCPサーバーを選択するときに AI Hub > Enterprise MCP > Custom servers に移動すると、URL内で `mcp_server_handle` を見つけることができます。例えば、URL が `https://app.workato.com/mcp/mcps-AxbxNxNz-wsB-SM/overview` の場合、MCPサーバーハンドルは `mcps-AxbxNxNz-wsB-SM` です。
id	number 必須	ツールID。

サンプルリクエスト

shell

curl  -X DELETE 'https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/tools/:id' \
      -H 'Authorization: Bearer <api_token>'

サンプルレスポンス

成功時に204 No Contentを返します。

カスタマーワークスペース内のIDプロバイダーユーザーグループのリスト表示

カスタマーワークスペースで利用可能なIDプロバイダーのユーザーグループのページ分割されたリストを返します。 workato_idp認証を使用するMCPサーバーにアクセス権を割り当てる場合は、このレスポンスのグループIDを使用します。

これはコラボレーターグループのリソースではありません

このエンドポイントのユーザーグループは、RBACのコラボレーターグループではありません。コラボレーターグループを管理するには、/api/v2/managed_users/:managed_user_id/user_groupsエンドポイントを使用します。

GET https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/user_groups

URLパラメーター

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。

クエリパラメーター

名前	タイプ	説明
page	number optional	ページ番号。デフォルトは1です。
per_page	number optional	ページごとの項目数。デフォルトは100です。最大は100です。

サンプルリクエスト

shell

curl  -X GET 'https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/user_groups' \
      -H 'Authorization: Bearer <api_token>'

サンプルレスポンス

json

{
    "data": [
        {
            "id": "group-abc123",
            "name": "Sales Team",
            "users_count": 24,
            "created_at": "2025-01-10T08:00:00.000Z",
            "updated_at": "2025-09-15T12:30:00.000Z"
        },
        {
            "id": "group-def456",
            "name": "HR Admins",
            "users_count": 6,
            "created_at": "2025-01-10T08:00:00.000Z",
            "updated_at": "2025-08-20T10:00:00.000Z"
        }
    ],
    "count": 2,
    "page": 1,
    "per_page": 100
}

MCPアクセス割り当て

MCP アクセス割り当ては、顧客ワークスペース内の MCP サーバーに対するツールレベルのロールベースアクセス制御（RBAC）を制御します。各割り当ては、アイデンティティプロバイダーのユーザーまたはユーザーグループに対し、サーバー上のすべてのツール、または特定のツールセットへのアクセスを付与します。

要件と制限

アクセス割り当ては、auth_type に workato_idp を使用するMCPサーバーでのみ動作します。
アクセス割り当ては、api_collection ベースのMCPサーバーでは動作しません。
アイデンティティは、サーバーごとに1件のアクセス割り当てしか持てません。

顧客ワークスペース内の MCP アクセス割り当ての一覧

顧客ワークスペース内のユーザーまたはユーザーグループに対する MCP サーバーアクセス割り当てのページ分割された一覧を返します。

必須権限: oem_mcp_access_assignments.index.

GET https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/access_assignments

URL パラメータ

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。
mcp_server_handle	string 必須	MCPサーバーハンドル。使用するMCPサーバーを選択するときに AI Hub > Enterprise MCP > Custom servers に移動すると、URL内で `mcp_server_handle` を見つけることができます。例えば、URL が `https://app.workato.com/mcp/mcps-AxbxNxNz-wsB-SM/overview` の場合、MCPサーバーハンドルは `mcps-AxbxNxNz-wsB-SM` です。

クエリパラメータ

名前	タイプ	説明
identity_type	string 必須	アイデンティティタイプ。許可される値: `user`、`user_group`。
search	string optional	アイデンティティ名を検索します。
order	string optional	アイデンティティ名でソートします。許可される値: `asc`、`desc`。デフォルトは`asc`です。
page	integer optional	正のページ番号。デフォルトは1です。
per_page	integer optional	ページ当たりの項目数, 1～100。デフォルトは100です。

サンプルリクエスト

shell

curl  -X GET 'https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/mcps-7Hk9pQ2r-aB3-1a/access_assignments?identity_type=user_group&page=1&per_page=100' \
      -H 'Authorization: Bearer <api_token>'

サンプルレスポンス

200 OKを返します。

json

{
    "data": [
        {
            "id": "mcpsaa-7Hk9pQ2s-aB3cD4-1a",
            "idp_user_id": null,
            "idp_user_group_id": "group-abc123",
            "all_tools": false,
            "tool_ids": [3001, 3002],
            "created_at": "2026-10-09T10:00:00.000Z",
            "updated_at": "2026-10-09T10:00:00.000Z"
        },
        {
            "id": "mcpsaa-7Hk9pQ2u-jK7mN8-1a",
            "idp_user_id": null,
            "idp_user_group_id": "group-def456",
            "all_tools": true,
            "tool_ids": [],
            "created_at": "2026-10-09T10:00:00.000Z",
            "updated_at": "2026-10-09T10:00:00.000Z"
        }
    ],
    "count": 2,
    "page": 1,
    "per_page": 100
}

この例では、グループへの割り当てを一覧表示しています。 identity_type が user の場合、各割り当てでは idp_user_id は文字列で、idp_user_group_id は null になります。どちらのアイデンティティフィールドもデフォルトで存在します。

顧客ワークスペース内で MCP アクセス割り当てを作成

顧客ワークスペース内の MCP サーバー上で、ユーザーまたはユーザーグループに対するアクセス割り当てを作成します。

必須権限: oem_mcp_access_assignments.create.

POST https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/access_assignments

URL パラメータ

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。
mcp_server_handle	string 必須	MCPサーバーハンドル。使用するMCPサーバーを選択するときに AI Hub > Enterprise MCP > Custom servers に移動すると、URL内で `mcp_server_handle` を見つけることができます。例えば、URL が `https://app.workato.com/mcp/mcps-AxbxNxNz-wsB-SM/overview` の場合、MCPサーバーハンドルは `mcps-AxbxNxNz-wsB-SM` です。

ペイロード

名前	タイプ	説明
idp_user_id	string conditional	空でないアイデンティティプロバイダーユーザーID。 `idp_user_id` と `idp_user_group_id` のうち、いずれか一方のみを指定します。
idp_user_group_id	string conditional	空でないアイデンティティプロバイダーユーザーグループID。 `idp_user_id` と `idp_user_group_id` のうち、いずれか一方のみを指定します。
all_tools	boolean optional	サーバー上のすべてのツールへのアクセスを付与します。デフォルトは`false`です。
tool_ids	整数の配列条件付き	`all_tools` が `false` または省略されている場合に必須で、かつ空であってはなりません。 `all_tools` が `true` の場合、このフィールドは省略するか、空の配列を送信します。すべてのIDはこのサーバーに属している必要があります。ツール ID を取得するには、List tools エンドポイントを使用します。

追加の制約

アイデンティティは対象Environment内で有効である必要があります。
アイデンティティは、サーバーごとに1件の割り当てしか持てません。
ツールIDは、そのサーバーのMCPツールレコードを指し、レシピIDやAPIエンドポイントIDではありません。

サンプルリクエスト

shell

curl  -X POST 'https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/mcps-7Hk9pQ2r-aB3-1a/access_assignments' \
      -H 'Authorization: Bearer <api_token>' \
      -H 'Content-Type: application/json' \
      -d '{
            "idp_user_group_id": "group-abc123",
            "all_tools": false,
            "tool_ids": [3001, 3002]
          }'

ユーザーにすべてのツールへのアクセスを付与するには、次のリクエストボディを使用します。

json

{
    "idp_user_id": "user-abc123",
    "all_tools": true
}

サンプルレスポンス

201 Created を返します。

json

{
    "data": {
        "id": "mcpsaa-7Hk9pQ2s-aB3cD4-1a",
        "idp_user_id": null,
        "idp_user_group_id": "group-abc123",
        "all_tools": false,
        "tool_ids": [3001, 3002],
        "created_at": "2026-10-09T10:00:00.000Z",
        "updated_at": "2026-10-09T10:00:00.000Z"
    }
}

割り当てIDはサーバー側で生成されます。ツールIDは重複排除され、ソートされます。

顧客ワークスペース内の MCP アクセス割り当てを取得

顧客ワークスペース内の MCP サーバーに属するアクセス割り当てを取得します。

必須権限: oem_mcp_access_assignments.show.

GET https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/access_assignments/:id

URL パラメータ

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。
mcp_server_handle	string 必須	MCPサーバーハンドル。使用するMCPサーバーを選択するときに AI Hub > Enterprise MCP > Custom servers に移動すると、URL内で `mcp_server_handle` を見つけることができます。例えば、URL が `https://app.workato.com/mcp/mcps-AxbxNxNz-wsB-SM/overview` の場合、MCPサーバーハンドルは `mcps-AxbxNxNz-wsB-SM` です。
id	string 必須	このサーバーに属するアクセス割り当てID。

このエンドポイントは、クエリパラメーターやボディパラメーターを受け付けません。

サンプルリクエスト

shell

curl  -X GET 'https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/mcps-7Hk9pQ2r-aB3-1a/access_assignments/mcpsaa-7Hk9pQ2s-aB3cD4-1a' \
      -H 'Authorization: Bearer <api_token>'

サンプルレスポンス

200 OKを返します。

json

{
    "data": {
        "id": "mcpsaa-7Hk9pQ2s-aB3cD4-1a",
        "idp_user_id": null,
        "idp_user_group_id": "group-abc123",
        "all_tools": false,
        "tool_ids": [3001, 3002],
        "created_at": "2026-10-09T10:00:00.000Z",
        "updated_at": "2026-10-09T10:00:00.000Z"
    }
}

ユーザー割り当ての場合、idp_user_id にユーザー ID が含まれ、idp_user_group_id は null になります。どちらのフィールドもデフォルトで存在します。すべてのツールを付与する割り当てでは、all_tools: true と tool_ids: [] になります。

顧客ワークスペース内の MCP アクセス割り当てを更新

顧客ワークスペース内の既存 MCP サーバーアクセス割り当てのツールアクセス範囲を置き換えます。

必須権限: oem_mcp_access_assignments.update.

PUT https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/access_assignments/:id

このパスは、同じ置換動作で PATCH も受け付けます。

URL パラメータ

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。
mcp_server_handle	string 必須	MCPサーバーハンドル。使用するMCPサーバーを選択するときに AI Hub > Enterprise MCP > Custom servers に移動すると、URL内で `mcp_server_handle` を見つけることができます。例えば、URL が `https://app.workato.com/mcp/mcps-AxbxNxNz-wsB-SM/overview` の場合、MCPサーバーハンドルは `mcps-AxbxNxNz-wsB-SM` です。
id	string 必須	このサーバーに属するアクセス割り当てID。

ペイロード

名前	タイプ	説明
all_tools	boolean optional	サーバー上のすべてのツールへのアクセスを付与します。省略された場合のデフォルトは `false` です。
tool_ids	整数の配列条件付き	`all_tools` が `false` または省略されている場合に必須で、かつ空であってはなりません。 `all_tools` が `true` の場合、このフィールドは省略するか、空の配列を送信します。すべてのIDはこのサーバーに属している必要があります。

更新はツールスコープ全体を置き換えます

all_tools と tool_ids のうち、少なくとも一方は指定します。省略されたフィールドは保持されません。 all_tools を省略した場合はデフォルトで false になり、tool_ids を省略した場合はデフォルトで空の配列になります。既存の割り当てでアイデンティティを変更することはできません。

サンプルリクエスト

shell

curl  -X PUT 'https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/mcps-7Hk9pQ2r-aB3-1a/access_assignments/mcpsaa-7Hk9pQ2s-aB3cD4-1a' \
      -H 'Authorization: Bearer <api_token>' \
      -H 'Content-Type: application/json' \
      -d '{
            "all_tools": false,
            "tool_ids": [3001]
          }'

すべてのツールを付与するには、{"all_tools": true} を送信します。その場合、レスポンスには all_tools: true と tool_ids: [] が含まれます。

サンプルレスポンス

200 OKを返します。

json

{
    "data": {
        "id": "mcpsaa-7Hk9pQ2s-aB3cD4-1a",
        "idp_user_id": null,
        "idp_user_group_id": "group-abc123",
        "all_tools": false,
        "tool_ids": [3001],
        "created_at": "2026-10-09T10:00:00.000Z",
        "updated_at": "2026-10-09T11:00:00.000Z"
    }
}

割り当てのアイデンティティと作成タイムスタンプは変更されません。

顧客ワークスペース内の MCP アクセス割り当てを削除

顧客ワークスペース内の MCP サーバーから、ユーザーまたはユーザーグループのアクセス割り当てを削除します。

必須権限: oem_mcp_access_assignments.destroy.

DELETE https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/:mcp_server_handle/access_assignments/:id

URL パラメータ

名前	タイプ	説明
managed_user_id	string 必須	Embedded顧客のアカウントIDまたはExternal ID。外部IDにはプレフィックス`E`が必要で、URLエンコードされている必要があります。例: `EA2300`。
mcp_server_handle	string 必須	MCPサーバーハンドル。使用するMCPサーバーを選択するときに AI Hub > Enterprise MCP > Custom servers に移動すると、URL内で `mcp_server_handle` を見つけることができます。例えば、URL が `https://app.workato.com/mcp/mcps-AxbxNxNz-wsB-SM/overview` の場合、MCPサーバーハンドルは `mcps-AxbxNxNz-wsB-SM` です。
id	string 必須	このサーバーに属するアクセス割り当てID。

このエンドポイントは、クエリパラメーターやボディパラメーターを受け付けません。

サンプルリクエスト

shell

curl  -X DELETE 'https://YOUR_DATA_CENTER/api/managed_users/:managed_user_id/mcp_servers/mcps-7Hk9pQ2r-aB3-1a/access_assignments/mcpsaa-7Hk9pQ2s-aB3cD4-1a' \
      -H 'Authorization: Bearer <api_token>'

サンプルレスポンス

成功すると 204 No Content を返し、レスポンスボディは空になります。

最終更新日:

Embedded API - MCPサーバー ​

クイックリファレンス ​

カスタマーワークスペース内のMCPサーバーのリスト表示 ​

URLパラメータ ​

クエリパラメーター ​

サンプルリクエスト ​

サンプルレスポンス ​

カスタマーワークスペース内でのMCPサーバーの作成 ​

URLパラメーター ​

ペイロード ​

サンプルリクエスト ​

サンプルレスポンス ​

カスタマーワークスペース内のMCPサーバー詳細の取得 ​

URLパラメーター ​

サンプルリクエスト ​

サンプルレスポンス ​

カスタマーワークスペース内のMCPサーバーの更新 ​

URLパラメーター ​

ペイロード ​

サンプルリクエスト ​

サンプルレスポンス ​

カスタマーワークスペース内のMCPサーバーの削除 ​

URLパラメーター ​

サンプルリクエスト ​

サンプルレスポンス ​

カスタマーワークスペース内のMCPサーバー認証トークンの更新 ​

URLパラメーター ​

サンプルリクエスト ​

サンプルレスポンス ​

MCPハッシュ化トークン ​

カスタマーワークスペースでハッシュトークンを作成 ​

URL パラメーター ​

ペイロード ​

追加の制約 ​

サンプルリクエスト ​

サンプルレスポンス ​

カスタマーワークスペースでハッシュトークンを削除 ​

URL パラメーター ​

サンプルリクエスト ​

サンプルレスポンス ​

カスタマーワークスペースでハッシュトークンを更新 ​

URL パラメーター ​

サンプルリクエスト ​

サンプルレスポンス ​

カスタマーワークスペース内のMCPサーバーへのツールの割り当て ​

URLパラメーター ​

ペイロード ​

サンプルリクエスト ​

サンプルレスポンス ​

カスタマーワークスペース内のMCPサーバーへのユーザーグループの割り当て ​

URLパラメーター ​

ペイロード ​

サンプルリクエスト ​

サンプルレスポンス ​

カスタマーワークスペース内のMCPサーバーからのユーザーグループの削除 ​

URLパラメーター ​

ペイロード ​

サンプルリクエスト ​

サンプルレスポンス ​

カスタマーワークスペース内のMCPサーバーの別フォルダへの移動 ​

URLパラメーター ​

ペイロード ​

サンプルリクエスト ​

サンプルレスポンス ​

カスタマーワークスペース内のサーバーポリシー設定の取得 ​

URLパラメーター ​

サンプルリクエスト ​

サンプルレスポンス ​

カスタマーワークスペース内のサーバーポリシー設定の更新 ​

URLパラメーター ​

ペイロード ​

サンプルリクエスト ​

サンプルレスポンス ​

カスタマーワークスペース内のMCPサーバーのツールのリスト表示 ​

URLパラメーター ​

クエリパラメーター ​

サンプルリクエスト ​

サンプルレスポンス ​

カスタマーワークスペース内のツールの説明の更新 ​

URLパラメーター ​

Embedded API - MCPサーバー

クイックリファレンス

カスタマーワークスペース内のMCPサーバーのリスト表示

URLパラメータ

クエリパラメーター

サンプルリクエスト

サンプルレスポンス

カスタマーワークスペース内でのMCPサーバーの作成

URLパラメーター

ペイロード

サンプルリクエスト

サンプルレスポンス

カスタマーワークスペース内のMCPサーバー詳細の取得

URLパラメーター

サンプルリクエスト

サンプルレスポンス

カスタマーワークスペース内のMCPサーバーの更新

URLパラメーター

ペイロード

サンプルリクエスト

サンプルレスポンス

カスタマーワークスペース内のMCPサーバーの削除

URLパラメーター

サンプルリクエスト

サンプルレスポンス

カスタマーワークスペース内のMCPサーバー認証トークンの更新

URLパラメーター

サンプルリクエスト

サンプルレスポンス

MCPハッシュ化トークン

カスタマーワークスペースでハッシュトークンを作成

URL パラメーター

ペイロード

追加の制約

サンプルリクエスト

サンプルレスポンス

カスタマーワークスペースでハッシュトークンを削除

URL パラメーター

サンプルリクエスト

サンプルレスポンス

カスタマーワークスペースでハッシュトークンを更新

URL パラメーター

サンプルリクエスト

サンプルレスポンス

カスタマーワークスペース内のMCPサーバーへのツールの割り当て

URLパラメーター

ペイロード

サンプルリクエスト

サンプルレスポンス

カスタマーワークスペース内のMCPサーバーへのユーザーグループの割り当て

URLパラメーター

ペイロード

サンプルリクエスト

サンプルレスポンス

カスタマーワークスペース内のMCPサーバーからのユーザーグループの削除

URLパラメーター

ペイロード

サンプルリクエスト

サンプルレスポンス

カスタマーワークスペース内のMCPサーバーの別フォルダへの移動

URLパラメーター

ペイロード

サンプルリクエスト

サンプルレスポンス

カスタマーワークスペース内のサーバーポリシー設定の取得

URLパラメーター

サンプルリクエスト

サンプルレスポンス

カスタマーワークスペース内のサーバーポリシー設定の更新

URLパラメーター

ペイロード

サンプルリクエスト

サンプルレスポンス

カスタマーワークスペース内のMCPサーバーのツールのリスト表示

URLパラメーター

クエリパラメーター

サンプルリクエスト

サンプルレスポンス

カスタマーワークスペース内のツールの説明の更新

URLパラメーター