شروع
اتصالِ دستیار
اول در پنل سرچ کنسول را وصل کنید. بعد همین آدرس را به دستیارتان بدهید و ورود را در صفحه‌ی همیار GSC تأیید کنید.
آدرسِ MCP
https://mcp-testgsc.hamyarsystem.com/mcpهیچ توکن یا کلیدی را در چت نچسبانید
اتصال با OAuth در مرورگر انجام می‌شود. اگر دستیار یا کسی از شما توکنِ گوگل یا کلیدِ API خواست، آن را ندهید.
Claude
claude.ai و اپِ دسکتاپِ Claude (ویندوز و مک)
- ۱
بخشِ Connectors را باز کنید
در Claude به «Settings» (در نسخه‌های تازه «Customize») بروید و «Connectors» را انتخاب کنید.
- ۲
یک connector سفارشی بسازید
روی «Add custom connector» بزنید.
- ۳
نام و آدرس را وارد کنید
در فیلدِ نام بنویسید «HamyarGSC» و در فیلدِ «Remote MCP server URL» این آدرس را بچسبانید:
https://mcp-testgsc.hamyarsystem.com/mcp - ۴
وصل شوید
روی «Add» و بعد «Connect» بزنید. صفحه‌ی ورودِ همیار GSC باز می‌شود.
- ۵
دسترسی را تأیید کنید
با شماره‌ی موبایلتان وارد شوید و در صفحه‌ی «Claude می‌خواهد به داده‌ی شما دسترسی بگیرد» روی «اجازه می‌دهم» بزنید.
- ۶
در یک گفتگوی تازه بپرسید
در گفتگوی جدید، از منوی ابزارها مطمئن شوید HamyarGSC روشن است و بپرسید: «پراپرتی‌های سرچ کنسول من را لیست کن.»
اگر Claude فهرستِ پراپرتی‌ها را نشان داد، اتصال کامل است.
در حساب‌های Team و Enterprise معمولاً فقط مالکِ سازمان می‌تواند connector سفارشی اضافه کند؛ از او بخواهید همین آدرس را در تنظیماتِ سازمان ثبت کند.
ChatGPT
chatgpt.com (پلن‌هایی که اپ‌ها و حالتِ توسعه‌دهنده را دارند)
- ۱
تنظیماتِ اپ‌ها را باز کنید
در ChatGPT به «Settings» و بعد «Apps & Connectors» بروید.
- ۲
حالتِ توسعه‌دهنده را روشن کنید (اگر خواست)
اگر گزینه‌ی ساختنِ اپ را نمی‌بینید، در «Advanced settings» گزینه‌ی «Developer mode» را فعال کنید.
- ۳
یک connector تازه بسازید
روی «Create» بزنید.
- ۴
مشخصات را پر کنید
نام: «HamyarGSC». در «MCP Server URL» این آدرس را بچسبانید و «Authentication» را روی «OAuth» بگذارید:
https://mcp-testgsc.hamyarsystem.com/mcp - ۵
بسازید و تأیید کنید
تیکِ «I trust this application» را بزنید و «Create» را بزنید. در صفحه‌ی ورودِ همیار GSC وارد شوید و «اجازه می‌دهم» را بزنید.
- ۶
در گفتگو فعالش کنید
در یک گفتگوی تازه، از دکمه‌ی «+» یا منوی ابزارها HamyarGSC را انتخاب کنید و سؤالتان را بپرسید.
اگر ChatGPT در پاسخ از ابزارهای همیار GSC استفاده کرد و فهرستِ پراپرتی‌ها را آورد، کار تمام است.
Codex
Codex CLI و افزونه‌ی Codex در VS Code/Cursor
- ۱
سرور را اضافه کنید
در ترمینال اجرا کنید:
$ codex mcp add hamyargsc --url https://mcp-testgsc.hamyarsystem.com/mcp - ۲
وارد شوید
مرورگر باز می‌شود؛ با موبایل وارد شوید و «اجازه می‌دهم» را بزنید:
$ codex mcp login hamyargsc - ۳
بررسی کنید
با این دستور ببینید سرور در فهرست هست، بعد یک جلسه‌ی تازه‌ی Codex باز کنید و بپرسید:
$ codex mcp list
اگر hamyargsc در فهرست بود و Codex در جلسه‌ی تازه پراپرتی‌ها را آورد، اتصال کامل است.
Claude Code
Claude Code در ترمینال، VS Code و JetBrains
- ۱
سرور را اضافه کنید
در ترمینال اجرا کنید (با scope=user در همه‌ی پروژه‌ها در دسترس است):
$ claude mcp add --transport http --scope user hamyargsc https://mcp-testgsc.hamyarsystem.com/mcp - ۲
احرازِ هویت کنید
Claude Code را باز کنید، دستورِ زیر را بزنید، hamyargsc را انتخاب کنید و «Authenticate» را بزنید. مرورگر باز می‌شود؛ وارد شوید و «اجازه می‌دهم» را بزنید.
/mcp - ۳
بررسی کنید
وضعیتِ سرور را از ترمینال ببینید:
$ claude mcp list
اگر جلوی hamyargsc علامتِ «connected» آمد، بپرسید: «پراپرتی‌های سرچ کنسول من را لیست کن.»
اتصال بارِ اول خطا داد؟
گاهی اولین تلاش در Claude یا ChatGPT ناکام می‌ماند. یک بار دیگر «Connect» را بزنید؛ اگر نشد، connector را حذف و دوباره اضافه کنید. جزئیات در عیب‌یابی.