Koneksi & Konfigurasi MCP

Cara terhubung ke dan mengonfigurasi layanan MCP YunSell AI

Dokumen ini menjelaskan cara terhubung ke dan mengonfigurasi layanan MCP YunSell AI.

Prasyarat

API Key yang valid (sk-xxx)
Gateway sudah di-deploy dan mengekspos endpoint /mcp
Klien mendukung MCP Streamable HTTP

Konfigurasi klien

Tambahkan berikut ini ke konfigurasi MCP Anda:

{
  "mcpServers": {
    "yunsell": {
      "url": "http://www.mangoto.ai/mcp",
      "headers": {
        "Authorization": "Bearer sk-xxx"
      }
    }
  }
}

Field	Deskripsi
`mcpServers.yunsell`	Nama kunci layanan; nilai yang disarankan adalah `yunsell`
`url`	Alamat gateway + `/mcp`; harus berbagi origin yang sama dengan Base URL API
`headers.Authorization`	`Bearer` + API Key Anda

Ganti sk-xxx dengan API Key Anda.

Manajemen sesi

MCP Streamable HTTP menggunakan sesi:

Item	Deskripsi
Permintaan pertama	Server mengembalikan `Mcp-Session-Id` di header respons
Permintaan berikutnya	Klien harus mengirim `Mcp-Session-Id` yang sama di header permintaan
Akhiri sesi	`DELETE /mcp`

SDK klien biasanya mengelola sesi secara otomatis.

Autentikasi

Auth identik dengan V1 API
Berbagi penagihan, batas, dan pembatasan model API Key yang sama
Admin dapat menambahkan -{channelId} setelah Key untuk memilih channel (mis. sk-xxx-6)

Kegagalan auth mengembalikan HTTP 401 / 403.

Verifikasi koneksi

Setelah konfigurasi, verifikasi melalui protokol MCP:

Panggil tools/list dan pastikan Tools seperti list_models dan generate_image dikembalikan
Panggil list_models dan pastikan model yang dikembalikan mencakup supported_endpoint_types

Jika daftar Tool kosong atau kehilangan Tool yang diharapkan, periksa:

Apakah API Key valid dan saldo mencukupi
Apakah token membatasi model yang tersedia
Apakah model mendukung supported_endpoint_types yang sesuai

Pemecahan masalah

Gejala	Kemungkinan penyebab	Tindakan
Koneksi gagal	URL salah atau gateway tidak berjalan	Periksa Base URL dan keterjangkauan `/mcp`
401 / 403	Key tidak valid atau IP tidak ada di allowlist	Periksa pengaturan token
Daftar Tool tanpa gambar/video	Tidak ada izin untuk model tersebut	Panggil `list_models` dan periksa `supported_endpoint_types`
Video macet di queued	Antrean upstream	Poll dengan interval `next_poll_after_sec`; hindari permintaan terlalu sering
TTS mengembalikan error	Suara tidak valid	Panggil `list_audio_voices` terlebih dahulu untuk mendapatkan `code` yang benar

Dokumentasi terkait

Mulai Cepat

API Audio

Teks-ke-ucapan (TTS) dan kueri daftar suara

Skills

Instal paket yunsell-ai-skills untuk memanggil generasi multimodal dari percakapan Agent