سرور MCP
اجازه دهید عامل هوش مصنوعی تحلیل شما را بخواند: هفت ابزار روی Model Context Protocol، همه فقط‌خواندنی، با احراز هویت از کلید API موجود شما.
1. عامل چه می‌تواند بکند
کارخواه Model Context Protocol را به نقطهٔ پایانی وصل کنید تا بپرسد «کدام صفحه این ماه بیشترین کلیک خشمگینانه را دارد» یا «سه نشست آلمان طولانی‌تر از دو دقیقه نشان بده» و پیوند بازپخش نشست را بدهد.
| ابزار | پاسخ |
|---|---|
mp_projects | پروژه‌های قابل خواندن توسط این کلید |
mp_overview | نشست، فرد، بازدید صفحه، مدت و نشانهٔ نارضایتی |
mp_sessions | نشست اخیر با پیوند بازپخش، فیلتر کشور، دستگاه یا مدت |
mp_session | یک نشست: ترتیب صفحه، رویداد، مبدأ و دستگاه |
mp_pages | صفحه بر پایهٔ بازدید با بازدیدکنندهٔ یکتا |
mp_frustration | کلیک خشمگینانه، کلیک بی‌اثر و خطای JavaScript به‌ازای صفحه |
mp_goals | هدف‌های شما و تعداد تحقق هرکدام |
هر نشست گزارش‌شده پیوندی دارد که انسان می‌تواند باز کند. عامل خلاصه‌گو مفید است؛ عاملی که بیست ثانیهٔ مبنای خلاصه را هم نشان دهد قابل بررسی است.
2. اتصال
نقطهٔ پایانی POST را در این نشانی می‌پذیرد: /mcp و از Streamable HTTP با نسخهٔ پروتکل 2026-07-28 استفاده می‌کند.
احراز هویت کلید معمولی API خواندن MousePlayer است؛ همان نوع ساخته‌شده در تنظیمات، کلیدهای API و مورد پذیرش REST API. اعتبارنامهٔ دومی نیست. پس گرفتن کلید همان لحظه دسترسی عامل را می‌گیرد.
سپس پروژه را روشن کنید
کلید API تمام فضای کاری را باز می‌کند. این مورد عمداً نه: هر پروژه کلید خودش را در صفحهٔ یکپارچه‌سازی دارد و پیش‌فرض خاموش است. پروژهٔ خاموش در این مورد ظاهر نمی‌شود: mp_projects و حتی با حدس شناسه توسط عامل خوانده نمی‌شود.
کاغذبازی نیست. کلید API اسکریپت انتشار در محل تحت کنترل شماست؛ کلید در فایل پیکربندی عامل زمینهٔ مدل را تغذیه می‌کند و نگهداری سست‌تری دارد. آزاد کردن یک پروژه در هر بار کنترل مناسب است.
3. فقط‌خواندنی و دلیل ثابت ماندنش
هیچ‌کدام از هفت ابزار چیزی نمی‌نویسد. حذف، صدور یا تغییر پیکربندی پشت این نقطهٔ پایانی نیست؛ چون ابزاری که عامل می‌تواند فراخوانی کند ممکن است اشتباهی هم فراخوانی کند.
چه برنمی‌گرداند
خود ضبط، تصویر DOM یا IP نمی‌دهد. عامل آنچه شخص در رابط می‌بیند همراه پیوند تماشای بقیه را می‌گیرد.
محدودیت نرخ و بازه
شصت درخواست در دقیقه به‌ازای کلید، مانند REST API. بازه حداکثر 365 روز و نتیجه 200 ردیف؛ پاسخ بریده‌شده اعلام می‌کند، چون فهرست بی‌صدای بریده دقیقاً کامل به نظر می‌رسد.
4. برای سازندهٔ کارخواه
سه روش: server/discover، tools/list، tools/call. بدون نشست، جریان GET یا Last-Event-ID - این‌ها متعلق به نسخه‌های تا 2025-11-25 هستند و جزو این نسخه نیستند. GET یا DELETE پاسخ 405 می‌گیرد.
هر POST این مورد را دارد: MCP-Protocol-Version، Mcp-Method و برای tools/call، Mcp-Name، و هرکدام باید با بدنه منطبق باشد. عدم تطبیق این است: 400 با خطای JSON-RPC -32020؛ نسخهٔ پشتیبانی‌نشده این است: 400 با -32022 و فهرست نسخه‌های پشتیبانی‌شده تا کارخواه یکی را برگزیند و دوباره تلاش کند.
عمداً دو نوع خطا
درخواست بدشکل یا ابزار ناشناخته خطای JSON-RPC است. «پروژه آزاد نشده» یا «چنین نشستی نیست» نتیجهٔ عادی با این مورد است: isError: true - چون مدل از نوع دوم با پرسیدن این مورد بازیابی می‌کند: mp_projects و دوباره تلاش می‌کند، اما از اولی نمی‌تواند بازیابی کند.
نتیجه هم این مورد را دارد: structuredContent و هم همان داده را سریال‌شده در بلوک متن تا کارخواه قدیمی هم چیز مفید ببیند.
همهٔ علائم تجاری نام‌برده متعلق به مالکانشان‌اند. MousePlayer با این ارائه‌دهندگان رابطهٔ تجاری ندارد.