Membina pelayan MCP Google Business Profile

Apa yang didedahkan oleh pelayan

Pelayan menggunakan pengangkutan HTTP strim dari spesifikasi MCP (transports), jadi tiada apa-apa untuk dipasang atau dijalankan secara tempatan. Alatnya terbahagi kepada tiga kelas, dan setiap alat membawa anotasi spesifikasi, jadi klien tahu sebelum memanggil sama ada alat hanya membaca, menukar data Reach sendiri atau menukar penyenaraian Google awam (anotasi alat).

Pelayan juga menawarkan gesaan MCP, arahan permulaan boleh guna semula spesifikasi (gesaan): satu mengoptimumkan profil satu perubahan yang disahkan pada satu masa, satu menyemak keterlihatan carian, dan satu bekerja melalui ulasan yang tidak dijawab. Klien menunjukkannya sebagai permintaan siap sedia.

Setiap alat memanggil prosedur pelayan yang sama yang dipanggil oleh papan pemuka Reach, melalui pemanggil dalam proses. Pemeriksaan akses lokasi, had pelan dan pemeriksaan sambungan Google oleh itu berjalan tepat seperti untuk pemilik yang log masuk; lapisan MCP tidak mempunyai laluan di sekelilingnya.

Sesi contoh, panggilan demi panggilan

Bagaimana perubahan sampai ke Google

Perubahan pada penyenaraian awam melalui pemilik dua kali. Pertama, alat tulis membawa destructiveHint, yang membolehkan klien menunjukkan gesaan kelulusannya sendiri. Kedua, penerangan setiap alat memberitahu model untuk menunjukkan perubahan tepat dan mendapatkan persetujuan eksplisit dalam perbualan. Suntingan profil dan perubahan media pergi lebih jauh dan lalai kepada pratonton yang tidak menulis apa-apa.

Suntingan profil mengambil dua panggilan. Yang pertama, dengan preview: true (lalai), mengembalikan setiap medan yang diubah sebelum dan selepas, mana-mana medan yang akan ditolak dengan pembetulan yang diperlukan, dan cap jari basedOn profil yang dibacanya. Panggilan kedua menulis hanya jika ia membawa cap jari itu dan profil tidak berubah sejak itu. Jika seseorang mengedit penyenaraian pada masa yang sama, dalam papan pemuka atau melalui penyegerakan Google, tulisannya ditolak dan pembantu mesti pratonton semula.

API Google sendiri menggunakan topeng kemas kini (locations.patch) untuk menggunakan medan yang dihantar. Ia tidak boleh tahu sama ada seseorang melihat perubahan itu. Pratonton dan cap jari meletakkan semakan itu di hadapannya, jadi model tidak boleh menggunakan suntingan basi atau tidak dilihat, walaupun pada percubaan semula.

Siaran dan balasan ulasan tidak mempunyai langkah pratonton, kerana teks yang diluluskan pemilik adalah perubahan itu sendiri. Penerangan mereka memerlukan pembantu menunjukkan siaran atau balasan tepat terlebih dahulu. Balasan yang disiarkan menggantikan sebarang balasan terdahulu dan tiada alat mengeluarkannya (reviews.updateReply), dan penerangan menyatakannya, jadi model boleh memberitahu pemilik sebelum mereka bersetuju.

Reach memilih pengesahan dalam perbualan berbanding baris cadangan-dan-lulus dalam Reach. Pemilik sudah berada dalam sembang, peti masuk kedua menambah langkah yang mudah diabaikan, dan spesifikasi MCP sudah menjangkakan manusia yang boleh menolak panggilan alat (pertimbangan keselamatan).

Pengawal yang tidak bergantung pada model

Spesifikasi mengatakan klien mesti menganggap anotasi alat sebagai tidak dipercayai melainkan ia datang dari pelayan yang dipercayai (anotasi alat), dan model boleh mengabaikan penerangan. Jadi pelayan menguatkuasakan peraturannya sendiri:

• Belanjawan tulis Google. Setiap perniagaan boleh membuat sehingga 20 perubahan Google sejam melalui pembantu. Model yang terperangkap dalam gelung mencapai had dan diberitahu berapa lama perlu menunggu, daripada menulis semula profil berulang kali.
• Keselamatan percubaan semula. Setiap perubahan menerima kunci idempoten. Ulangan dengan kunci yang sama mengembalikan hasil pertama dan bukannya menulis semula; tanpa kunci, panggilan serupa dalam tetingkap pendek dikira sebagai perubahan yang sama.
• Semakan lokasi pada setiap panggilan. Id lokasi yang dihantar model disemak terhadap akses Google langsung pemilik setiap kali, dengan semakan yang sama digunakan papan pemuka. Pelayan tidak menyimpan sesi untuk digunakan semula model.
• Nombor telefon disembunyikan. Petunjuk dan permintaan tempahan kembali dengan nombor telefon disembunyikan kepada empat digit terakhir, dalam nota juga. E-mel melalui, kerana pemilik memerlukannya untuk menjawab petunjuk.
• Pembatalan yang dikuatkuasakan pelayan. Pemilik boleh memutuskan sambungan pembantu dari skrin Penyambung AI dalam Reach, dan pelayan menolak token klien itu dari situ.

Memberitahu model apa yang tidak dapat dilihatnya

Pembantu yang menerima senarai kosong memberitahu pemilik “anda tiada ulasan”. Selalunya kebenarannya ialah data wujud tetapi tersembunyi: lokasi ditambah dari penyenaraian awamnya dan tiada sambungan Google, pelan tidak termasuk ciri, atau Google belum selesai penyegerakan pertama. Hasil bacaan oleh itu membawa senarai had yang menamakan sebab dan pautan yang membetulkannya. Senarai kosong bermakna tiada yang disembunyikan.

Hasil akaun melakukan perkara yang sama untuk ciri. Setiap satu ditandakan sebagai tersedia atau belum dibina, jadi model tidak menerangkan panggilan atau iklan sebagai perkara yang boleh dilakukan Reach hari ini. Apabila pemilik mahukan sesuatu yang tidak ada pada Reach, pembantu boleh menghantar permintaan kepada pasukan Reach dalam perkataan pemilik, selepas menunjukkan perkataan itu kepada mereka.

Setiap respons juga mengembalikan versi skema alat. Klien menyimpan cache skema alat dan boleh gagal secara senyap apabila satu berubah, jadi perubahan pecah muncul dalam respons dan dalam log Reach dan bukannya hanya dalam kadar ralat klien.

Log Masuk: OAuth 2.1, tiada kunci API

Pelayan adalah sumber dilindungi OAuth 2.1, seperti yang diterangkan spesifikasi kebenaran MCP (kebenaran). Ia menerbitkan metadata sumber dilindungi (RFC 9728), jadi klien mencari pelayan kebenaran sendiri, mendaftar sendiri dan membuka log masuk penyemak imbas. Pemilik log masuk dengan akaun Reach mereka; tiada kunci untuk ditampal.

Pelayan menyemak bahawa setiap token dikeluarkan untuk sumber ini dan bukan untuk perkhidmatan lain pada pelayan kebenaran yang sama, pertahanan timbalan keliru yang wujud penunjuk sumber (RFC 8707). Sambungan Google tidak pernah sampai ke pembantu: Reach memegangnya, dan pembantu hanya pernah memegang token Reach.

Itu juga sebab pemilik tidak memerlukan akses API Google. Google memberikan API Business Profiles setiap projek selepas permintaan akses (prasyarat), yang kebanyakan perniagaan kecil tidak pernah failkan.

Apa yang tidak boleh dilakukannya

• Ia tidak boleh menukar kategori utama atau alamat. Itu kekal dengan pemilik dalam alat Google sendiri.
• Ia tidak boleh memadam siaran atau mengeluarkan balasan ulasan. Balasan yang disiarkan boleh diganti, bukan dikeluarkan.
• Tanpa Google Business Profile yang bersambung ia hanya boleh membaca penyenaraian awam. Lokasi yang ditambah dari penyenaraian awamnya mendapat gambaran itu dan pautan untuk menyambung.
• Ia tidak boleh membuat lebih daripada 20 perubahan Google setiap perniagaan sejam melalui pembantu.
• Kedudukan carian meliputi kata kunci yang dikesan sahaja. Kata kunci baru tiada kedudukan sehingga semakan pertamanya berjalan.

Sambungkannya dalam Claude, ChatGPT atau Cursor

URL Pelayan

Mengenai pelayan Google Business Profile MCP Reach

Setiap klien menambah pelayan jauh secara berbeza, jadi langkah-langkah hidup pada satu halaman setiap klien: Claude, ChatGPT, Claude Code, Cursor dan VS Code. Vendor mendokumenkan perkara yang sama: Anthropic pada penyambung tersuai, OpenAI pada menyambung dari ChatGPT dan Cursor pada pelayan MCP.

Soalan lazim

Adakah saya perlukan akses API Google Business Profile untuk menggunakan pelayan MCP ini?

Tidak. Reach memegang sambungan Google, dan pembantu log masuk ke Reach dengan OAuth. API Google memerlukan projek Google Cloud yang diluluskan (prasyarat), yang dielakkan ini.

Pembantu AI mana yang berfungsi dengannya?

Mana-mana klien yang menyokong pelayan MCP jauh dengan log masuk OAuth, termasuk Claude, ChatGPT, Claude Code, Cursor, VS Code, Codex, Windsurf dan Cline.

Bolehkah pembantu menukar penyenaraian saya tanpa bertanya?

Perubahan ke Google melalui gesaan kelulusan klien dan persetujuan eksplisit dalam perbualan, dan suntingan profil memerlukan pratonton segar. Pelayan tidak boleh melihat perbualan, jadi pengawal yang dikuatkuasakannya sendiri ialah penolakan pratonton basi, had tulis Google setiap jam dan keselamatan percubaan semula.

Adakah ia berbayar?

Membaca tidak berbayar. Menggubal balasan ulasan menggunakan kredit Reach, dan sesetengah ciri bergantung pada pelan. Pelan Percuma meliputi satu lokasi.

Apa yang berlaku jika sambungan Google terputus?

Hasil akaun menunjukkan keadaan sambungan setiap lokasi. Jika ia tidak aktif, pembantu memberitahu pemilik untuk menyambung semula Google dalam Reach dan berhenti bekerja pada lokasi itu.

Sambungkan pembantu ke profil anda sendiri

Mulakan dengan soalan baca sahaja, seperti ulasan mana yang belum dijawab, kemudian luluskan satu perubahan kecil dan bacakan semula. Halaman persediaan akan membimbing setiap klien.

Sediakan pelayan MCP Google Business Profile

Buka AI Connectors dalam Reach