Mulai menggunakan
SANAD MCP.

01 / PRASYARAT

Siapkan client dan akses.

Gunakan client yang mendukung MCP serta transport yang disediakan server. Pastikan koneksi dan scope penggunaan sudah dikonfigurasi oleh owner. Website ini tidak membuat kredensial atau membuka akses baru.

• Client mendukung tools MCP dan dapat menampilkan hasil terstruktur.
• Transport, autentikasi, serta izin sumber cocok dengan koneksi yang diberikan.
• Untuk contoh publik website, tidak diperlukan koneksi MCP; contoh telah tersimpan.

Endpoint dikonfigurasi oleh owner. Website ini tidak melakukan pemeriksaan koneksi langsung. Dukungan transport dan autentikasi mengikuti konfigurasi server serta client yang digunakan.

02 / KONEKSI

Pilih jalur yang sesuai.

Hubungkan ke ChatGPT atau Claude ?

ChatGPT melalui koneksi ATSAR yang disediakan owner

1. Gunakan koneksi/plugin ATSAR yang sudah dikonfigurasi pada client oleh owner. Koneksi tunnel uji merupakan koneksi terpisah dari domain HTTP.
2. Aktifkan tools koneksi tersebut, kemudian panggil list_sources untuk melihat sumber yang dapat diakses.
3. Panggil get_verse dengan referensi dan source ID eksplisit. Periksa ok, provenance, serta snapshot/engine pada respons.
4. Pisahkan hasil teks asli dari analisis yang disusun model client.

Evidence lokal 11 Oktober 2026 mencatat tiga panggilan melalui ChatGPT pada tunnel uji: list_sources, get_verse, dan get_tafsir. Owner telah menggunakan plugin ATSAR; catatan uji ini tidak menetapkan status seluruh koneksi owner.

Client dengan Streamable HTTP

1. Pastikan deployment yang diberikan owner memang melayani transport Streamable HTTP.
2. Masukkan endpoint di atas pada konfigurasi server MCP client. Gunakan autentikasi sesuai konfigurasi yang diberikan, bila diperlukan.
3. Lakukan initialize, tools/list, lalu panggil tool. Periksa hasil tool, bukan hanya respons health endpoint.

Adapter HTTP tersedia pada kode backend. Pemeriksaan 12 Oktober 2026 melalui hostname domain berhasil melakukan initialize, tools/list, dan get_verse untuk Tanzil 1:4 tanpa kredensial. Ini belum memverifikasi pemasangan pada setiap akun ChatGPT atau Claude. Nama menu dan format konfigurasi berbeda antar-client; tidak ada JSON konfigurasi universal pada panduan ini.

03 / REFERENSI TOOLS

Lima cara mengambil sumber.

Semua tools menerima snapshot_id dan retrieval_engine_id opsional. Jika tidak diberikan, server memilih binding sesuai konfigurasi. Nilai bahasa adalah ar atau id; jenis sumber quran, translation, atau tafsir.

Input strict: field yang tidak dikenal ditolak, dan angka berupa string tidak otomatis dikonversi. source_ids menerima 1–10 ID unik. Cursor terikat snapshot, engine, filter, dan limit; gunakan parameter yang konsisten saat melanjutkan halaman.

{
  "limit": 5
}

{
  "surah": 1,
  "ayah": 4,
  "quran_source_id": "tanzil-quran-uthmani-ar",
  "translation_source_id": "quranenc-indonesian-sabiq"
}

{
  "surah": 1,
  "ayah": 2,
  "tafsir_source_id": "quranenc-indonesian-mokhtasar"
}

{
  "query": "pembalasan",
  "language": "id",
  "source_ids": [
    "quranenc-indonesian-sabiq"
  ],
  "kind": "translation",
  "limit": 5
}

{
  "quote": "Hari Pembalasan",
  "language": "id",
  "source_ids": [
    "quranenc-indonesian-sabiq"
  ],
  "mode": "normalized",
  "limit": 5
}

04 / MEMBACA HASIL

Teks dan identitasnya.

Respons sukses memiliki ok: true, contract_version, snapshot_id, retrieval_engine_id, data, dan warnings. Di MCP, envelope aplikasi berada dalam hasil tool; periksa juga status error wrapper protokol.

Identitas

source_id, source_version_id, edition_id, publisher

Lokasi

reference, locator, upstream_url

Integritas

content_sha256, review_status, attribution

Catatan

footnotes: objek dengan format html, reference, text_original dan provenance, atau null

Checksum membantu memeriksa kesamaan byte teks terhadap versi yang dicatat. Ia bukan pengganti penilaian substansi atau izin penggunaan. Footnotes mempunyai checksum/provenance sendiri; HTML sumber harus disanitasi sebelum dirender oleh client.

05 / BATAS KEMAMPUAN

Pahami scope hasilnya.

• Pencarian leksikal menggunakan FTS dan trigram, bukan embeddings atau penalaran semantik.
• Normalized match dapat mengabaikan variasi harakat/tatweel Arab atau tanda baca/spasi Indonesia; teks asli tetap dipertahankan.
• Similar adalah kandidat kemiripan teks, bukan autentisitas, kesamaan makna, atau keputusan agama.
• Ambiguous berarti beberapa unit cocok sebelum limit. Truncated berarti daftar yang terlihat belum lengkap.
• Not_found berlaku pada sumber, bahasa, coverage, dan snapshot yang dicari.
• Published berarti tersedia secara operasional; status review dan rights tetap harus diperiksa.

Envelope aplikasi dibatasi 64 KiB dan wire MCP 256 KiB. Respons terlalu besar menghasilkan RESPONSE_TOO_LARGE; server tidak memotongnya diam-diam. Rights, freshness, expiry, dan withdrawal sumber dapat memengaruhi akses walaupun hasil pernah ditemukan sebelumnya.

06 / TROUBLESHOOTING

Bedakan error dari hasil kosong.

Koneksi gagal

Periksa transport, endpoint dan autentikasi client. Jangan menafsirkan kegagalan transport sebagai “tidak ada ayat”.

SNAPSHOT_UNAVAILABLE

Snapshot belum published atau akses sedang tidak tersedia. Periksa binding dan scope dengan owner.

SOURCE_NOT_FOUND / SOURCE_KIND_MISMATCH

Gunakan source ID dari list_sources dengan jenis yang sesuai tool.

INVALID_REFERENCE / CONTENT_NOT_AVAILABLE

Periksa surah, ayah, skema edisi, dan coverage sumber.

CURSOR_MISMATCH

Jangan mengganti filter, limit, snapshot, atau engine di tengah pagination.

DATABASE_UNAVAILABLE / QUERY_TIMEOUT

Error ditandai retryable. Ikuti kebijakan retry client; hindari retry tanpa batas.

Error aplikasi memiliki ok: false dan error berisi code, message, retryable serta details. Binding dapat null dan tidak ada field warnings pada envelope gagal. Kegagalan validasi SDK atau JSON-RPC dapat terjadi sebelum envelope aplikasi dibuat.