Server MCP untuk Asisten AI

Apa itu server MCP#

MCP (Model Context Protocol) membuat asisten AI — Claude Code, Cursor, VS Code, Windsurf, atau agen n8n — bisa memakai fitur CSWA.AI sebagai alat: membaca chat yang belum dibalas, mencari kontak, mengirim pesan, membuat broadcast, sampai melihat pesanan dan analitik. Alamat server: https://mcp.cswa.ai (cadangan: https://cswa.ai/api/mcp).

1. Siapkan kunci API#

1. 1

   Langkah 1: Buat kunci khusus MCP

   Di API & Webhook klik Buat kunci, beri nama mis. "Claude laptop", dan centang izin seperlunya. Alat yang muncul di asisten AI mengikuti izin ini — untuk asisten yang hanya membaca, cukup pesan:baca dan kontak:baca.

2. 2

   Langkah 2: Coba dulu dengan kunci test

   Kunci test menjalankan semua pemeriksaan tanpa mengirim apa pun ke pelanggan dan tanpa mengubah data — aman untuk mencoba alur kirim pesan, broadcast, dan Inbox.

2. Claude Code#

Jalankan di terminal (ganti KUNCI_API_ANDA), lalu ketik /mcp di Claude Code untuk memastikan statusnya tersambung:

claude mcp add --transport http cswa https://mcp.cswa.ai \
  --header "Authorization: Bearer KUNCI_API_ANDA"

Cursor#

Buka Settings › MCP › Add new global MCP server, atau tempel ke ~/.cursor/mcp.json:

{
  "mcpServers": {
    "cswa": {
      "url": "https://mcp.cswa.ai",
      "headers": {
        "Authorization": "Bearer KUNCI_API_ANDA"
      }
    }
  }
}

VS Code#

Tempel ke .vscode/mcp.json di proyek, lalu klik Start di atas nama server. Mode Agent di Copilot Chat akan menampilkan alatnya.

{
  "servers": {
    "cswa": {
      "type": "http",
      "url": "https://mcp.cswa.ai",
      "headers": {
        "Authorization": "Bearer KUNCI_API_ANDA"
      }
    }
  }
}

Windsurf#

Tempel ke ~/.codeium/windsurf/mcp_config.json, lalu klik Refresh di panel MCP Cascade.

{
  "mcpServers": {
    "cswa": {
      "serverUrl": "https://mcp.cswa.ai",
      "headers": {
        "Authorization": "Bearer KUNCI_API_ANDA"
      }
    }
  }
}

n8n#

1. 1

   Langkah 1: Tambah node MCP Client Tool

   Di workflow dengan node AI Agent, tambah tool MCP Client Tool.

2. 2

   Langkah 2: Isi alamat & header

   MCP Client Tool Salin

   Node: MCP Client Tool (atau MCP Client)
   Endpoint: https://mcp.cswa.ai
   Server Transport: HTTP Streamable
   Authentication: Header Auth
     Name: Authorization
     Value: Bearer KUNCI_API_ANDA

3. 3

   Langkah 3: Pilih alat

   Pilih Tools to Include › Selected dan centang alat yang dipakai agen (mis. cari_percakapan, baca_percakapan, kirim_pesan).

Klien lain (mcp-remote)#

Klien yang hanya menerima server lokal (mis. Claude Desktop) bisa memakai jembatan mcp-remote — butuh Node.js 18+ di komputer:

{
  "mcpServers": {
    "cswa": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.cswa.ai",
        "--header",
        "Authorization:Bearer KUNCI_API_ANDA"
      ]
    }
  }
}

npx -y mcp-remote https://mcp.cswa.ai --header "Authorization:Bearer KUNCI_API_ANDA"

Daftar alat#

Pratinjau, konfirmasi & batas#

• kirim_pesan dan buat_broadcast selalu mengembalikan PRATINJAU dulu (penerima, isi, perkiraan waktu) beserta token_pratinjau. Baru dijalankan bila asisten memanggil ulang dengan isian sama, konfirmasi: true, dan token itu (berlaku 10 menit, sekali pakai).
• Batas lewat MCP: 30 permintaan/menit per kunci, 20 pesan/jam (WhatsApp Device), 60 pesan/jam (API Official), 5 broadcast/hari dan maks 1.000 penerima per broadcast. Volume lebih besar: pakai REST API atau dasbor.
• Isi chat pelanggan diapit penanda ⟦DATA_PELANGGAN⟧ — asisten diminta memperlakukannya sebagai data, bukan perintah, sehingga pesan pelanggan seperti "abaikan instruksi sebelumnya" tidak dijalankan.
• Pesan yang dikirim tercatat di Inbox sebagai "MCP · nama kunci"; semua panggilan tampil di tab Log.
• Cabut kunci di dasbor → asisten langsung tidak bisa masuk lagi.

Masalah umum#