Membangun server MCP Google Business Profile

Apa yang diekspos server

Server menggunakan transport HTTP streaming dari spesifikasi MCP (transports), jadi tidak ada yang perlu diinstal atau dijalankan secara lokal. Alat-alatnya terbagi dalam tiga kelas, dan setiap alat membawa anotasi spesifikasi, sehingga klien tahu sebelum memanggil apakah sebuah alat hanya membaca, mengubah data Reach sendiri, atau mengubah daftar Google publik (anotasi alat).

Server juga menawarkan prompt MCP, instruksi awal yang dapat digunakan ulang dari spesifikasi (prompt): satu mengoptimalkan profil satu perubahan terkonfirmasi pada satu waktu, satu meninjau visibilitas pencarian, dan satu menangani ulasan yang belum dijawab. Klien menampilkannya sebagai permintaan siap pakai.

Setiap alat memanggil prosedur server yang sama dengan yang dipanggil dasbor Reach, melalui pemanggil dalam proses. Pemeriksaan akses lokasi, batas paket, dan pemeriksaan koneksi Google karena itu berjalan persis seperti untuk pemilik yang masuk; lapisan MCP tidak punya jalan lain.

Contoh sesi, panggilan demi panggilan

Bagaimana perubahan sampai ke Google

Perubahan pada daftar publik melewati pemilik dua kali. Pertama, alat tulis membawa destructiveHint, yang memungkinkan klien menampilkan prompt persetujuannya sendiri. Kedua, setiap deskripsi alat memberi tahu model untuk menampilkan perubahan persis dan mendapatkan ya eksplisit dalam percakapan. Suntingan profil dan perubahan media melangkah lebih jauh dan default ke pratinjau yang tidak menulis apa pun.

Suntingan profil memerlukan dua panggilan. Yang pertama, dengan preview: true (default), mengembalikan sebelum dan sesudah setiap bidang yang diubah, bidang apa pun yang akan ditolak beserta perbaikan yang dibutuhkannya, dan sidik jari basedOn dari profil yang dibacanya. Panggilan kedua menulis hanya jika membawa sidik jari itu dan profil belum berubah sejak saat itu. Jika seseorang mengedit daftar sementara itu, di dasbor atau melalui sinkronisasi Google, penulisan ditolak dan asisten harus mempratinjau lagi.

API Google sendiri menerapkan bidang yang dikirimnya di bawah topeng pembaruan (locations.patch). Ia tidak dapat mengetahui apakah seseorang melihat perubahan itu. Pratinjau dan sidik jari menempatkan pemeriksaan itu di depannya, sehingga model tidak dapat menerapkan suntingan basi atau tak terlihat, bahkan saat mencoba ulang.

Posting dan balasan ulasan tidak memiliki langkah pratinjau, karena teks yang disetujui pemilik adalah perubahannya sendiri. Deskripsinya mengharuskan asisten menampilkan posting atau balasan persis terlebih dahulu. Balasan yang diposting menggantikan balasan sebelumnya dan tidak ada alat yang menghapusnya (reviews.updateReply), dan deskripsinya menyatakan demikian, sehingga model dapat memberi tahu pemilik sebelum mereka setuju.

Reach memilih konfirmasi dalam percakapan daripada antrean usul-dan-setujui di dalam Reach. Pemilik sudah ada di obrolan, kotak masuk kedua menambah langkah yang mudah diabaikan, dan spesifikasi MCP sudah mengharapkan manusia yang dapat menolak panggilan alat (security considerations).

Penjaga yang tidak bergantung pada model

Spesifikasi mengatakan klien harus memperlakukan anotasi alat sebagai tidak tepercaya kecuali berasal dari server tepercaya (tool annotations), dan model dapat mengabaikan deskripsi. Jadi server menegakkan aturannya sendiri:

• Anggaran penulisan Google. Setiap bisnis dapat membuat hingga 20 perubahan Google per jam melalui asisten. Model yang macet dalam putaran mencapai batas dan diberi tahu berapa lama harus menunggu, alih-alih menulis ulang profil berulang kali.
• Keamanan percobaan ulang. Setiap perubahan menerima kunci idempotensi. Pengulangan dengan kunci yang sama mengembalikan hasil pertama alih-alih menulis lagi; tanpa kunci, panggilan identik dalam jendela singkat dihitung sebagai perubahan yang sama.
• Pemeriksaan lokasi di setiap panggilan. ID lokasi yang dikirim model diperiksa terhadap akses Google langsung pemilik setiap kali, dengan pemeriksaan yang sama yang digunakan dasbor. Server tidak menyimpan sesi untuk digunakan ulang model.
• Nomor telepon yang disamarkan. Prospek dan permintaan pemesanan kembali dengan nomor telepon yang disamarkan hingga empat digit terakhir, termasuk di dalam catatan. Email tetap diteruskan, karena pemilik membutuhkannya untuk menjawab prospek.
• Pencabutan yang diberlakukan server. Pemilik dapat memutuskan asisten dari layar AI Connectors di Reach, dan server menolak token klien tersebut sejak saat itu.

Memberi tahu model apa yang tidak bisa dilihatnya

Asisten yang menerima daftar kosong memberi tahu pemilik "Anda tidak punya ulasan". Sering kali kebenarannya adalah data ada tetapi tersembunyi: lokasi ditambahkan dari daftar publiknya dan tidak memiliki koneksi Google, paket tidak menyertakan fitur, atau Google belum menyelesaikan sinkronisasi pertama. Hasil pembacaan karena itu membawa daftar keterbatasan yang menyebutkan alasan dan tautan yang memperbaikinya. Daftar kosong berarti tidak ada yang disembunyikan.

Hasil akun melakukan hal yang sama untuk fitur. Masing-masing ditandai sebagai tersedia atau belum dibuat, sehingga model tidak menggambarkan panggilan atau iklan sebagai hal yang bisa dilakukan Reach hari ini. Ketika pemilik menginginkan sesuatu yang tidak dimiliki Reach, asisten dapat mengirim permintaan ke tim Reach dengan kata-kata pemilik, setelah menunjukkan kata-kata itu kepada mereka.

Setiap respons juga mengembalikan versi skema alat. Klien menyimpan cache skema alat dan dapat gagal secara diam-diam saat skema berubah, sehingga perubahan yang merusak muncul di respons dan di log Reach, bukan hanya di tingkat kesalahan klien.

Masuk: OAuth 2.1, tanpa kunci API

Server adalah sumber daya yang dilindungi OAuth 2.1, seperti yang dijelaskan spesifikasi otorisasi MCP (authorization). Server menerbitkan metadata sumber daya yang dilindungi (RFC 9728), sehingga klien menemukan server otorisasi sendiri, mendaftarkan dirinya, dan membuka masuk browser. Pemilik masuk dengan akun Reach mereka; tidak ada kunci untuk ditempel.

Server memeriksa bahwa setiap token diterbitkan untuk sumber daya ini dan bukan untuk layanan lain di server otorisasi yang sama, pertahanan deputi bingung yang menjadi tujuan indikator sumber daya (RFC 8707). Koneksi Google tidak pernah mencapai asisten: Reach yang memegangnya, dan asisten hanya memegang token Reach.

Itu juga sebabnya pemilik tidak perlu akses API Google. Google memberikan API Business Profile per proyek setelah permintaan akses (prerequisites), yang jarang diajukan sebagian besar usaha kecil.

Yang tidak bisa dilakukannya

• Tidak dapat mengubah kategori utama atau alamat. Itu tetap pada pemilik di alat Google sendiri.
• Tidak dapat menghapus kiriman atau menghapus balasan ulasan. Balasan yang diposting dapat diganti, tidak dihapus.
• Tanpa Google Business Profile yang terhubung, ia hanya dapat membaca daftar publik. Lokasi yang ditambahkan dari daftar publiknya mendapatkan cuplikan itu dan tautan untuk terhubung.
• Tidak dapat membuat lebih dari 20 perubahan Google per bisnis per jam melalui asisten.
• Peringkat pencarian hanya mencakup kata kunci yang dilacak. Kata kunci baru tidak memiliki peringkat sampai pemeriksaan pertamanya berjalan.

Hubungkan di Claude, ChatGPT, atau Cursor

URL Server

Tentang server MCP Google Business Profile Reach

Setiap klien menambahkan server jarak jauh secara berbeda, jadi langkah-langkahnya ada di satu halaman per klien: Claude, ChatGPT, Claude Code, Cursor, dan VS Code. Vendor mendokumentasikan hal yang sama: Anthropic tentang custom connectors, OpenAI tentang connecting from ChatGPT dan Cursor tentang MCP servers.

Pertanyaan yang sering diajukan

Apakah saya perlu akses API Google Business Profile untuk menggunakan server MCP ini?

Tidak. Reach yang memegang koneksi Google, dan asisten masuk ke Reach dengan OAuth. API Google memerlukan proyek Google Cloud yang disetujui (prasyarat), yang dihindari oleh ini.

Asisten AI mana yang berfungsi dengannya?

Klien mana pun yang mendukung server MCP jarak jauh dengan masuk OAuth, termasuk Claude, ChatGPT, Claude Code, Cursor, VS Code, Codex, Windsurf, dan Cline.

Bisakah asisten mengubah daftar saya tanpa bertanya?

Perubahan ke Google melewati prompt persetujuan klien dan ya eksplisit dalam percakapan, dan edit profil memerlukan pratinjau baru. Server tidak dapat melihat percakapan, jadi penjaga yang ia terapkan sendiri adalah penolakan pratinjau basi, batas tulis Google per jam, dan keamanan percobaan ulang.

Apakah ini berbayar?

Membaca tidak memerlukan biaya. Menyusun balasan ulasan menggunakan kredit Reach, dan beberapa fitur bergantung pada paket. Paket Gratis mencakup satu lokasi.

Apa yang terjadi jika koneksi Google terputus?

Hasil akun menunjukkan status koneksi setiap lokasi. Jika tidak aktif, asisten memberi tahu pemilik untuk menghubungkan kembali Google di Reach dan berhenti mengerjakan lokasi itu.

Hubungkan asisten ke profil Anda sendiri

Mulailah dengan pertanyaan hanya-baca, seperti ulasan mana yang belum dijawab, lalu setujui satu perubahan kecil dan bacakan kembali. Halaman pengaturan memandu setiap klien.

Siapkan server MCP Google Business Profile

Buka AI Connectors di Reach