すべてのプロダクト
Search
ドキュメントセンター

Simple Log Service:Simple Log Service (SLS) MCP サーバー

最終更新日:Sep 23, 2026

Simple Log Service (SLS) は、AI エージェントをお客様の SLS リソースに接続する公式の Model Context Protocol (MCP) サーバーを提供します。Qoder や Codex などのエージェントに SLS MCP サーバーを追加すると、自然言語を使用して、プロジェクトや Logstore の参照、ログのクエリと分析、およびアラートの診断ができます。

SLS MCP サーバーでできること

SLS MCP サーバーは、3つのカテゴリで 11 のツールを提供します。AI エージェントがリクエストに合致するツールを選択するため、コンソールのエントリーポイントを記憶したり、クエリステートメントを手動で記述したりする必要はありません。

  • リソース検出:コンソールにログインして 1 つずつ参照する代わりに、所有しているプロジェクトとログストアについて質問できます。

  • ログのクエリと分析:コンソールページを切り替える代わりに、クエリしたい内容を 1 文で記述できます。これらのツールは、一般的なログ分析の流れをカバーしています。インデックス設定を確認し、クエリを実行し、時系列の分布を確認します。

  • アラート診断:アラートがトリガーされた後、AI エージェントに原因の分析と問題の迅速な特定を依頼できます。

    各カテゴリのツールについては、「サポートされているツール」セクションをご参照ください。

SLS MCP Server の仕組み

Model Context Protocol (MCP) は、AI アシスタントが外部データソースやツールへ統一的に接続するためのオープンスタンダードです。サービスが MCP サーバーを提供すると、AI アシスタントはその機能をプラグアンドプレイで利用できます。

SLS MCP Server はローカルマシンで実行されます。AI エージェントが接続すると、サーバーは設定済みの OAuth 認証情報を使用して、お客様に代わって Simple Log Service (SLS) OpenAPI を呼び出します。次の図は、エンドツーエンドパスを示しています。

AI agent (Qoder、Codex など)
 │ MCP protocol (stdio トランスポート)
 ▼
alibabacloud-sls-mcp-proxy (ローカルで実行)
 │ OAuth credentials (Alibaba Cloud CLI プロファイルから)
 ▼
Simple Log Service (SLS) OpenAPI

考慮事項

SLS MCP サーバーを AI エージェントに接続する前に、以下の項目を確認してください。

  • 認証 — SLS MCP サーバーは、Alibaba Cloud CLI プロファイルに保存された OAuth 認証情報を使用して SLS で認証を行います。ブラウザを通じてサインインするため、AccessKey ペアを作成または貼り付ける必要はありません。

  • 1 回限りの RAM 認可 — Alibaba Cloud アカウント内のいずれかのユーザーが初めて OAuth でサインインする前に、RAM 管理者が official-cli アプリケーションをインストールし、Alibaba Cloud CLI を使用する RAM ユーザーまたはロールを認可リストに追加する必要があります。手順については、「Alibaba Cloud CLI への OAuth アクセスの許可」セクションをご参照ください。

  • リージョンレスアクセス — プロジェクトにアクセスする際、プロジェクトのリージョンを指定する必要はありません。SLS MCP サーバーが対応するリージョンを自動的に照合するため、1 つの認証情報プロファイルで、すべてのプロジェクトにリージョンを跨いでアクセスできます。

  • アラートツールの動作 — アラート診断ツールは読み取り専用で、アラートの状態を変更することはありません。マスキングはツールによって異なります。sls_list_alerts はクエリステートメントと通知ターゲットのいずれも返さず、sls_get_alert は機密性の高い通知設定をマスキングした診断クエリを返します。

前提条件

  • Alibaba Cloud アカウントがあること。Resource Access Management (RAM) ユーザーを使用する場合、RAM ユーザーには Simple Log Service (SLS) のアクセス権限が必要です。

  • ローカルマシンに uv ツールがインストールされていること。SLS MCP サーバーは、uv に付属する uvx コマンドを使用して起動します。インストール手順については、uv ドキュメント をご参照ください。

Alibaba Cloud CLI への OAuth アクセスの許可

RAM 管理者は、Alibaba Cloud アカウントで以下の手順を 1 回実行します。後で繰り返す必要はありません。RAM 管理者でない場合は、クイックスタートを開始する前に、この認可が完了していることを管理者に確認してください。

  1. CLI アプリケーションのインストール:RAM コンソールにログインします。左側のナビゲーションペインで、[OAuth (Preview)] を選択し、[Third-party Application] タブをクリックします。official-cli アプリケーションが一覧に表示されていない場合は、[Official CLI] を選択してインストールします。

  2. アイデンティティの割り当て:official-cli アプリケーションの詳細ページを開き、[Allowed Identities] タブをクリックします。[Add Users or roles] をクリックして、Alibaba Cloud CLI を使用する必要がある RAM ユーザーまたはロールを認可リストに追加します。

クイックスタート

以下の手順は、AI エージェントのユーザーが実行します。これらの手順は、前のセクションで説明した 1 回限りの OAuth 認可が完了していることを前提としています。

ステップ 1:Alibaba Cloud CLI のインストール

次のコマンドを実行して Alibaba Cloud CLI をインストールします。

sudo /bin/bash -c "$(curl -fsSL https://aliyuncli.alicdn.com/install.sh)"

インストールが完了したら、aliyun version を実行します。コマンドがバージョン番号を返せば、インストールは成功です。

ステップ 2:OAuth でサインインし、認証情報プロファイルを作成

次のコマンドを実行します。ブラウザが自動的に開きます。サインインして認証を完了してください。

aliyun configure --mode OAuth

サインインが成功すると、Alibaba Cloud CLI は OAuth 認証情報をプロファイルに保存します。デフォルトのプロファイル名は default です。複数のアカウントまたは複数の環境を管理するには、-p パラメーターを使用してカスタムプロファイル名を指定します。

aliyun configure --mode OAuth -p sls-test-oauth

使用するプロファイル名をメモしておいてください。この名前は、ステップ 3 で --profile パラメーターで指定します。

説明

CLI でリージョンを求められたら、cn-hangzhou を入力します。指定したリージョンによって、SLS MCP サーバーがアクセスできるプロジェクトが制限されることはありません。

ステップ 3:AI エージェントに SLS MCP サーバーを追加

使用するクライアントの設定を行います。複数のクライアントを設定する必要はありません。SLS MCP サーバーは標準の stdio トランスポートを使用するため、MCP をサポートする任意の AI エージェントに接続できます。起動コマンドを uvx に、引数を alibabacloud-sls-mcp-proxy@latest --profile <your profile name> に設定します。

以下の例では、default プロファイルを使用します。ステップ 2 で -p パラメーターを使用してカスタムプロファイルを作成した場合は、default をそのプロファイル名に置き換えてください。

説明

uvx alibabacloud-sls-mcp-proxy@latest コマンドは、SLS MCP サーバーの最新バージョンをローカルにダウンロードして実行します。このステップのすべてのコマンドには、uv に付属の uvx が必要です。

CLI コマンドで設定するクライアント

Qoder

# MCP サーバーを追加
qodercli mcp add \
  --scope user \
  --transport stdio \
  alibabacloud-sls \
  -- uvx alibabacloud-sls-mcp-proxy@latest --profile default

# 追加した MCP サーバーを一覧表示
qodercli mcp list

Codex

# MCP サーバーを追加
codex mcp add alibabacloud-sls \
  -- uvx alibabacloud-sls-mcp-proxy@latest --profile default

# 追加した MCP サーバーを一覧表示
codex mcp list

Claude Code

# MCP サーバーを追加します。--scope user は、現在のユーザーのすべてのプロジェクトに設定を適用します。
claude mcp add --scope user alibabacloud-sls \
  -- uvx alibabacloud-sls-mcp-proxy@latest --profile default

# 追加した MCP サーバーを一覧表示
claude mcp list

OpenClaw

# MCP サーバーを追加
openclaw mcp add alibabacloud-sls \
  --command uvx \
  --arg alibabacloud-sls-mcp-proxy@latest \
  --arg --profile \
  --arg default

# 追加した MCP サーバーを一覧表示
openclaw mcp list

設定ファイルで設定するクライアント

Cursor、Cline、Cherry Studio、およびその他の JSON ベースのクライアント

JSON ファイルで MCP サーバーを設定するクライアントの場合は、次の内容を MCP 設定ファイルに追加します:

{
  "mcpServers": {
    "alibabacloud-sls": {
      "command": "uvx",
      "args": [
        "alibabacloud-sls-mcp-proxy@latest",
        "--profile",
        "default"
      ]
    }
  }
}

Hermes Agent

Hermes Agent は、設定ファイルで MCP サーバーを管理します。ホームディレクトリにある ~/.hermes/config.yaml ファイルを編集するか、ファイルが存在しない場合は作成して、次の内容を追加してください:

mcp_servers:
  alibabacloud-sls:
    command: uvx
    args:
      - alibabacloud-sls-mcp-proxy@latest
      - --profile
      - default

ファイルを保存して Hermes Agent を再起動するか、セッションで /reload-mcp を実行して MCP 設定をリロードしてください。

ステップ 4:接続の確認

AI エージェントを開き、自然言語でリクエストを入力します。

List the SLS projects that I can access

AI エージェントがプロジェクトリストを返した場合、SLS MCP サーバーは接続されています。プロジェクトリストが返されない場合は、次の項目を確認してください:

  • uvx コマンドがローカルマシンで使用できること。

  • 1 回限りの OAuth 認可が、お使いの RAM ユーザーまたはロールを対象としていること。

  • クライアント設定の --profile の値が、ステップ 2 で作成したプロファイル名と一致していること。

Usage examples

After you complete the connection, ask questions in natural language directly in your AI agent. The following examples show typical usage.

Example 1: Find resources

List the SLS projects that I can access in the China (Hangzhou) region

The AI agent calls sls_list_projects and returns the project list. You can then ask a follow-up question:

Which Logstores does the nginx-prod project contain?

The AI agent calls sls_list_logstores and lists the corresponding LogStores.

Example 2: Query logs

Query the logs that contain error in the access-log Logstore of the nginx-prod project over the last 1 hour

The AI agent calls sls_query_logs and automatically uses a relative time range such as now-1h to now. To understand the log volume distribution, ask a follow-up question:

Approximately how many logs are there? Show me the distribution over time

The AI agent calls sls_get_log_histogram and returns the total number of matched logs and their distribution over time.

Example 3: View the log context

A single log often does not provide enough information during troubleshooting. Ask the AI agent to retrieve the log context:

Show me the 20 log lines before and after this error log

The AI agent uses the __pack_id__ and __pack_meta__ values from the previous query result, calls sls_get_context_logs, and returns the full context before and after the target log.

Example 4: Diagnose an alert

Why was my cpu-high alert triggered over the last 24 hours? Run a diagnosis for me

The AI agent calls sls_diagnose_alert, which summarizes the lifecycle, severity, evaluation reason, and query evidence of the alert instance. The summary helps you locate the cause quickly.

MCP Inspector によるデバッグ

開発中に SLS MCP Server のツールとパラメーターをデバッグするには、公式の MCP Inspector を使用して、ブラウザーベースのデバッグインターフェイスを開きます。このコマンドでは、Node.js が npx コマンドを提供するため、ローカルマシンに Node.js が必要です。sls-test-oauth は、認証情報プロファイル名に置き換えてください。

npx -y @modelcontextprotocol/inspector@latest -- uvx alibabacloud-sls-mcp-proxy@latest --profile sls-test-oauth

対応ツール

ツール

カテゴリ

説明

sls_list_projects

リソース検出

現在の呼び出し元がアクセスできる SLS プロジェクトを取得します。リージョン、名前、リソースグループなどのフィルター条件に対応しています。

sls_list_logstores

リソース検出

指定したプロジェクト内でログデータを保存する Logstore を取得します。このツールはメトリックストアを除外します。

sls_list_metricstores

リソース検出

指定したプロジェクト内でメトリックデータを保存するメトリックストアを取得します。

sls_get_logstore_index

ログのクエリと分析

Logstore のインデックス設定を取得します。

sls_query_logs

ログのクエリと分析

生ログをクエリするか、SLS SQL 分析を実行します。相対時間範囲に対応しています。

sls_get_log_histogram

ログのクエリと分析

指定した時間範囲内で、条件に一致するログの総数と、その時間分布をクエリします。

sls_get_context_logs

ログのクエリと分析

ターゲットログの前後のコンテキストを取得します。pack_id と pack_meta パラメーターには、ターゲットログの __pack_id__ と __pack_meta__ の値を指定します。

sls_list_alerts

アラート診断

アラートルールのセキュリティサマリーをページ単位で一覧表示します。クエリ文と通知先は返されません。

sls_get_alert

アラート診断

単一のアラートルールのスケジュール、トリガー条件、診断クエリを取得します。機密性の高い通知設定はマスクされます。

sls_list_alert_history

アラート診断

その時点でアラートエンジンが保存したクエリ結果と合わせて、アラートルールの発火と解決の履歴をクエリします。

sls_diagnose_alert

アラート診断

最近のアラートインスタンスのライフサイクル、重要度、評価理由、クエリの証拠を要約します。アラート状態は変更しません。

ツールのパラメーター

以下の表は、各ツールの入力パラメーターを説明しています。AI エージェントを通じてツールを呼び出す場合、AI エージェントが自動的にパラメーターを入力するため、通常はこれらのパラメーターを処理する必要はありません。高度な使用法やデバッグには、これらの表をご使用ください。

sls_list_projects

パラメーター

タイプ

必須

説明

offset

整数

いいえ

ゼロベースのページネーションオフセット。デフォルト値: 0。

size

整数

いいえ

1 ページあたりに返すプロジェクトの数。SLS のデフォルト値と最大値はいずれも 500 です。

region_id

文字列

いいえ

SLS のリージョン ID でフィルタリングします。例: cn-hangzhou。

project_name

文字列

いいえ

プロジェクト名でフィルタリングします。このフィールドは検索条件であり、正確なリソース命名規則による検証は行われません。

resource_group_id

文字列

いいえ

リソースグループ ID でフィルタリングします。

search_text

文字列

いいえ

プロジェクトのフリーテキスト検索条件。

sls_list_logstores

パラメーター

タイプ

必須

説明

project

文字列

はい

対象の SLS プロジェクトの名前。

offset

整数

いいえ

ゼロベースのページネーションオフセット。デフォルト値: 0。

size

整数

いいえ

1 ページあたりに返す LogStore の数。SLS のデフォルト値と最大値はいずれも 500 です。

sls_list_metricstores

パラメーター

タイプ

必須

説明

project

文字列

はい

対象の SLS プロジェクトの名前。

offset

整数

いいえ

ゼロベースのページネーションオフセット。デフォルト値: 0。

size

整数

いいえ

1 ページあたりに返す Metricstore の数。SLS のデフォルト値と最大値はいずれも 500 です。

sls_get_logstore_index

パラメーター

タイプ

必須

説明

project

文字列

はい

対象の SLS プロジェクトの名前。

logstore

文字列

はい

インデックス設定を読み取る LogStore の名前。

sls_query_logs

パラメーター

タイプ

必須

説明

project

文字列

はい

対象の SLS プロジェクトの名前。

logstore

文字列

はい

クエリする LogStore の名前。

query

文字列

いいえ

SLS のクエリ文または分析文。デフォルト値: 空文字列。

topic

文字列

いいえ

SLS の Topic フィルター条件。

from

文字列

はい

クエリ時間範囲の開始時刻。指定された時点は含まれます。例: 1786342175。UNIX 秒またはnow-1hなどの相対時間をサポートします。

to

文字列

はい

クエリ時間範囲の終了時刻。指定された時点は含まれません。例: 1786342175。UNIX 秒またはnowなどの相対時間をサポートします。

lines

整数

いいえ

非 SQL クエリで返す最大行数。SLS のデフォルト値と最大値はいずれも 100 です。

offset

整数

いいえ

非 SQL クエリのゼロベースの結果オフセット。デフォルト値: 0。

reverse

ブール

いいえ

非 SQL クエリの結果を逆時系列順で返すかどうかを指定します。デフォルト値: false。

power_sql

ブール

いいえ

専用 SQL コンピューティングリソースを使用するかどうかを指定します。デフォルト値: false。

sls_get_log_histogram

パラメーター

タイプ

必須

説明

project

文字列

はい

対象の SLS プロジェクトの名前。

logstore

文字列

はい

クエリする LogStore の名前。

from

整数

はい

クエリ時間範囲の開始時刻 (UNIX 秒)。指定された時点は含まれます。

to

整数

はい

クエリ時間範囲の終了時刻 (UNIX 秒)。指定された時点は含まれません。

topic

文字列

いいえ

SLS の Topic フィルター条件。

query

文字列

いいえ

SLS のクエリ式。SQL 分析はサポートされていません。

sls_get_context_logs

パラメーター

タイプ

必須

説明

project

文字列

はい

対象の SLS プロジェクトの名前。

logstore

文字列

はい

対象のログを含む LogStore の名前。

pack_id

文字列

はい

前回のsls_query_logsの結果に含まれる__pack_id__の値。

pack_meta

文字列

はい

前回のsls_query_logsの結果に含まれる__pack_meta__の値。

back_lines

整数

いいえ

対象のログより前に返すログの行数。デフォルト値: 10、最大値: 100。

forward_lines

整数

いいえ

対象のログより後に返すログの行数。デフォルト値: 10、最大値: 100。

sls_list_alerts

パラメーター

タイプ

必須

説明

project

文字列

はい

対象のアラートルールを含む SLS プロジェクトの名前。

alert_name

文字列

いいえ

アラートルール名のフィルター条件。

dashboard

文字列

いいえ

ダッシュボードリソースプロバイダーのフィルター条件。

offset

整数

いいえ

ゼロベースのページネーションオフセット。デフォルト値: 0。

size

整数

いいえ

1 ページあたりに返すアラートルールの数。値が 0 の場合、またはパラメーターが省略された場合は、SLS API のデフォルト値が使用されます。

sls_get_alert

パラメーター

タイプ

必須

説明

project

文字列

はい

対象のアラートルールを含む SLS プロジェクトの名前。

alert_name

文字列

はい

取得するアラートルールの正確な名前。

sls_list_alert_history

パラメーター

タイプ

必須

説明

project

文字列

はい

internal-alert-history LogStore を含む SLS プロジェクトの名前。

alert_name

文字列

いいえ

アラートルールの正確な名前でフィルタリングします。

alert_id

文字列

いいえ

アラートインスタンスの正確な ID でフィルタリングします。

alert_status

文字列

いいえ

アラートのライフサイクル状態でフィルタリングします。例: firing または resolved。

from

文字列

はい

履歴クエリ時間範囲の開始時刻。指定された時点は含まれます。UNIX 秒またはnow-24hなどの相対時間をサポートします。

to

文字列

はい

履歴クエリ時間範囲の終了時刻。指定された時点は含まれません。UNIX 秒またはnowなどの相対時間をサポートします。

lines

整数

いいえ

履歴イベントの最大数。デフォルト値: 20、最大値: 100。

offset

整数

いいえ

ゼロベースの履歴結果オフセット。デフォルト値: 0。

sls_diagnose_alert

パラメーター

タイプ

必須

説明

project

文字列

はい

アラートルールとinternal-alert-history LogStore を含む SLS プロジェクトの名前。

alert_name

文字列

はい

診断するアラートルールの正確な名前。

alert_id

文字列

いいえ

アラートインスタンスの ID。このパラメーターを省略すると、診断時間範囲内で最新の一致するインスタンスが診断されます。

from

文字列

はい

診断時間範囲の開始時刻。指定された時点は含まれます。UNIX 秒またはnow-24hなどの相対時間をサポートします。

to

文字列

はい

診断時間範囲の終了時刻。指定された時点は含まれません。UNIX 秒またはnowなどの相対時間をサポートします。

max_events

整数

いいえ

診断証拠として返す最新の履歴イベントの数。デフォルト値: 20、最大値: 100。

よくある質問

SLS MCP Server を使用するためにアクセスキーペアを設定する必要がありますか?

いいえ。SLS MCP Server は OAuth サインインをサポートしています。ブラウザー経由でサインインして認証を完了し、認証情報は Alibaba Cloud CLI プロファイルに保存されます。アクセスキーペアを作成したり貼り付けたりする必要はありません。

RAM 管理者の認可を繰り返す必要がありますか?

いいえ。これは 1 回限りの設定です。RAM 管理者が official-cli アプリケーションをインストールし、RAM ユーザーまたは RAM ロールを割り当てた後は、これらのユーザーは手順を繰り返すことなく直接 OAuth でサインインできます。

複数アカウントまたは複数環境を管理するにはどうすればよいですか?

-p パラメーターを使用して複数のプロファイルを作成します (例: aliyun configure --mode OAuth -p sls-test-oauth)。次に、クライアントに SLS MCP Server を追加する際に、--profile パラメーターで対応するプロファイル名を指定します。プロファイルごとに個別の MCP サーバーを追加することもできます。

認証情報を設定する際に、どのリージョンを入力すればよいですか?

ステップ 2 で説明されているように、CLI からリージョンを求められたら cn-hangzhou を入力します。プロジェクトにアクセスする際に SLS MCP Server が対応するリージョンを自動的に照合するため、この値によってアクセス可能なプロジェクトが制限されることはありません。1 つのリージョン内のリソースのみを表示するには、プロジェクトを一覧表示する際に region_id パラメーターでフィルターします。

uvx コマンドが見つからない場合はどうすればよいですか?

uvx コマンドは、SLS MCP Server の前提条件である uv ツールによって提供されます。まず uv をインストールしてください。インストール手順については、「uv ドキュメント」をご参照ください。インストールが完了したら、新しいターミナルを開いて再度お試しください。