سرور MCP

Endpoint

https://app.monoranks.com/api/mcp

Streamable HTTP با پاسخ JSON، بدون session که لازم باشد نگهش دارید. کلید را در header به‌صورت bearer بفرستید، یا بگذارید کلاینت با OAuth شما را وارد کند (توضیحش پایین‌تر آمده).

اتصال

Claude Code

claude mcp add --transport http monoranks https://app.monoranks.com/api/mcp \
  --header "Authorization: Bearer mr_ws_…"

Claude.ai و Claude Desktop: به Settings → Connectors → Add custom connector بروید و آدرس بالا را وارد کنید. اگر کلاینت header از نوع bearer خواست، کلید را آنجا بگذارید؛ اگر نه، خودش شما را وارد می‌کند.

ChatGPT و بقیه کلاینت‌های OAuth: https://app.monoranks.com/api/mcp را به‌عنوان MCP server اضافه کنید. کلاینت /.well-known/oauth-protected-resource را می‌خواند و خودش را ثبت می‌کند؛ شما هم یک بار وارد می‌شوید و scopeهای خواندن را تأیید می‌کنید. scopeهای نوشتن هیچ‌وقت از این راه داده نمی‌شوند.

Toolها

خواندن

Tool	کارش	Scope
list_sites	سایت‌هایی که کلید به آن‌ها دسترسی دارد، با id هرکدام	sites:read
portfolio	همه سایت‌ها در یک درخواست: امتیازها و تغییرشان، مشکل‌ها، اکشن‌ها، آخرین بررسی و بررسی بعدی، و کلیک‌های Search Console (با search:read)	sites:read
site_summary	امتیازها، آخرین بررسی، مشکل‌های باز، دسترسی WordPress و اینکه داده هر اتصال چقدر تازه است	sites:read
speed_results	سرعت هر صفحه تست‌شده: تست آزمایشگاهی و داده بازدیدکننده‌های واقعی	sites:read
audit_status	آخرین بررسی‌ها، یا یک بررسی خاص با audit_id، همراه با تعداد صفحه‌های کراول‌شده و سقف صفحه	sites:read
list_issues	مشکل‌ها، همان لیست صفحه Issues	issues:read
issue_detail	یک مشکل با صفحه‌ها، شواهد، توضیح و مقدارهای جدید پیشنهادی (هر بار 100 مورد، برای بقیه suggestions_offset)	issues:read
list_actions	اکشن‌ها به ترتیب اولویت، با افزایش تخمینی امتیاز و مدتی که هرکدام باز مانده	issues:read
page_findings	یافته‌های یک صفحه، با id یا آدرس صفحه	pages:read
search_summary	جمع آمار Search Console، صفحه‌ها و عبارت‌های جست‌وجوی برتر	search:read
search_rows	ردیف‌های Search Console در یک بازه تاریخ، به تفکیک عبارت جست‌وجو، صفحه، عبارت و صفحه با هم، یا روز	search:read
ai_visibility	دستیارهای هوش مصنوعی هر هفته به سؤال‌هایی که دنبال می‌کنید چه جوابی داده‌اند	ai:read
answer_gaps	سؤال‌هایی که در جواب هوش مصنوعی اسم سایت‌های دیگر می‌آید، ولی اسم سایت شما نه	ai:read
geo_access	دسترسی خزنده‌های هوش مصنوعی، وضعیت llms.txt و سیگنال‌های هویت برند از آخرین بررسی	ai:read
llms_txt	فایل llms.txt فعلی سایت و یک پیش‌نویس آماده انتشار	ai:read
ai_crawler_rules	robots.txt همین الان به هر خزنده هوش مصنوعی چه می‌گوید	ai:read
agentic_results	نتیجه‌های Agentic browsing همراه با کارهایی که باید درست شوند، یا یک اجرای دوباره خاص با job_id	ai:read

انجام کار

Tool	کارش	Scope
recheck	بررسی دوباره یک مشکل را در صف می‌گذارد	issues:recheck
run_agentic_check	تست Agentic browsing را برای یک صفحه دوباره اجرا می‌کند	issues:recheck
start_audit	همین حالا یک بررسی کامل شروع می‌کند، با سقف صفحه اختیاری	audits:run
apply	عنوان سئو، توضیحات متا، canonical یا noindex جدید یک اکشن را تأیید می‌کند و در WordPress می‌نویسد	actions:apply
apply_llms_txt	یک llms.txt جدید را تأیید می‌کند و در WordPress می‌نویسد	actions:apply
apply_ai_crawler_rules	قوانین allow یا deny برای خزنده‌های هوش مصنوعی را تأیید می‌کند و در robots.txt می‌نویسد	actions:apply

site_id فقط وقتی لازم است که کلید به چند سایت دسترسی داشته باشد؛ id سایت‌ها را از list_sites بگیرید. اگر scope لازم را نداشته باشید، tool خطایی برمی‌گرداند که اسم همان scope در آن آمده. پاسخ toolها با REST API یکی است، پس جزئیاتی که آنجا نوشته‌ایم اینجا هم صدق می‌کند.

نمونه گفت‌وگو

«کدام سایتم این ماه بیشتر از بقیه کلیک از دست داده، و مهم‌ترین اکشن برایش چیست؟»

دستیار یک بار portfolio را صدا می‌زند، سایتی را که بیشترین افت را داشته پیدا می‌کند، بعد list_actions را برای همان سایت صدا می‌زند و اکشن اول را با افزایش تخمینی امتیازش جواب می‌دهد. اگر بگویید «اعمالش کن»، مقدارهای پیشنهادی را با issue_detail می‌خواند و apply را صدا می‌زند. تغییر هم در بخش فعالیت‌های اپ، همراه با دکمه Undo، نمایش داده می‌شود.