রিচ বাই লোকাস একটি রিমোট গুগল বিজনেস প্রোফাইল এমসিপি সার্ভার চালায়। একটি সহায়ক যেমন ক্লড, চ্যাটজিপিটি বা কার্সর OAuth দিয়ে সাইন ইন করে, একটি ব্যবসার প্রোফাইল, রিভিউ, র্যাঙ্কিং এবং লিড পড়ে, এবং একটি পাবলিক পরিবর্তন করে শুধুমাত্র মালিক চ্যাটে এটি অনুমোদন করার পরে। এই পোস্ট ব্যাখ্যা করে কিভাবে এটি তৈরি করা হয়েছে।
মালিক সেটআপ এমসিপি পৃষ্ঠায় এবং এর প্রতি-ক্লায়েন্ট গাইডে থাকে। এই পোস্ট ডেভেলপার এবং এআই নির্মাতাদের জন্য: সার্ভার কী প্রকাশ করে, কিভাবে একটি লেখা গুগলে পৌঁছায়, এবং এর পিছনের সিদ্ধান্ত। এটি মডেল কনটেক্সট প্রোটোকল স্পেসিফিকেশন অনুসরণ করে।
সার্ভার কী প্রকাশ করে
সার্ভার এমসিপি স্পেসিফিকেশন থেকে স্ট্রিমেবল HTTP ট্রান্সপোর্ট ব্যবহার করে (ট্রান্সপোর্ট), তাই স্থানীয়ভাবে কিছু ইনস্টল বা চালানোর প্রয়োজন নেই। এর টুলগুলি তিনটি শ্রেণীতে পড়ে, এবং প্রতিটি টুল স্পেসিফিকেশনের অ্যানোটেশন বহন করে, তাই একটি ক্লায়েন্ট কল করার আগে জানে যে একটি টুল শুধু পড়ে, রিচের নিজস্ব ডেটা পরিবর্তন করে বা একটি পাবলিক গুগল লিস্টিং পরিবর্তন করে (টুল অ্যানোটেশন)।
| শ্রেণী | এটি কী কভার করে | গুগলে পাবলিক? |
|---|---|---|
| পড়া | এটি কী কভার করেঅ্যাকাউন্ট এবং এর অবস্থান, প্রোফাইল বিষয়বস্তু, উত্তর অবস্থা সহ রিভিউ, পোস্ট এবং মিডিয়া, পারফরম্যান্স অ্যানালিটিক্স, ট্র্যাক করা-কীওয়ার্ড র্যাঙ্কিং এবং কাছাকাছি প্রতিযোগী, লিড এবং বুকিং অনুরোধ, এবং প্রতিটি প্রোফাইলে কী অনুপস্থিত তার একটি তালিকা | গুগলে পাবলিক?না |
| রিচের ভিতরে পরিবর্তন | এটি কী কভার করেরিভিউ-উত্তর খসড়া, কীওয়ার্ড ট্র্যাকিং শুরু বা বন্ধ করা, একটি সুপারিশ সম্পন্ন বা বাতিল হিসাবে চিহ্নিত করা, এবং রিচ টিমের কাছে একটি বৈশিষ্ট্য অনুরোধ পাঠানো | গুগলে পাবলিক?না |
| গুগল লেখা | এটি কী কভার করেপ্রোফাইল ফিল্ড এবং সার্ভিস-এরিয়া সম্পাদনা, ফটো এবং ভিডিও আপলোড এবং মুছে ফেলা, পোস্ট প্রকাশ করা, এবং রিভিউ উত্তর পোস্ট করা | গুগলে পাবলিক?হ্যাঁ |
সার্ভার এমসিপি প্রম্পটও অফার করে, স্পেসিফিকেশনের পুনর্ব্যবহারযোগ্য শুরু নির্দেশনা (প্রম্পট): একটি একটি নিশ্চিত পরিবর্তন করে প্রোফাইল অপ্টিমাইজ করে, একটি সার্চ দৃশ্যমানতা পর্যালোচনা করে, এবং একটি উত্তরহীন রিভিউ নিয়ে কাজ করে। একটি ক্লায়েন্ট তাদের প্রস্তুত-তৈরি অনুরোধ হিসাবে দেখায়।
প্রতিটি টুল একই সার্ভার পদ্ধতি কল করে যা রিচ ড্যাশবোর্ড কল করে, একটি ইন-প্রসেস কলারের মাধ্যমে। অবস্থান অ্যাক্সেস চেক, প্ল্যান সীমা এবং গুগল সংযোগ চেক তাই ঠিক একইভাবে চলে যেমন একটি সাইন-ইন করা মালিকের জন্য; এমসিপি স্তরের চারপাশে কোন পথ নেই।
একটি উদাহরণ সেশন, কল ধরে কল
দৃষ্টান্তমূলক সেশন: ক্লড-এ একজন ডেন্টাল ক্লিনিকের মালিক
মালিক টাইপ করেন: “গত মাসের রিভিউগুলো খুঁজে বের করো যেগুলোর উত্তর আমি দিইনি, আর অভিযোগগুলোর জবাব দিতে আমাকে সাহায্য করো।”
- সহকারী প্রথমে অ্যাকাউন্টটি পড়ে। ফলাফলে ক্লিনিকের অবস্থানগুলো তাদের আইডি, প্রতিটি গুগল সংযোগ সক্রিয় কিনা, প্ল্যান এবং অবশিষ্ট ক্রেডিট তালিকাভুক্ত থাকে।
- এটি অবস্থানের রিভিউ পড়ে, গত ৩০ দিনের উত্তরহীনগুলোতে ফিল্টার করে। প্রতিটি রিভিউ তার রেটিং, টেক্সট, তারিখ এবং উত্তর দেওয়ার অবস্থা সহ ফিরে আসে।
- অপেক্ষার সময় সম্পর্কে একটি 2-স্টার রিভিউর জন্য, এটি রিচ-কে খসড়া উত্তর চায়। খসড়া তৈরি করতে ক্রেডিট লাগে এবং প্রকাশ্যে কিছু বদলায় না। সহকারী বিকল্পগুলো দেখায়, এবং মালিক একটি সম্পাদনা করেন।
- পোস্ট করার আগে, সহকারী সঠিক লেখাটি দেখায় এবং হ্যাঁ চায়। মালিক রাজি হন, উত্তরটি গুগলে যায়, এবং ফলাফলটি সেই উত্তরটি ফেরত দেয় যা এটি প্রতিস্থাপন করেছে, যদি থাকে।
- উত্তরটি দেখা যাচ্ছে কিনা নিশ্চিত করতে সহকারী আবার রিভিউ পড়ে, তারপর কী বদলেছে তা জানায়।
পাঁচটি টুল কল, একটি পাবলিক পরিবর্তন, একটি স্পষ্ট অনুমোদন। খসড়াটি শুধুমাত্র সেই শব্দে গুগলে পৌঁছায় যা মালিক অনুমোদন করেছেন।
কীভাবে একটি পরিবর্তন গুগলে পৌঁছায়
পাবলিক লিস্টিংয়ে একটি পরিবর্তন মালিককে দুবার অতিক্রম করে। প্রথমত, রাইট টুলগুলোতে destructiveHint থাকে, যা ক্লায়েন্টকে নিজস্ব অনুমোদন প্রম্পট দেখাতে দেয়। দ্বিতীয়ত, প্রতিটি টুলের বর্ণনা মডেলকে সঠিক পরিবর্তনটি দেখাতে এবং কথোপকথনে একটি স্পষ্ট হ্যাঁ নিতে বলে। প্রোফাইল সম্পাদনা এবং মিডিয়া পরিবর্তন আরও এগিয়ে যায় এবং ডিফল্টভাবে একটি প্রিভিউতে যায় যা কিছুই লেখে না।
A profile edit takes two calls. The first, with preview: true (the default), returns each changed field’s before and after, any field that would be rejected with the fix it needs, and a basedOn fingerprint of the profile it read. The second call writes only if it carries that fingerprint and the profile has not changed since. If someone edited the listing in the meantime, in the dashboard or through a গুগল sync, the write is refused and the assistant must preview again.
গুগল’s own API applies the fields it is sent under an update mask (locations.patch). It cannot know whether a person saw the change. The preview and fingerprint put that check in front of it, so a model cannot apply a stale or unseen edit, even on a retry.
Posts and review replies have no preview step, because the text the owner approves is the change itself. Their descriptions require the assistant to show the exact post or reply first. A posted reply replaces any earlier reply and no tool removes it (reviews.updateReply), and the description says so, so the model can tell the owner before they agree.
রিচ chose confirmation in the conversation over a propose-and-approve queue inside রিচ. The owner is already in the chat, a second inbox adds a step that is easy to ignore, and the এমসিপি specification already expects a human who can deny a tool call (security considerations).
Guards that do not depend on the model
The specification says clients must treat tool annotations as untrusted unless they come from a trusted server (tool annotations), and a model can ignore a description. So the server enforces its own rules:
- A গুগল write budget. Each business can make up to 20 গুগল changes per hour through assistants. A model stuck in a loop hits the limit and is told how long to wait, instead of rewriting a profile again and again.
- Retry safety. Every change accepts an idempotency key. A repeat with the same key returns the first result instead of writing again; without a key, an identical call within a short window counts as the same change.
- Location checks on every call. The location id a model sends is checked against the owner’s live গুগল access each time, with the same check the dashboard uses. The server keeps no session for a model to reuse.
- Masked phone numbers. Leads and booking requests come back with phone numbers masked to the last four digits, inside notes too. Emails pass through, because an owner needs them to answer a lead.
- Revocation the server enforces. An owner can disconnect an assistant from the এআই Connectors screen in রিচ, and the server refuses that client’s token from then on.
Telling the model what it cannot see
An assistant that receives an empty list tells the owner “you have no reviews”. Often the truth is that data exists but is hidden: the location was added from its public listing and has no গুগল connection, the plan does not include a feature, or গুগল has not finished the first sync. Read results therefore carry a limitations list that names the reason and the link that fixes it. An empty list means nothing was hidden.
The account result does the same for features. Each one is marked as available or not built yet, so the model does not describe calls or ads as things রিচ can do today. When an owner wants something রিচ lacks, the assistant can send the request to the রিচ team in the owner’s words, after showing them the wording.
Every response also returns the tool’s schema version. Clients cache tool schemas and can fail quietly when one changes, so a breaking change shows up in the response and in রিচ’s logs rather than only in a client’s error rate.
সাইন-ইন: OAuth 2.1, কোনো API কী নেই
The server is an OAuth 2.1 protected resource, as the এমসিপি authorization specification describes (authorization). It publishes protected resource metadata (RFC 9728), so a client finds the authorization server on its own, registers itself and opens a browser sign-in. The owner signs in with their রিচ account; there is no key to paste.
The server checks that each token was issued for this resource and not for another service on the same authorization server, the confused-deputy defence that resource indicators exist for (RFC 8707). The গুগল connection never reaches the assistant: রিচ holds it, and the assistant only ever holds a রিচ token.
That is also why an owner does not need গুগল API access. গুগল grants the Business Profile APIs per project after an access request (prerequisites), which most small businesses never file.
এটি যা করতে পারে না
- It cannot change the primary category or the address. Those stay with the owner in গুগল’s own tools.
- It cannot delete a post or remove a review reply. A posted reply can be replaced, not removed.
- Without a connected গুগল বিজনেস প্রোফাইল it can only read the public listing. A location added from its public listing gets that snapshot and a link to connect.
- It cannot change the primary category or the address. Those stay with the owner in গুগল’s own tools.
- অনুসন্ধান র্যাঙ্ক শুধুমাত্র ট্র্যাক করা কীওয়ার্ডের জন্য প্রযোজ্য। একটি নতুন কীওয়ার্ডের প্রথম পরীক্ষা না হওয়া পর্যন্ত কোনো র্যাঙ্ক থাকে না।
এটি ক্লড, চ্যাটজিপিটি বা কার্সারে সংযুক্ত করুন
সার্ভার URL
https://reach.locus-intelligence.com/api/mcpরিচ গুগল বিজনেস প্রোফাইল এমসিপি সার্ভার সম্পর্কে
প্রতিটি ক্লায়েন্ট আলাদাভাবে রিমোট সার্ভার যোগ করে, তাই ধাপগুলো প্রতি ক্লায়েন্টের জন্য একটি পেজে থাকে: ক্লড, চ্যাটজিপিটি, ক্লড কোড, কার্সর এবং ভিএস কোড। বিক্রেতারা একই বিষয় নথিভুক্ত করে: অ্যানথ্রপিক কাস্টম কানেক্টর-এ, ওপেনএআই চ্যাটজিপিটি থেকে সংযোগ-এ এবং কার্সর এমসিপি সার্ভার-এ।
সাধারণ জিজ্ঞাসা
- এই এমসিপি সার্ভার ব্যবহার করতে কি আমার গুগল বিজনেস প্রোফাইল API অ্যাক্সেস দরকার?
- না। রিচ গুগল সংযোগ ধারণ করে, এবং সহকারী OAuth দিয়ে রিচে সাইন ইন করে। গুগলের API-এর জন্য একটি অনুমোদিত গুগল ক্লাউড প্রকল্প প্রয়োজন (পূর্বশর্ত), যা এড়ানো যায়।
- কোন এআই সহকারী এটির সাথে কাজ করে?
- যেকোনো ক্লায়েন্ট যেটি OAuth সাইন-ইনসহ রিমোট এমসিপি সার্ভার সমর্থন করে, যার মধ্যে রয়েছে ক্লড, চ্যাটজিপিটি, ক্লড Code, Cursor, VS Code, Codex, Windsurf এবং Cline।
- সহকারী কি জিজ্ঞাসা না করে আমার তালিকা পরিবর্তন করতে পারে?
- গুগলে পরিবর্তন ক্লায়েন্টের অনুমোদন প্রম্পট এবং কথোপকথনে একটি স্পষ্ট হ্যাঁ-এর মাধ্যমে যায় এবং প্রোফাইল সম্পাদনার জন্য একটি নতুন প্রিভিউ প্রয়োজন। সার্ভার কথোপকথন দেখতে পারে না, তাই এটি নিজে যে সুরক্ষাগুলি প্রয়োগ করে তা হল পুরানো প্রিভিউ প্রত্যাখ্যান, প্রতি ঘণ্টায় গুগল লেখার সীমা এবং পুনরায় চেষ্টা নিরাপত্তা।
- এর কি কোনো খরচ আছে?
- পড়া বিনামূল্যে। একটি পর্যালোচনার উত্তর খসড়া করতে রিচ ক্রেডিট ব্যবহার হয় এবং কিছু বৈশিষ্ট্য প্ল্যানের উপর নির্ভর করে। ফ্রি প্ল্যান একটি অবস্থান কভার করে।
- গুগল সংযোগ বিচ্ছিন্ন হলে কী হবে?
- অ্যাকাউন্ট ফলাফল প্রতিটি অবস্থানের সংযোগ অবস্থা দেখায়। এটি সক্রিয় না থাকলে, সহকারী মালিককে রিচে গুগল পুনরায় সংযোগ করতে বলে এবং সেই অবস্থানে কাজ করা বন্ধ করে দেয়।
আপনার নিজের প্রোফাইলে একটি সহকারী সংযুক্ত করুন
একটি শুধু-পঠন প্রশ্ন দিয়ে শুরু করুন, যেমন কোন রিভিউগুলোর উত্তর দেওয়া হয়নি, তারপর একটি ছোট পরিবর্তন অনুমোদন করুন এবং সেটি আবার পড়ে শোনান। সেটআপ পেজটি প্রতিটি ক্লায়েন্টের মাধ্যমে এগিয়ে যায়।
