WebMCP

Alexandra Klepper
Alexandra Klepper
GitHub Bluesky

Dipublikasikan: 18 Mei 2026

WebMCP adalah standar web yang diusulkan untuk membantu Anda membangun dan mengekspos alat terstruktur untuk agen AI. WebMCP menyediakan JavaScript dan memberi anotasi pada elemen formulir HTML sehingga agen mengetahui persis cara berinteraksi dengan fitur halaman, untuk mendukung pengalaman pengguna. Hal ini dapat meningkatkan performa dan keandalan penggerak agen secara signifikan.

Agen AI adalah teknologi yang lebih baru. LLM dapat membantu pengguna manusia menyelesaikan tugas yang sangat kompleks dan teknis dengan lebih baik. WebMCP menawarkan akurasi yang lebih tinggi untuk penyelesaian tugas agentik, dan dapat ditambahkan sebagai peningkatan progresif.

Mengapa WebMCP?

WebMCP dapat membantu Anda menjembatani kesenjangan antara aplikasi web dan agen, meningkatkan efisiensi, keandalan, dan penyelesaian tugas, dengan memberikan aturan untuk interaksi. Daripada agen meninjau elemen, seperti tombol atau kolom, untuk memahami tujuannya, situs menyatakan tujuan elemen, sehingga elemen digunakan dengan benar

Hal ini lebih andal daripada penggerak, yang mungkin memiliki banyak langkah dan membuat setiap langkah terbuka untuk ditafsirkan oleh agen.

Situs dapat membagikan tujuan eksplisit, seperti penelusuran atau pembelian, dengan menentukan tool. Alat dijalankan di halaman web Anda secara terlihat, sehingga pengguna mendapatkan kepercayaan bahwa tugas diselesaikan seperti yang diharapkan. Hal ini juga menjaga pilihan desain yang berfokus pada manusia dan merek Anda tetap utuh.

WebMCP mendukung:

  • Penemuan: Cara standar bagi halaman untuk mendaftarkan alat dengan agen, seperti checkout atau filter_results.
  • Skema JSON: Definisi eksplisit input dan output yang diharapkan, untuk mengurangi halusinasi atau kesalahpahaman.
  • Status: Pemahaman bersama tentang konteks halaman saat ini, sehingga agen mengetahui resource apa yang tersedia untuk ditindaklanjuti secara real time.

Tujuan kami adalah membuat API yang dapat diterapkan dan dimanfaatkan oleh browser apa pun dengan kemampuan agentik, sehingga pengguna Anda dapat menyelesaikan tugas dengan lebih mudah. Anda dapat mengikuti proses ini di GitHub.

Kasus penggunaan

Ada banyak cara untuk menggunakan WebMCP di web. Contoh:

  • Membantu pelanggan mendapatkan dukungan. Jika Anda menyediakan software kepada pelanggan, Anda mungkin memiliki alur dukungan yang kompleks untuk menjawab berbagai pertanyaan. Anda dapat menggunakan WebMCP untuk membantu agen membuka formulir yang tepat dengan lebih cepat dan mengisi kolom dengan informasi yang diberikan pengguna.
  • Meningkatkan kualitas pemesanan perjalanan. Membantu agen memesan perjalanan yang rumit, ke beberapa kota, dan untuk beberapa penumpang dengan lebih sedikit langkah.

Beberapa tindakan mungkin sensitif, seperti melakukan pembelian. Anda dapat menyertakan perintah untuk meminta interaksi pengguna dengan dialog konfirmasi.

Secara praktis, alat Anda dapat menyelesaikan tugas berikut:

  • Mengisi formulir terstruktur: Buat alat submit_application untuk membantu agen memetakan data yang dikumpulkan dari percakapan dengan pengguna ke kolom formulir dengan benar. Misalnya, Anda dapat membedakan apakah kolom memerlukan nama lengkap atau nama depan dan nama belakang yang terpisah.
  • Mendukung interaksi agen di antarmuka yang mengutamakan manusia: Kolom tertentu dirancang untuk pengguna manusia, tetapi mungkin tidak dipahami oleh agen. Anda dapat membuat alat date_pick yang memungkinkan pemilihan tanggal dan waktu yang kompleks dalam pemesanan acara atau reservasi.
  • Penelusuran bug aplikasi yang lebih cepat: Anda dapat membuat alat run_diagnostics di halaman setelan developer, sehingga agen dapat memicu perbaikan yang biasanya tersembunyi di balik menu bertingkat.

Apakah kasus penggunaan Anda tidak ada? Atau, apakah Anda memiliki ide yang ingin dibagikan untuk WebMCP? Bergabunglah dengan program pratinjau awal dan berikan masukan Anda.

Mulai

WebMCP tersedia sebagai tanda Chrome untuk pengembangan lokal. Fitur ini akan tersedia dalam uji coba origin di Chrome 149.

Untuk mengaktifkan WebMCP secara lokal:

  1. Buka Chrome, lalu buka chrome://flags/#enable-webmcp-testing
  2. Tetapkan flag ke Enabled.
  3. Luncurkan kembali Chrome untuk menerapkan perubahan.

Menggunakan WebMCP API

Ada dua API yang dapat Anda gunakan untuk menyiapkan alat situs:

  • API Imperatif: Tentukan berbagai jenis alat dengan JavaScript standar, seperti input formulir, alat navigasi, pengelolaan status, atau fungsi lainnya.
  • Declarative API: Tambahkan anotasi ke formulir HTML standar untuk membuat alat WebMCP.

Batasan

Meskipun WebMCP bertujuan menyederhanakan tugas yang kompleks bagi agen dan manusia, ada beberapa batasan:

  • Konteks penjelajahan diperlukan: Karena panggilan alat ditangani di JavaScript, tab browser atau webview harus dibuka untuk menyediakan antarmuka yang terlihat dan konteks browser. Dengan kata lain, tidak ada dukungan untuk agen atau alat bantu untuk memanggil alat dalam status tanpa tampilan.
  • Overhead lebih besar untuk antarmuka yang kompleks: Jika situs Anda sangat kompleks, Anda mungkin perlu memfaktorkan ulang atau menambahkan JavaScript untuk menangani status aplikasi dan antarmuka.
  • Kemudahan penemuan alat: Klien dan browser harus mengunjungi situs secara langsung untuk mengetahui apakah situs tersebut memiliki alat yang dapat dipanggil.

Kebijakan izin

Kedua API ini dibatasi oleh Kebijakan Izin tools. Kebijakan ini secara default ditetapkan ke self, yang memungkinkan pendaftaran alat dalam konteks tingkat teratas dan origin yang sama, serta menonaktifkannya untuk iframe lintas origin.

Untuk mengizinkan alat WebMCP di iframe lintas origin, tambahkan atribut allow="tools" ke iframe.

Demo

Contoh demo yang mencakup penerapan imperatif dan deklaratif tersedia:

Anda juga dapat meninjau dan menjelajahi kode sumber demo di GitHub.

Meniru percakapan chat agen dengan ekstensi pemeriksa

Instal Ekstensi Model Context Tool Inspector untuk bereksperimen dengan agen dan melihat cara kerja alat WebMCP dalam demo live atau aplikasi Anda sendiri. Gunakan perintah bahasa alami untuk menentukan apakah agen berinteraksi dengan alat WebMCP seperti yang diharapkan.

Dengan ekstensi ini, Anda dapat:

  • Lihat alat yang terdaftar di halaman, dengan memantau navigator.modelContext API.
  • Panggil alat dan jalankan fungsi secara manual.
  • Verifikasi bahwa Skema JSON Anda ditentukan dengan benar dan browser dapat mem-parsing data seperti yang diharapkan alat.
  • Lihat output terstruktur atau pesan error yang ditampilkan oleh alat Anda untuk memastikan output atau pesan error tersebut ditulis dengan jelas dan diformat dengan benar, sehingga agen dapat memahaminya.

Berbicara dengan agen menggunakan bahasa alami, untuk melihat apakah agen dapat mengidentifikasi dan memanggil alat WebMCP yang sesuai dengan benar. Perintah Anda dikirim secara default ke model gemini-3-flash-preview.

Berinteraksi dan memberikan masukan

WebMCP sedang dalam tahap pembahasan aktif dan dapat berubah sewaktu-waktu. Jika Anda mencoba API ini dan memiliki masukan, kami ingin mendengarnya.