WebMCP

Alexandra Klepper
Alexandra Klepper
GitHub Bluesky

Dipublikasikan: 18 Mei 2026, Terakhir diperbarui: 5 Juni 2026

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

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

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 akan mendeklarasikan tujuan elemen, sehingga digunakan dengan benar

Hal ini lebih andal daripada aktivasi, yang mungkin memiliki banyak langkah dan membuat setiap langkah terbuka untuk interpretasi 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 sesuai harapan. Hal ini juga menjaga merek dan pilihan desain yang berpusat pada manusia 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 agen, sehingga pengguna 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 menavigasi ke formulir yang tepat dengan lebih cepat dan mengisi kolom dengan informasi yang diberikan pengguna.
  • Meningkatkan pemesanan perjalanan. Membantu agen memesan perjalanan yang kompleks, multi-kota, dan multi-penumpang dengan lebih sedikit langkah.

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

Dalam arti praktis, alat Anda dapat menyelesaikan tugas berikut:

  • Mengisi formulir terstruktur: Membuat 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 didesain 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 reservasi atau acara.
  • Proses debug 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 bagikan masukan Anda.

Mulai

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

Untuk mengaktifkan WebMCP secara lokal:

  1. Buka Chrome dan buka chrome://flags/#enable-webmcp-testing
  2. Tetapkan flag ke Diaktifkan.
  3. Mulai ulang Chrome untuk menerapkan perubahan.

Menggunakan WebMCP API

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

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

Batasan

Meskipun WebMCP bertujuan untuk membuat tugas yang kompleks menjadi lebih sederhana 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 dan konteks browser yang terlihat. Dengan kata lain, tidak ada dukungan untuk agen atau alat bantu untuk memanggil alat dalam status tanpa tampilan.
  • Overhead yang 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.

Keamanan dan izin

WebMCP API dibatasi oleh persyaratan isolasi origin dan kebijakan izin.

Isolasi origin

WebMCP hanya tersedia dalam dokumen yang diisolasi origin. Hal ini memastikan bahwa origin dokumen tetap stabil selama masa aktif alat.

Jika dokumen memiliki document.domain yang diaktifkan (misalnya, dengan menggunakan header HTTP Origin-Agent-Cluster: ?0), WebMCP API akan dinonaktifkan.

Kebijakan izin

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

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

Demo

Contoh demo yang mencakup penerapan imperatif dan deklaratif tersedia:

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

Meniru chat agen dengan ekstensi inspektur

Instal Ekstensi Inspektur Alat Konteks Model untuk bereksperimen dengan agen dan melihat cara kerja alat WebMCP dalam demo langsung atau aplikasi Anda sendiri. Gunakan perintah bahasa alami untuk menentukan apakah agen berinteraksi dengan alat WebMCP sesuai harapan.

Dengan ekstensi ini, Anda dapat:

  • Melihat alat mana yang terdaftar di halaman, dengan memantau WebMCP API.
  • Memanggil alat dan menjalankan fungsi secara manual.
  • Memverifikasi bahwa Skema JSON Anda ditentukan dengan benar dan browser dapat mengurai data seperti yang diharapkan alat.
  • Melihat 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.

Berinteraksilah 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 membagikan masukan

WebMCP sedang dalam diskusi aktif dan dapat berubah di masa mendatang. Jika Anda mencoba API ini dan memiliki masukan, kami ingin mendengarnya.