Layanan Direct Mail MCP - Direct Mail - Alibaba Cloud Documentation Center

Catatan

Kinerja layanan Direct Mail MCP bergantung pada kemampuan inti agen AI Anda. Kami menyarankan mengoptimalkan prompt dan basis pengetahuan agen AI tersebut.

Ikhtisar

Model Context Protocol (MCP) menyediakan antarmuka terpadu dan terstandarisasi untuk model bahasa besar dan asisten AI. Protokol ini berfungsi seperti port USB, memungkinkan AI terhubung dan mengoperasikan tool eksternal secara mudah guna menyelesaikan tugas yang kompleks.

Direct Mail kini mendukung MCP. Anda dapat menggunakan protokol ini untuk memberi otorisasi kepada agen AI guna melakukan operasi tertentu dan berinteraksi dengan Direct Mail melalui chat untuk mengambil informasi.

Kemampuan

Server STDIO Direct Mail MCP menyediakan tool kueri dan alur kerja terlindungi untuk mengirim direct mail, membuat templat, mengirim email uji menggunakan templat, menjalankan tugas batch, membuat tag, membuat daftar penerima, serta menambahkan catatan ke daftar penerima. Layanan ini menggunakan Alibaba Cloud SDK.

Catatan

Layanan Direct Mail MCP hanya mendukung STDIO, bukan HTTP. Gunakan STDIO atau file konfigurasi JSON untuk mengonfigurasi layanan.

Konfigurasi

Prasyarat

Node.js >=20
Akun Alibaba Cloud dengan Direct Mail yang telah diaktifkan.
ID AccessKey dan AccessKey Secret RAM user dengan izin Direct Mail yang diperlukan.
Resource Direct Mail yang diperlukan untuk pengiriman, seperti alamat email yang telah disetujui, templat, tag, dan daftar penerima.

Layanan ini merupakan proses MCP STDIO yang biasanya diluncurkan oleh MCP Host. Layanan ini tidak dimaksudkan untuk digunakan sebagai perintah shell interaktif.

Konfigurasi MCP Host

Konfigurasikan MCP Host untuk meluncurkan paket menggunakan npx dan meneruskan kredensial Alibaba Cloud Anda sebagai variabel lingkungan:

{
  "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"
      }
    }
  }
}

Pertama, buat ID AccessKey dan AccessKey Secret untuk RAM user. Untuk informasi selengkapnya, lihat Create an AccessKey. AccessKey Secret hanya ditampilkan saat pembuatan. Simpan dengan aman.

Nilai default untuk ALIYUN_DM_REGION_ID adalah ap-southeast-1. Untuk daftar ID wilayah dan titik akhir layanan Direct Mail, lihat Service Endpoints.

Alat

Bagian ini mencantumkan tool yang tersedia. Untuk parameter yang tepat dan bidang kontrol konfirmasi, rujuk skema tool yang dikembalikan oleh MCP Host.

Tool	Deskripsi	Tingkat risiko
`dm_get_account_summary`	Lihat kuota, status, dan jumlah resource akun Direct Mail Anda.	read-only
`dm_list_mail_addresses`	Daftar atau filter alamat email.	read-only
`dm_list_config_sets`	Daftar set konfigurasi.	read-only
`dm_get_config_set`	Kueri detail satu set konfigurasi.	read-only
`dm_list_templates`	Daftar templat Direct Mail sebelum menjalankan tugas batch atau pengiriman uji.	read-only
`dm_get_template`	Kueri subjek, status, dan konten templat untuk ditinjau sebelum pengiriman.	read-only
`dm_create_template`	Pratinjau dan buat templat email setelah konfirmasi. Templat tersebut memerlukan tinjauan setelah dibuat.	protected write
`dm_list_receivers`	Daftar metadata daftar penerima.	read-only
`dm_list_receiver_details`	Kueri detail satu daftar penerima.	read-only
`dm_create_receiver_list`	Pratinjau dan buat daftar penerima kosong setelah konfirmasi.	protected write
`dm_add_receiver_records`	Tambahkan catatan penerima ke daftar penerima.	protected write
`dm_list_tasks`	Daftar tugas batch Direct Mail untuk memeriksa progres.	read-only
`dm_list_tags`	Daftar tag yang digunakan untuk klasifikasi dan pelacakan.	read-only
`dm_create_tag`	Pratinjau dan buat tag setelah konfirmasi.	protected write
`dm_list_send_details`	Kueri detail pengiriman per penerima atau per email.	read-only
`dm_get_send_statistics_summary`	Kueri statistik pengiriman agregat.	read-only
`dm_list_block_sending`	Kueri catatan pengiriman yang diblokir, seperti alamat yang berhenti berlangganan.	read-only
`dm_get_track_list`	Kueri data pelacakan pembukaan dan klik.	read-only
`dm_list_dedicated_ips`	Daftar IP dedicated yang telah dibeli.	read-only
`dm_list_dedicated_ip_pools`	Daftar pool IP dedicated.	read-only
`dm_get_ip_protection`	Kueri status sakelar Perlindungan IP Direct Mail.	read-only
`dm_send_direct_email`	Kirim email transaksional, seperti kode verifikasi (maksimal 100 penerima).	protected sending
`dm_start_batch_send_task`	Mulai tugas pengiriman batch, cocok untuk email pemasaran (tanpa batas jumlah penerima).	protected sending
`dm_send_template_test_email`	Pratinjau dan kirim email uji menggunakan templat. Tidak untuk penggunaan produksi.	protected sending

Tool dengan tingkat risiko protected write dan protected sending tidak akan memanggil API write Direct Mail jika parameter execute tidak disertakan. Sebagai gantinya, tool tersebut akan mengembalikan pratinjau dan aksi konfirmasi. MCP Host harus menampilkan pratinjau kepada pengguna dan hanya melanjutkan setelah menerima persetujuan eksplisit berdasarkan aksi konfirmasi yang dikembalikan.

Skill agen opsional

Layanan MCP dapat berjalan secara mandiri. Dengan menginstal skill agen opsional, asisten AI dapat memilih tool, memverifikasi pratinjau, dan menangani alur konfirmasi sesuai proses bisnis Direct Mail secara lebih andal. Skill ini memberikan panduan alur kerja untuk asisten AI dan tidak mengubah perilaku runtime layanan MCP.

Tautan unduh: alibabacloud-direct-mail-agent-skill.zip.

Prompts

Host yang mendukung MCP listPrompts / getPrompt dapat secara opsional menggunakan panduan alur kerja berdasarkan skenario. Detail prompt konsisten dengan skill yang di-host eksternal. Untuk definisi bidang yang tepat, selalu rujuk skema tool dan structuredContent yang dikembalikan oleh layanan.

Prompt	Kasus penggunaan
`dm_direct_email_send_assistant`	Bersiap mengirim direct mail atau notifikasi transaksional ke penerima tertentu.
`dm_template_batch_send_assistant`	Siapkan tugas batch menggunakan templat dan daftar penerima, dengan opsi pengiriman uji.
`dm_delivery_investigation_assistant`	Investigasi progres tugas, detail pengiriman, statistik, atau data pelacakan.