Direct Mail MCP サービス - Direct Mail - Alibaba Cloud ドキュメントセンター

説明

Direct Mail MCP サービスのパフォーマンスは、AI エージェントのコア機能に依存します。AI エージェントのプロンプトとナレッジベースを最適化することを推奨します。

概要

モデルコンテキストプロトコル (MCP) は、大規模言語モデルと AI アシスタント向けの、統一された標準インターフェイスです。USB ポートのように機能し、AI が外部ツールへ容易に接続・操作して、複雑なタスクを完了できるようにします。

Direct Mail は MCP をサポートしています。このプロトコルを使用すると、AI エージェントに特定の操作を認可し、チャットを通じて Direct Mail と連携して情報を取得できます。

機能

Direct Mail MCP STDIO サーバーは、クエリツールと保護されたワークフローを提供します。これらを使用して、Direct Mail の送信、テンプレートの作成、テンプレートを使用したテストメールの送信、バッチタスクの実行、タグの作成、受信者リストの作成、受信者リストへのレコードの追加が可能です。このサービスは Alibaba Cloud SDK を使用します。

説明

Direct Mail MCP サービスは STDIO のみをサポートし、HTTP はサポートしません。サービスの設定には STDIO または JSON 設定ファイルを使用します。

設定

前提条件

Node.js >=20
Direct Mail が有効化された Alibaba Cloud アカウント。
必要な Direct Mail 権限を持つ RAM ユーザーの AccessKey ID と AccessKey Secret。
承認済みのメールアドレス、テンプレート、タグ、受信者リストなど、送信に必要な Direct Mail リソース。

このサービスは MCP STDIO プロセスであり、通常は MCP Host が起動します。対話型のシェルコマンドとしての使用は想定していません。

MCP Host の設定

MCP Host を設定し、npx を使用してパッケージを起動し、Alibaba Cloud の認証情報を環境変数として渡します。

{
  "mcpServers": {
    "aliyun-direct-mail": {
      "command": "npx",
      "args": ["-y", "alibabacloud-direct-mail-mcp"],
      "env": {
        "ALIBABA_CLOUD_ACCESS_KEY_ID": "your-access-key-id",
        "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "your-access-key-secret",
        "ALIYUN_DM_REGION_ID": "ap-southeast-1"
      }
    }
  }
}

まず、RAM ユーザー用の AccessKey ID と AccessKey Secret を作成します。詳細については、「Create an AccessKey」をご参照ください。AccessKey Secret は作成時にのみ表示されます。安全に保管してください。

ALIYUN_DM_REGION_ID のデフォルト値は ap-southeast-1 です。Direct Mail のリージョン ID とサービスエンドポイントの一覧については、「Service Endpoints」をご参照ください。

ツール

このセクションでは、利用可能なツールを紹介します。正確なパラメーターと確認制御フィールドについては、MCP Host が返すツールスキーマをご参照ください。

ツール	説明	リスクレベル
`dm_get_account_summary`	Direct Mail アカウントのクォータ、ステータス、リソース数を表示します。	読み取り専用
`dm_list_mail_addresses`	メールアドレスを一覧表示またはフィルタリングします。	読み取り専用
`dm_list_config_sets`	設定セットを一覧表示します。	読み取り専用
`dm_get_config_set`	単一の設定セットの詳細を照会します。	読み取り専用
`dm_list_templates`	バッチタスクまたはテスト送信の前に Direct Mail テンプレートを一覧表示します。	読み取り専用
`dm_get_template`	送信前のレビュー用に、テンプレートの件名、ステータス、内容を照会します。	読み取り専用
`dm_create_template`	確認後、メールテンプレートをプレビューして作成します。テンプレートは作成後にレビューが必要です。	保護された書き込み
`dm_list_receivers`	受信者リストのメタデータを一覧表示します。	読み取り専用
`dm_list_receiver_details`	単一の受信者リストの詳細を照会します。	読み取り専用
`dm_create_receiver_list`	確認後、空の受信者リストをプレビューして作成します。	保護された書き込み
`dm_add_receiver_records`	受信者リストに受信者レコードを追記します。	保護された書き込み
`dm_list_tasks`	進捗確認のために Direct Mail のバッチタスクを一覧表示します。	読み取り専用
`dm_list_tags`	分類とトラッキングに使用するタグを一覧表示します。	読み取り専用
`dm_create_tag`	確認後、タグをプレビューして作成します。	保護された書き込み
`dm_list_send_details`	受信者別またはメール別に配信詳細を照会します。	読み取り専用
`dm_get_send_statistics_summary`	集計済みの送信統計を照会します。	読み取り専用
`dm_list_block_sending`	配信停止済みのアドレスなど、ブロックされた送信レコードを照会します。	読み取り専用
`dm_get_track_list`	開封およびクリックのトラッキングデータを照会します。	読み取り専用
`dm_list_dedicated_ips`	購入済みの専用 IP を一覧表示します。	読み取り専用
`dm_list_dedicated_ip_pools`	専用 IP プールを一覧表示します。	読み取り専用
`dm_get_ip_protection`	Direct Mail の IP 保護スイッチのステータスを照会します。	読み取り専用
`dm_send_direct_email`	認証コードなどのトランザクションメールを送信します (最大 100 人の受信者)。	保護された送信
`dm_start_batch_send_task`	バッチ送信タスクを開始します。マーケティングメールに適しており、受信者数の上限はありません。	保護された送信
`dm_send_template_test_email`	テンプレートを使用してテストメールをプレビューし、送信します。本番環境では使用しないでください。	保護された送信

保護された書き込みツールと送信ツールは、execute パラメーターが省略された場合、Direct Mail の書き込み API を呼び出しません。代わりに、プレビューと確認アクションを返します。MCP Host はプレビューをユーザーに表示し、返された確認アクションに基づき明示的な承認を得た後でのみ、処理を進める必要があります。

オプションのエージェントスキル

MCP サービスは単独で実行できます。オプションのエージェントスキルをインストールすると、AI アシスタントが Direct Mail のビジネスプロセスに従い、より確実にツールを選択し、プレビューを検証し、確認フローを処理できるようになります。このスキルは AI アシスタントにワークフローガイダンスを提供しますが、MCP サービスの実行時の動作は変更しません。

ダウンロードリンク： alibabacloud-direct-mail-agent-skill.zip。

プロンプト

MCP をサポートするホストは、listPrompts / getPrompt を使用して、シナリオに基づくワークフローガイダンスを任意で利用できます。プロンプトの詳細は、外部でホストされているスキルと一致します。正確なフィールド定義については、常にツールスキーマと、このサービスから返される structuredContent をご参照ください。

プロンプト	ユースケース
`dm_direct_email_send_assistant`	特定の受信者への Direct Mail 送信やトランザクション通知の準備を行います。
`dm_template_batch_send_assistant`	テンプレートと受信者リストを使用してバッチタスクを準備します。必要に応じてテスト送信も可能です。
`dm_delivery_investigation_assistant`	タスクの進捗、配信詳細、統計、トラッキングデータを調査します。