মডেল কনটেক্সট প্রোটোকল (MCP) একটি উন্মুক্ত স্ট্যান্ডার্ড, যা লার্জ ল্যাঙ্গুয়েজ মডেল (LLM)-কে বাহ্যিক ডেটা এবং অ্যাপ্লিকেশনের সাথে নিরাপদে যোগাযোগ করতে সক্ষম করে। গুগল অ্যাডস MCP সার্ভারটি গুগল অ্যাডস API-এর সাথে একটি মানসম্মত সংযোগ স্থাপন করে, যা AI এজেন্টদের স্বাভাবিক ভাষা ব্যবহার করে ক্যাম্পেইনের ডেটা বিশ্লেষণ ও পুনরুদ্ধার করতে দেয়।
সম্প্রদায়ের সম্পদ এবং সহায়তা
গিটহাব রিপোজিটরি: google-ads-mcp রিপোজিটরিতে ডেমো, উদাহরণ খুঁজুন এবং বাগ রিপোর্ট করুন বা ফিচারের পরামর্শ দিন।
বাগ রিপোর্ট এবং ফিচার অনুরোধের জন্য Issues ট্যাবটি ব্যবহার করুন।
কমিউনিটি: গুগল অ্যাডভার্টাইজিং কমিউনিটি ডিসকর্ড- এর
#ads-api-ai-toolsচ্যানেলে যোগদান করুন।
প্রযুক্তিগত সংক্ষিপ্ত বিবরণ
এই এমসিপি সার্ভারটি প্রয়োগ করার মাধ্যমে, গুগল অ্যাডস এপিআই অথেন্টিকেশন, রিসোর্স ফেচিং এবং ডেটা পার্সিং-এর জন্য কাস্টম 'গ্লু কোড' লেখার প্রয়োজনীয়তা দূর হয়। সার্ভারটি এমন কিছু নির্দিষ্ট টুল সরবরাহ করে যা একজন এলএলএম স্বয়ংক্রিয়ভাবে খুঁজে বের করতে এবং ব্যবহার করতে পারে।
মূল স্পেসিফিকেশন
- প্রোটোকল: এমসিপি (মডেল কনটেক্সট প্রোটোকল)
- মোড: শুধুমাত্র পঠনযোগ্য (বর্তমান সংস্করণ)
- ভাষা: পাইথন
- ট্রান্সপোর্ট: স্ট্যান্ডার্ড ইনপুট/আউটপুট (
stdio) - প্রমাণীকরণ: OAuth 2.0 অথবা পরিষেবা অ্যাকাউন্ট
ইন্টারঅ্যাকশন লুপ কীভাবে কাজ করে
- অনুরোধ: একজন ব্যবহারকারী "এই সপ্তাহে আমার ক্যাম্পেইনের পারফরম্যান্স কেমন?" -এর মতো একটি প্রশ্ন জমা দেন।
- আবিষ্কার: এলএলএম তার উপলব্ধ সরঞ্জামগুলি পরীক্ষা করে এবং
google-ads-mcpঅনুসন্ধান ক্ষমতা শনাক্ত করে। - কার্য সম্পাদন: এমসিপি সার্ভার গুগল অ্যাডস এপিআই-কে কোয়েরি করার জন্য অন্তর্নিহিত পাইথন লজিকটি সম্পাদন করে।
- কনটেক্সট ইনজেকশন: কাঠামোগত ফলাফল LLM-এর কনটেক্সট উইন্ডোতে ফেরত পাঠানো হয়।
- প্রতিক্রিয়া: এলএলএম উপাত্তগুলোকে সংশ্লেষণ করে একটি পাঠযোগ্য উত্তরে পরিণত করে।
শুরু করুন
গুগল অ্যাডস এমসিপি সার্ভার কনফিগার ও ব্যবহার করতে এই ধাপগুলো অনুসরণ করুন।
পূর্বশর্ত
কনফিগারেশন করার আগে, গুগল অ্যাডস ডেভেলপার কনসোল থেকে আপনার কাছে নিম্নলিখিত ক্রেডেনশিয়ালগুলো আছে কিনা তা নিশ্চিত করুন:
- ডেভেলপার টোকেন: আপনার অনন্য ২২-অক্ষরের অ্যাক্সেস স্ট্রিং।
- প্রজেক্ট আইডি: আপনার গুগল ক্লাউড প্রজেক্ট শনাক্তকারী।
- OAuth ক্রেডেনশিয়াল: হয় একটি OAuth2 ক্লায়েন্ট আইডি/ক্লায়েন্ট সিক্রেট জোড়া, অথবা অ্যাপ্লিকেশনটির ডিফল্ট ক্রেডেনশিয়ালের একটি সেট।
কনফিগারেশন
সার্ভারটিকে একটি MCP-উপযোগী হোস্টে সংযুক্ত করতে, আপনার হোস্টের MCP কনফিগারেশন ফাইলে, যেমন settings.json , নিম্নলিখিত এন্ট্রিটি যোগ করুন। এই কনফিগারেশনটির সঠিক অবস্থান এবং ফাইলের নামের জন্য আপনার হোস্টের ডকুমেন্টেশন দেখুন।
JSON
{
"mcpServers": {
"google-ads-mcp": {
"command": "pipx",
"args": [
"run",
"--spec",
"git+https://github.com/googleads/google-ads-mcp.git",
"google-ads-mcp"
],
"env": {
"GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID",
"GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_DEVELOPER_TOKEN"
}
}
}
}
গুগল ক্লাউডে স্থাপন
এই এমসিপি সার্ভারটি স্থানীয়ভাবে হোস্ট করার পরিবর্তে, আপনি এটিকে গুগল ক্লাউড রান বা অন্য কোনো ক্লাউড-ভিত্তিক পরিকাঠামোতে হোস্ট করতে পারেন। এটি তখন কাজে আসে যখন আপনি সার্ভারটি বিভিন্ন এজেন্টের মধ্যে শেয়ার করতে চান অথবা এটিকে একটি ওয়েব সার্ভিস হিসেবে চালাতে চান।
পূর্বশর্ত
- একটি গুগল ক্লাউড প্রকল্প।
gcloudকমান্ড-লাইন টুলটি ইনস্টল, প্রমাণীকৃত এবং একটি সক্রিয় প্রজেক্ট কনফিগার করা আছে:gcloud config set project YOUR_PROJECT_ID
একটি ডকার ইমেজ তৈরি করুন এবং পুশ করুন
স্থানীয়ভাবে ডকার ইনস্টল করার প্রয়োজন ছাড়াই আপনি ক্লাউড বিল্ড ব্যবহার করে ইমেজটি বিল্ড করে আর্টিফ্যাক্ট রেজিস্ট্রি-তে পুশ করতে পারেন।
আর্টিফ্যাক্ট রেজিস্ট্রি-তে একটি রিপোজিটরি তৈরি করুন:
gcloud artifacts repositories create mcp-servers --repository-format=docker --location=us-central1ছবিটি তৈরি করে জমা দিন:
gcloud builds submit --tag us-central1-docker.pkg.dev/YOUR_PROJECT_ID/mcp-servers/google-ads-mcp:latest .মনে রাখবেন, যখনই আপনি ডেপ্লয় করা সার্ভারটিকে সর্বশেষ সংস্করণে আপডেট করতে চাইবেন, তখনই এই ধাপটি অবশ্যই সম্পন্ন করতে হবে।
গুগল ক্লাউড রানে স্থাপন করুন
প্রয়োজনীয় এনভায়রনমেন্ট ভেরিয়েবলগুলো সেট করতে ভুলবেন না:
-
GOOGLE_PROJECT_ID: আপনার গুগল ক্লাউড প্রজেক্ট আইডি। -
GOOGLE_ADS_DEVELOPER_TOKEN: যে ডেভেলপার টোকেনটি আপনি MCP সার্ভারকে ব্যবহার করাতে চান। -
GOOGLE_ADS_MCP_OAUTH_CLIENT_ID: যে OAuth ক্লায়েন্ট আইডিটি আপনি MCP সার্ভারকে ব্যবহার করাতে চান। -
GOOGLE_ADS_MCP_OAUTH_CLIENT_SECRET: যে OAuth ক্লায়েন্ট সিক্রেটটি আপনি MCP সার্ভারকে ব্যবহার করাতে চান। -
GOOGLE_ADS_MCP_BASE_URL: এটি হলো সেই বেস ইউআরএল যেখান থেকে আপনার এমসিপি সার্ভারটি অ্যাক্সেসযোগ্য: আপনার প্রথম ডেপ্লয়মেন্টের পর গুগল ক্লাউড রান এটি স্বয়ংক্রিয়ভাবে নির্ধারণ করে দেবে। ডেপ্লয়মেন্টের পর আপনি এনভায়রনমেন্ট ভেরিয়েবলগুলো আপডেট করতে পারেন। -
FASTMCP_HOST: FastMCP-কে সকল আইপি অ্যাড্রেস থেকে কানেকশন গ্রহণ করার অনুমতি দিতে এটিকে 0.0.0.0-এ সেট করুন।
gcloud run deploy google-ads-mcp \
--image us-central1-docker.pkg.dev/YOUR_PROJECT_ID/mcp-servers/google-ads-mcp:latest \
--platform managed \
--region us-central1 \
--allow-unauthenticated \
--set-env-vars="GOOGLE_PROJECT_ID=YOUR_PROJECT_ID,GOOGLE_ADS_DEVELOPER_TOKEN=YOUR_DEVELOPER_TOKEN,GOOGLE_ADS_MCP_OAUTH_CLIENT_ID=YOUR_CLIENT_ID,GOOGLE_ADS_MCP_OAUTH_CLIENT_SECRET=YOUR_CLIENT_SECRET,GOOGLE_ADS_MCP_BASE_URL=YOUR_BASE_URL,FASTMCP_HOST=0.0.0.0"
এমসিপি ক্লায়েন্ট কনফিগার করুন
ডেপ্লয়মেন্টের পরে, ক্লাউড রান ইউআরএল ব্যবহার করার জন্য আপনার এমসিপি ক্লায়েন্ট কনফিগারেশন (উদাহরণস্বরূপ, ~/.gemini/settings.json ) আপডেট করুন।
{
"mcpServers": {
"google-ads-mcp": {
"httpUrl": "https://your-cloud-run-url.a.run.app/mcp"
}
}
}
মূল সক্ষমতা (সরঞ্জাম)
সার্ভারটি অ্যাকাউন্ট শনাক্তকরণ এবং পারফরম্যান্স রিপোর্টিংয়ের জন্য ডিজাইন করা টুলগুলো সরবরাহ করে:
-
list_accessible_customers: প্রমাণীকৃত ব্যবহারকারীর জন্য অ্যাক্সেসযোগ্য Google Ads গ্রাহক আইডি এবং অ্যাকাউন্টের নামের তালিকা ফেরত দেয়। -
search: রিসোর্স মেট্রিক্স, বাজেট এবং স্ট্যাটাস আনার জন্য গুগল অ্যাডস কোয়েরি ল্যাঙ্গুয়েজ (GAQL) অনুরোধ কার্যকর করে। get_resource_metadata: একটি Google Ads API রিসোর্স টাইপ, যেমন 'campaign', সম্পর্কিত মেটাডেটা পুনরুদ্ধার করে।ডেটার কাঠামো বুঝতে এবং কোয়েরি করার জন্য কোন ফিল্ডগুলো উপলব্ধ আছে তা জানতে এটি সহায়ক।
শুরু করার জন্য নমুনা প্রম্পট
সার্ভার কী করতে পারে তা জিজ্ঞাসা করুন :
What can the google-ads-mcp server do?
গ্রাহকদের সম্পর্কে জিজ্ঞাসা করুন :
What customers do I have access to?
প্রচারাভিযান সম্পর্কে জিজ্ঞাসা করুন :
How many active campaigns do I have?
How is my campaign performance this week?
Give me a report of the top spending campaigns split by device category over the
last 7 days for account 1234567890