Alibaba Cloud OpenAPI MCP サーバーは、自然言語を使用してクラウドリソース API を呼び出すための標準化されたプロトコルを提供し、OAuth、静的 AccessKey 認証情報、RAM 権限管理を通じて安全なアクセスとチューニングを実現します。 - OpenAPI Explorer

Model Context Protocol (MCP) は、大規模言語モデル (LLM) が外部ツールやデータソースと連携できるようにする標準化されたプロトコルです。Alibaba Cloud OpenAPI MCP サーバーを使用すると、自然言語を使って Alibaba Cloud API を呼び出し、クラウドリソースを管理できます。

利用オプションの選択

エディションの選択

Alibaba Cloud OpenAPI MCP Server には、以下の 2 つのエディションがあります。

項目	Core edition	Custom edition
セットアップ速度	高速。コンソールにサインインすると、すぐにエンドポイントを取得できます。	中程度。サーバーを作成し、API を選択する必要があります。
API カバレッジ	すべての Alibaba Cloud OpenAPI をカバーします。	選択した API のみをカバーします。
API マッチング方法	LLM はセマンティック検索を使用して、自動的に API を検索して呼び出します。複数の API が類似した機能を持つ場合、より具体的なプロンプトが必要になることがあります。	選択した API がツールとして直接公開されるため、LLM は検索せずに呼び出すことができます。
チューニング機能	サポートされていません。	サポートされています。API の説明とパラメーターを変更できます。
サーバー数	アカウントごとに 1 つ。	異なるシナリオ向けに複数のサーバーを作成できます。
ユースケース	クイックスタート、探索的な操作、および複数の製品にまたがるワークフロー。	固定されたビジネスプロセス、明確な API 要件、およびチューニングが必要なシナリオ。

クイックスタートや複数のクラウド製品にまたがる操作には、Core edition を使用します。
特定の API を念頭に置いており、LLM に検索せずに直接呼び出させたい場合は、Custom edition を使用します。

認証方法の選択

エディションを選択した後、認証方法も選択する必要があります。OpenAPI MCP Server は、以下の 2 つの認証方法をサポートしています。

OAuth 認証 (対話型認証)：自動的にブラウザーにリダイレクトされ、サインインします。トークンの有効期限が切れた後、再度サインインする必要があります。
AccessKey 認証：1 回限りの事前チェックの後、静的認証情報を使用して接続します。ブラウザーは不要です。

項目	OAuth 認証	AccessKey 認証
ユースケース	ブラウザーでの操作を伴うデスクトップクライアント、日常的な開発、および探索的な操作。	ヘッドレスサーバー、CI/CD パイプライン、および無人 AI エージェント連携。
認可方法	ブラウザーリダイレクトによるユーザーのサインインと認可。	AccessKey は環境変数で渡されます。ブラウザーリダイレクトは不要です。
権限アイデンティティ	認可したユーザーのアイデンティティ。	AccessKey に関連付けられた RAM ユーザーのアイデンティティ。
セキュリティ	短期トークンにより、セキュリティが向上します。	長期の静的認証情報は、慎重なリスク管理が必要です。

前提条件

OpenAPI MCP Server を使用する前に、選択した認証方法に基づいて以下の準備を完了してください。

OAuth 認証

この方法は、ブラウザーインタラクションをサポートするデスクトップクライアントに適しています。権限はユーザーに紐付けられ、トークンは短期間有効で、セキュリティが高くなります。

Alibaba Cloud アカウントが必要です。RAM ユーザーを使用する場合は、必要な権限を付与してください。詳細については、「MCP サーバーを操作するための権限を RAM ユーザーに付与する」をご参照ください。
管理者アカウントを使用して RAM コンソール > [OAuth アプリケーション] > [サードパーティアプリケーション] ページにアクセスし、公式の OpenAPI MCP Server アプリケーションをインストールして割り当ててください。そうしないと、MCP サービスの OAuth 認可が失敗します。詳細については、「サードパーティアプリケーションのインストールと認可」をご参照ください。

静的認証情報認証

この方法は、CI/CD パイプライン、CLI 環境、AI エージェント統合など、ブラウザーインタラクションを伴わないシナリオに適しています。環境変数を通じて AccessKey (AK) 認証情報を渡すことに対応しています。ローカルで Alibaba Cloud CLI に既にサインインしている場合、MCP プロキシは自動的に既存の認証情報を再利用するため、追加の設定は不要です。

Python (>= 3.12) と uv がインストールされていること。
Alibaba Cloud アカウントを登録して AccessKey を作成し、その AccessKey に関連付けられている RAM ユーザーまたは RAM ロールに AliyunOpenAPIMCPServerStaticCredentialAccess システムポリシーがアタッチされている必要があります。 [RAM コンソール]に移動して、このポリシーを RAM ユーザーにアタッチできます。
初回使用前に、アカウントが認可済みであることを確認するため、事前チェックコマンドを実行する必要があります。この 1 回限りのチェックは、Alibaba Cloud アカウント全体に適用され、MCP サーバーを実行するマシンだけでなく、ブラウザーが利用可能な任意のデバイスで実行できます。 uvx alibabacloud.mcp-proxy@latest --server-url <MCP 接続 URL> pre-check --site-type INTL

MCP サーバーエンドポイント

クライアントの設定プロセスは、Core Edition と Custom Edition の両方で同じです。唯一の違いは、MCP サーバーエンドポイントの取得方法です。

Core Edition

サインイン後、システムは Core Edition 用の MCP サーバーエンドポイントを自動的に割り当て、組み込みのツールの組み合わせによってすべての Alibaba Cloud OpenAPI に対応します。

Alibaba Cloud OpenAPI MCP service コンソールにサインインします。
左側のナビゲーションペインで、[コア] タブをクリックします。ページには ストリーマブル HTTP エンドポイント と SSE エンドポイント が表示されます。
OAuth または詳細設定を変更するには、対応する [Modify] ボタンをクリックします。
- [マルチアカウント MCP]：マルチアカウントのシナリオで MCP サーバーを一元管理します。詳細については、「マルチアカウントのシナリオで OpenAPI MCP サーバーを使用する」をご参照ください。
- [パブリックアクセス]：パブリックアクセスを有効にすると、MCP サービスはパブリックネットワーク経由でアクセスできるようになります。この機能は、ローカルでの開発とデバッグ、リージョン間のコラボレーション、または外部システムとの連携に適しています。
- [カスタム VPC 許可リスト]: 厳格なネットワークセキュリティ要件があるシナリオに適しています。

Custom Edition

Custom Edition の場合、まず MCP サーバーを作成し、必要な API を選択する必要があります。選択した各 API は、ツールとして LLM に直接公開され、LLM はセマンティック検索なしで直接呼び出すことができます。

Alibaba Cloud OpenAPI MCP service コンソールにサインインします。
左側のナビゲーションペインで、[カスタム] > [作成] をクリックして MCP 設定ページを開きます。
次の情報を入力します。
- [名前]: 長さは 3～16 文字で、小文字、数字、アンダースコア (_)、ハイフン (-) のみ使用できます。たとえば、mcp-demo です。
- [ドキュメント言語]：ツール内の API の説明の言語を選択します。
- [OAuth 設定]：
  - [Alibaba Cloud 公式 OAuth]: TONGYI Lingma、Cherry Studio、Cursor などのローカルクライアント向けです。
  - [カスタム OAuth]：自己デプロイの Dify、AgentScope、Claude Web/Mobile などの自社構築プラットフォームまたはサードパーティサービスに適しています。
- [マルチアカウント MCP]: マルチアカウントシナリオで MCP サーバーを一元管理します。詳細については、「マルチアカウントシナリオで OpenAPI MCP サーバーを使用する」をご参照ください。
- [クラウド製品と API リスト]: MCP サービスの API ツールを設定します。
- [Terraform Tools] は、Terraform HCL コードを使用して MCP ツールを定義します。リソースの作成のみをサポートし、変更はサポートしません。詳細については、「OpenAPI MCP Server で Terraform Tools を使用する」をご参照ください。
- [システムツール]: 選択時に MCP サービスに自動的に統合される、公式の事前設定済みツールです。
- [MCP 指示]: LLM にこの MCP の使用方法を指示するプロンプトです。クライアントは MCP 標準プロトコルの Instructions フィールドをサポートする必要があります。
- [備考]: MCP サービスの説明を追加します。
[作成] をクリックし、リスク警告を確認します。サーバーが作成されると、ページに Streamable HTTP エンドポイント と SSE エンドポイント が表示されます。

説明

1 つの MCP サーバーで選択する API は 30 個以下にすることを推奨します。より多くの API を使用する必要がある場合は、複数の MCP サーバーを作成してください。

VPC 環境で MCP を使用する場合は、ページに表示される VPC エンドポイントを使用してください。

クライアント設定

サーバーエンドポイントを取得したら、クライアントで接続を設定します。この設定は Core Edition と Custom Edition の両方に適用されます。Alibaba Cloud OpenAPI MCP service コンソールには、Cherry Studio、TONGYI Lingma/Cursor/Windsurf/VSCode、Claude Code、Codex などの一般的なクライアント向けの組み込み設定テンプレートが用意されています。MCP は幅広い互換性があり、このプロトコルをサポートする他のクライアントやプログラムも同様に設定できます。

次の 2 つの認証方法がサポートされています：

OAuth 認証 (インタラクティブ認証)：認可のため、ブラウザーに自動的にリダイレクトされます。
静的認証情報認証：環境変数で渡される AccessKey、または Alibaba Cloud CLI の認証情報を使用します。

重要

AccessKey は長期的な静的認証情報です。漏洩した場合、永続的に悪用される可能性があります。AccessKey を使用する場合は、これらのセキュリティプラクティスに従う必要があります。詳細については、「AccessKey の作成」をご参照ください。

Alibaba Cloud アカウントの AccessKey は使用しないでください。代わりに、必要最小限の権限のみを持つ RAM ユーザーの AccessKey を使用してください。
バージョン管理されたファイル (mcp.json など) に AccessKey をハードコードしないでください。環境変数またはキー管理サービスを介して注入することを推奨します。
認証情報の漏えいリスクを低減するため、AccessKey を定期的にローテーションすることを推奨します。

OAuth 認証 (デフォルト)

この方法では、ローカルブラウザーを開いてユーザーに認可を促します。GUI を備えたデスクトップクライアント、および日常の開発や探索的なタスクに最適です。

Alibaba Cloud OpenAPI MCP サービスコンソールにログインし、Core または Custom Edition の MCP サービスエンドポイントページに移動します。[ワンクリック設定] をクリックし、[OAuth 認証 (デフォルト)] を選択します。次に、対応するクライアントタブを選択し、設定テンプレートに従って設定を完了します。プロセス中にブラウザーにユーザー承認ページが表示された場合は、[承認] をクリックします。

Cherry Studio

前提条件：Cherry Studio をインストール済みであること。

以下のいずれかの方法で設定を完了できます：

ワンクリック設定: コンソールの設定テンプレートページで、[Cherry Studio のワンクリック設定] をクリックし、画面の指示に従います。
手動設定：Cherry Studio で [設定] > [MCP Servers] に移動し、[Add] > [Quick Create] を選択します。名前を入力し、タイプとして [Streamable HTTP] を選択して、URL フィールドに <Streamable HTTP endpoint> のアドレスを入力します。または、[Import from JSON] を選択し、ページの設定 JSON を貼り付けます。

設定を保存すると、ブラウザーが Alibaba Cloud OAuth 認可ページに自動的にリダイレクトされます。認可すると、MCP サービスが開始されます。

TONGYI Lingma/Cursor/Windsurf/VSCode

前提条件：Node.js と npm をインストール済みであること。

以下のいずれかの方法で設定を完了できます：

ワンクリック設定 (Cursor のみ対応): コンソールの設定テンプレートページで、[Cursor のワンクリック設定] をクリックし、画面の指示に従います。
手動設定：コンソールページの設定 JSON を、クライアントの MCP 設定ファイルに貼り付けます。

各クライアントの設定方法：

TONGYI Lingma：TONGYI Lingma プラグインを開き、紹介ページで [MCP tools] をクリックします。次に、ポップアップウィンドウ右上の [+] をクリックしてツールを手動で追加します。カスタム名を入力し、Type に STDIO を選択します。Command に npx を入力し、Arguments に mcp-remote-alibaba-cloud "<Streamable HTTP endpoint>" を入力します。
Cursor：メニューバーで [File] > [Preferences] > [Cursor Settings] > [Tools & Integrations] を選択し、[Add Custom MCP] をクリックします。次に、JSON を mcp.json ファイルに貼り付けて保存します。設定ファイルは通常、~/.cursor/mcp.json またはプロジェクトのルートディレクトリにある .cursor/mcp.json にあります。
Windsurf：JSON を ~/.windsurf/mcp.json またはプロジェクトのルートディレクトリにある .windsurf/mcp.json に貼り付けます。
VSCode：設定で MCP を検索し、表示される指示に従って設定を追加します。

設定を保存した後、初回使用時はブラウザーで OAuth 認可を完了する必要があります。ブラウザーが自動的に開かない場合は、アプリケーションを再起動してください。

Claude Code

前提条件：Claude Code をインストール済みであること。

ターミナルで次のコマンドを実行して MCP サーバーを追加します。<Streamable HTTP endpoint> は、コンソールで取得した実際のアドレスに置き換えてください：

claude mcp add openapi-mcp-core -- npx mcp-remote-alibaba-cloud "<Streamable HTTP endpoint>"

追加した MCP サーバーを照会するには、次のコマンドを実行します：

claude mcp list

設定または使用中にブラウザーにユーザー承認ページが表示された場合は、[承認] をクリックします。

Codex

前提条件：Codex CLI をインストール済みであること。

codex mcp add openapi-mcp-core -- npx mcp-remote-alibaba-cloud "<Streamable HTTP endpoint>"

追加した MCP サーバーを照会するには、次のコマンドを実行します：

codex mcp list

設定または使用中にブラウザにユーザー承認ページが表示された場合は、[承認] をクリックします。

静的認証情報認証

静的認証情報認証は、ブラウザーへのリダイレクトなしで、ローカルプロキシ alibabacloud.mcp-proxy を通じて完了されます。この方法は、自動化パイプライン、純粋なコマンドライン環境、無人 AI エージェントなどのシナリオに適しています。

Alibaba Cloud OpenAPI MCP サービスコンソールにログインし、コア版またはカスタム版の MCP サービスのエンドポイントページに移動して、[ワンクリック設定]をクリックし、[静的資格情報認証] を選択します。次に、対応するクライアントタブを選択し、設定テンプレートに従って設定を完了します。

説明

ローカルで Alibaba Cloud CLI にログインしている場合 (aliyun configure)、プロキシは CLI の認証情報を自動的に読み取ります。設定で env 環境変数を設定する必要はありません。

Cherry Studio

前提条件：

Cherry Studio、Python (>= 3.13)、uv をインストール済みであること。
AccessKey に AliyunOpenAPIMCPServerStaticCredentialAccess システムポリシーがアタッチされていること。
初回使用前に、コンソールから事前チェックコマンドを実行して、アカウントの認可ステータスを確認する必要があります。このコマンドは、ブラウザーを使用できる任意のデバイスで実行でき、プロキシを実行するマシンと同一である必要はありません。

以下の方法で設定を完了できます：

Cherry Studio で [設定] > [MCP Servers] > [Add] > [Import from JSON] に移動し、設定を貼り付けます。AccessKey ID/Secret は実際のキーに置き換えてください。Alibaba Cloud CLI をすでに設定している場合は、env フィールドを削除してローカルの認証情報を再利用できます。

設定完了後、Cherry Studio を再起動し、リージョン内の ECS インスタンス一覧の取得などのテストリクエストを送信します。想定どおりに API が呼び出される場合、静的認証情報認証は成功です。

TONGYI Lingma/Cursor/Windsurf/VSCode

前提条件：

TONGYI Lingma/Cursor/Windsurf/VSCode、Python (>= 3.13)、uv をインストール済みであること。
AccessKey に AliyunOpenAPIMCPServerStaticCredentialAccess システムポリシーがアタッチされていること。
初回使用前に、コンソールから事前チェックコマンドを実行して、アカウントの認可ステータスを確認する必要があります。このコマンドは、ブラウザーを使用できる任意のデバイスで実行でき、プロキシを実行するマシンと同一である必要はありません。

各クライアントの設定方法：

TONGYI Lingma：プラグインの MCP tools ページでツールを手動で追加します。Type に STDIO を選択し、Command に uvx を入力します。Arguments に alibabacloud.mcp-proxy@latest --server-url "<Streamable HTTP endpoint>" --site-type INTL を入力します。次に、環境変数に ALIBABA_CLOUD_ACCESS_KEY_ID と ALIBABA_CLOUD_ACCESS_KEY_SECRET を追加します。
Cursor：JSON を ~/.cursor/mcp.json またはプロジェクトのルートディレクトリにある .cursor/mcp.json に貼り付けます。AccessKey ID とシークレットを置き換えてください。
Windsurf：JSON を ~/.windsurf/mcp.json またはプロジェクトのルートディレクトリにある .windsurf/mcp.json に貼り付けます。AccessKey ID とシークレットを置き換えてください。
VSCode：設定で MCP を検索し、表示される指示に従って設定を追加します。

Alibaba Cloud CLI をすでに設定している場合は、環境変数の設定を削除してローカルの認証情報を再利用できます。

設定完了後、設定を保存してクライアントを再起動します。テストリクエストを送信し、想定どおりに API が呼び出されることを確認します。これにより、静的認証情報認証が成功したことを確認できます。

Claude Code

前提条件：

Claude Code、Python (>= 3.13)、uv をインストール済みであること。
AccessKey に AliyunOpenAPIMCPServerStaticCredentialAccess システムポリシーがアタッチされていること。
初回使用前に、コンソールから事前チェックコマンドを実行して、アカウントの認可ステータスを確認する必要があります。このコマンドは、ブラウザーを使用できる任意のデバイスで実行でき、プロキシを実行するマシンと同一である必要はありません。

以下の方法で設定を完了できます：

ターミナルで次のコマンドを実行して MCP サーバーを追加します。<Access Key ID>、<Access Key Secret>、<Streamable HTTP endpoint> は実際の値に置き換えてください。

Alibaba Cloud CLI をすでに設定している場合は、環境変数の設定を削除してローカルの認証情報を再利用できます。

claude mcp add openapi-mcp-core --env ALIBABA_CLOUD_ACCESS_KEY_ID=<Access Key ID> --env ALIBABA_CLOUD_ACCESS_KEY_SECRET=<Access Key Secret> -- uvx alibabacloud.mcp-proxy@latest --server-url "<Streamable HTTP endpoint>" --site-type INTL

追加した MCP サーバーを照会するには、次のコマンドを実行します：

claude mcp list

Codex

前提条件：

Codex、Python (>= 3.13)、uv をインストール済みであること。
AccessKey に AliyunOpenAPIMCPServerStaticCredentialAccess システムポリシーがアタッチされていること。
初回使用前に、コンソールから事前チェックコマンドを実行して、アカウントの認可ステータスを確認する必要があります。このコマンドは、ブラウザーを使用できる任意のデバイスで実行でき、プロキシを実行するマシンと同一である必要はありません。

以下の方法で設定を完了できます：

Alibaba Cloud CLI をすでに設定している場合は、環境変数の設定を削除してローカルの認証情報を再利用できます。

codex mcp add openapi-mcp-core --env ALIBABA_CLOUD_ACCESS_KEY_ID=<Access Key ID> --env ALIBABA_CLOUD_ACCESS_KEY_SECRET=<Access Key Secret> -- uvx alibabacloud.mcp-proxy@latest --server-url "<Streamable HTTP endpoint>" --site-type INTL

追加した MCP サーバーを照会するには、次のコマンドを実行します：

codex mcp list

MCP サーバーの使用方法

設定後、クライアントで自然言語を使用してクラウドリソースを管理できます。その他の統合方法については、「MCP を統合するその他の方法」をご参照ください。

Core Edition：自然言語で直接ニーズを記述します。LLM は自動的に一致する API を検索し、そのパラメーター定義を取得して、API 名やパラメーターを指定することなく API 呼び出しを実行します。たとえば、「China (Hangzhou) リージョンの ECS インスタンスを照会してください」と入力すると、LLM は自動的に DescribeInstances API を検索して呼び出します。
Custom Edition：設定した API はツールとして直接 LLM に公開されるため、検索やマッチングが不要になり、呼び出しパスが短縮されます。複数の API が類似の機能を持つ場合、Custom Edition は LLM が意図した特定の API を確実に呼び出します。

Cherry Studio

テキスト入力ボックスのメニューから、MCP サーバーを選択します。
openapi-mcp-core サーバーを選択し、エントリの右側に、有効であることを示す緑色のチェックマークが表示されていることを確認します。
MCP 機能をテストします。たとえば、特定のリージョンの ECS インスタンスを照会します：
```
regionId が cn-chengdu の ECS インスタンスのリストを照会し、x_mcp_region_id を設定してください。
```
説明
API の選択やパラメーター設定が正しくない場合は、プロンプトの最適化を試みてください。Custom Edition の場合は、MCP チューニングを使用して問題を解決することもできます。

Cursor

モデルと API キーを選択します。Cursor には LLM プロバイダーに関する要件があるため (サポートされているプロバイダーを参照)、モデルと API キーを選択する際は、そのドキュメントを参照してください。この例ではデフォルト値を使用します。
Cursor のダイアログボックスで、[Add Context] をクリックし、MCP サーバーを選択します。
ダイアログボックスに自然言語のクエリを入力して MCP 機能をテストします。たとえば、「China (Chengdu) リージョンの ECS インスタンスの数を照会し、インスタンス数のみを表示してください。」などです。Enter キーを押した後、プロンプトに従って [Run tool] をクリックして続行します。
MCP の実行結果を確認します。API の選択やパラメーター設定が正しくない場合は、プロンプトの最適化を試みてください。Custom Edition の場合は、MCP チューニングを使用して問題を解決することもできます。

TONGYI Lingma

TONGYI Lingma で [エージェント] を選択し、プロンプトを入力します。たとえば、China (Chengdu) リージョンの ECS インスタンスリストを照会し、x_mcp_region_id を設定できます。
TONGYI Lingma のプロンプトに従って MCP ツールを実行します。
結果を確認します。API の選択やパラメーター設定が正しくない場合は、プロンプトの最適化を試みてください。Custom Edition の場合は、MCP チューニングを使用して問題を解決することもできます。

Cline

Cline のダイアログウィンドウに自然言語のクエリを入力して MCP 機能をテストします。たとえば、「China (Chengdu) リージョンの ECS インスタンスの数を照会してください。」などです。
Cline は、設定された MCP サーバーから自動的に DescribeInstances ツールを選択し、入力から RegionId パラメーターの値を抽出します。
MCP の実行結果を確認します。API の選択やパラメーター設定が正しくない場合は、プロンプトの最適化を試みてください。Custom Edition の場合は、MCP チューニングを使用して問題を解決することもできます。

MCP チューニング (Custom Edition のみ)

Core Edition は組み込みツールを使用して API の検索と呼び出しを自動的に処理します。チューニングはサポートされていません。

大規模言語モデル (LLM) が誤った API を選択したり、誤ったパラメーターを渡したりする場合があります。この場合は、サーバー側で API の概要、API リクエストの説明、およびリクエストパラメーターの説明を変更します。これにより、LLM が API をより正確に理解し、呼び出せるようになります。

例 1：cn-hangzhou リージョン外のリソース操作におけるエラーまたは不正確なデータ

内部的に、MCP は x_mcp_region_id を使用して エンドポイント を切り替えます。LLM が入力内容から x_mcp_region_id を渡す必要があることを理解できない場合、デフォルトで cn-hangzhou リージョンのリソースを操作します。

この問題は、次の 2 つの方法のいずれかで解決できます。

クエリ内で x_mcp_region_id を設定するように LLM に明示的に指示します。
```
Find the list of ECS instances for regionId cn-qingdao, and set x_mcp_region_id.
```
MCP サーバーで、API の概要、または RegionId リクエストパラメーターの説明を調整します。
たとえば、API の概要に「Pass the user-specified region to x_mcp_region_id」を追加します。または、RegionId の説明に「If the RegionId parameter exists, pass it along with x_mcp_region_id」を追加します。
手順：
1. Custom API MCP SERVER に移動し、対象の MCP サービスの [操作] 列で [編集] をクリックします。
2. チューニングする API を選択し、その [操作] 列で [編集] をクリックします。
3. 概要、API リクエストの説明、または API パラメーターの説明を変更します。
4. 変更を保存します。次に、クライアント側で MCP サービスを切断して再接続し、変更を適用します。

例 2：オプションの API パラメーターの削除

一部のオプションのパラメーターは、特定のシナリオでは使用されません。MCP サーバーでこれらのパラメーターを削除します。削除後、LLM はパラメーター生成時にそれらを無視します。これにより、エラー率が低下し、トークン消費量も削減されます。

MCP アクセス制御

AI エージェントが OpenAPI MCP サーバーと統合した後、エージェント自体にはクラウドリソースへのアクセス権限がありません。ユーザーは、エージェントが代理で操作することを認可する必要があります。例えば、クライアントは OAuth プロセスを開始できます。エージェントは、ユーザーが認可した後にのみ、一時的なアクセス権を取得します。すべての操作にはユーザーの認可が必要です。エージェントは、ユーザーの権限の範囲内にあるタスクのみを実行できます。これにより、最小権限の原則が実装されます。さらに、ActionTrail は実際に操作を実行したユーザーのアイデンティティを記録します。

シナリオ： CherryStudio、TONGYI Lingma、Qwen Code、Cursor、Claude Code、Dify、AgentScope、LangGraph などのクライアントエージェント、またはエージェントがユーザーの代理として操作を行う必要があるシナリオ。

MCP のその他の統合方法

Dify でカスタム OAuth アプリケーションを設定し、OpenAPI MCP サーバーと統合します。詳細については、「Dify で OpenAPI MCP サーバーを統合する」をご参照ください。
カスタムエージェントで、公式の MCP SDK を使用してカスタム OAuth 認可プロセスを完了し、主要なエージェントフレームワークと統合します。詳細については、「エージェントで OpenAPI MCP サーバーを統合する」をご参照ください。

よくある質問

Tools のすべての API を MCP クライアントから呼び出すことはできますか?

必ずしもそうとは限りません。API 呼び出しが成功するかどうかは、RAM ユーザーの権限に依存します。この RAM ユーザーとは、OAuth 認証を開始したユーザー、または認証用の AccessKey (AK) に関連付けられたユーザーのことです。RAM ユーザーに API を呼び出す権限がない場合、大規模言語モデル (LLM) も呼び出すことができません。

解決方法：RAM ユーザーに必要な API 権限を付与してください。詳細については、「RAM ユーザー権限の管理」をご参照ください。

重要

LLM が意図せずリソース削除 API を呼び出し、サービスに影響が及ぶのを防ぐため、RAM ユーザーにリソースの削除権限を付与しないでください。

RAM ユーザーとして MCP Server を作成する際に権限が拒否される場合

解決方法：

RAM ユーザーにシステムポリシー AliyunOpenAPIMCPServerFullAccess を付与してください。詳細については、「RAM ユーザー権限の管理」をご参照ください。
RAM ユーザーにカスタムポリシーを付与します。
1. 管理者アカウントを使用して、RAM コンソールでカスタムポリシーを作成します。詳細については、「カスタムポリシーの作成」をご参照ください。
  以下は、ポリシーの内容です。
  クリックして MCP Server の操作のポリシーを表示
  このポリシーには、MCP Server の作成、更新、クエリ、削除、および RAM アプリケーションを管理する権限が含まれます。
```
{
  "Version": "1",
  "Statement": [
    {
      "Action": [
        "openapiexplorer:*Mcp*",
        "ram:*Application*"
      ],
      "Resource": "*",
      "Effect": "Allow"
    }
  ]
}
```
2. 管理者アカウントを使用して、対象の RAM ユーザーにカスタム権限を付与します。詳細については、「RAM ユーザー権限の管理」をご参照ください。

MCP Server の接続エンドポイントが漏洩した場合、他者に悪用される可能性がありますか?

いいえ。クライアントがエンドポイントを使用する際、OAuth 認証により認可プロセスが開始されます。このプロセスでは、ユーザーがログインしてアクセスを許可する必要があります。システムは、RAM ユーザーの Alibaba Cloud アカウントが MCP Server の Alibaba Cloud アカウントと一致するかどうかを確認します。一致する場合にのみアクセスが許可されます。静的認証情報認証の場合、アクセスは AK に関連付けられた RAM ユーザーの権限によって制限されます。権限のない第三者がこの権限の範囲を超えることはできません。

静的認証情報認証と OAuth 認証のどちらを選択すればよいですか?

ユースケースに適した認証方法を選択してください。

OAuth 認証：ブラウザー操作を伴うデスクトップクライアントのシナリオに適しています。権限はユーザーに紐付けられ、トークンは有効期間が短く、セキュリティがより高くなっています。日常的な開発や探索的な操作には OAuth を使用してください。
静的認証情報認証 (AK)：ブラウザーリダイレクトが不便なシナリオ (自動化されたパイプライン、コマンドラインのみの環境 (グラフィカルユーザーインターフェース (GUI) を持たないサーバー)、無人 AI エージェント統合など) に適しています。権限は AK に関連付けられた RAM アイデンティティに紐付けられます。認証情報のセキュリティは自分で管理する必要があります。

AccessKey Secret が漏洩した場合はどうすればよいですか?

RAM コンソールで直ちに AccessKey を無効化または削除してください。
新しい AccessKey を作成し、クライアント設定を更新してください。
漏洩した期間の ActionTrail ログを確認し、未承認の呼び出しを特定してください。