اتصال Gmail، Google Sheets و Slack به سازنده‌ی اپ شما

حالا Mythex می‌تواند روی ابزارهایی که همین الان استفاده می‌کنید عمل کند. یک بار Gmail، Google Sheets، Slack، Notion یا صدها اپ دیگر را وصل کنید، سپس در گفتگو از عامل بخواهید یک شیت را بخواند، ایمیل بفرستد یا پیامی در کانال بگذارد. حساب شما به Mythex وصل می‌شود، نه به کد شما: عامل هرگز اطلاعات ورود را نمی‌بیند و چیزی وارد مخزن کد شما نمی‌شود.

چه کاری انجام می‌دهد

کانکتور پیوندی است بین حساب Mythex شما و حسابی که جای دیگری دارید. وقتی این پیوند برقرار شد، عامل می‌تواند وقتی در گفتگو از آن بخواهید، از آن حساب به نیابت از شما استفاده کند. برای نمونه:

شیت «Q4 pipeline» را بخوان و از روی آن یک داشبورد بساز

عامل مناسب‌ترین عمل را برای کار پیدا می‌کند، آرگومان‌های لازم را بررسی می‌کند، و آن را اجرا می‌کند. پشت این‌ها چهار ابزار قرار دارد:

اگر عامل به اپی نیاز داشته باشد که وصل نکرده‌اید، نوبت روی یک کارت با دکمه‌ی Connect متوقف می‌شود، نه یک لینک که در یک پاراگراف پنهان شده باشد. آن را فشار دهید، در برگه‌ای که باز می‌شود تأیید کنید، و برگردید — کارت متوجه می‌شود و به Connected تغییر می‌کند. دوباره بپرسید و عامل ادامه می‌دهد. در فاصله‌ی انتظار، داده‌ی شما را حدس نمی‌زند یا شیتی از خودش نمی‌سازد.

چرا آن را ساختیم

ساختن چیزی مفید معمولاً یعنی کار با داده‌ی واقعی: یک شیت از سرنخ‌ها، یک صندوق ورودی، یک کانال تیمی. راه معمول این است که یک کلید API بسازید، آن را در یک فایل تنظیمات بچسبانید، و امیدوار باشید هرگز به یک commit نرسد. برای یک غیرتوسعه‌دهنده این کار دست‌وپاگیر است و برای همه خطرناک.

کانکتورها کلید را از معادله بیرون می‌برند. با ارائه‌دهنده همان‌طور که جای دیگری وارد می‌شوید وارد می‌شوید (OAuth، به زبان تخصصی)، و اطلاعات ورود در سرویس اتصال Mythex می‌ماند:

• در حالت ذخیره‌شده رمزنگاری می‌شود
• هرگز در پروژه، فایل .env یا کد تولیدشده‌ی شما نوشته نمی‌شود
• هرگز به sandboxی که اپ شما در آن ساخته می‌شود فرستاده نمی‌شود — sandbox از سرور می‌خواهد درخواست را انجام دهد و نتیجه را برمی‌گرداند
• با قطع اتصال یا حذف حساب‌تان پاک می‌شود

نحوه‌ی استفاده

وصل کردن یک اپ

1. Connectors را باز کنید. در نوار کناری چپ زیر Projects است، و داخل یک پروژه می‌توانید روی + کنار کادر پیام بزنید و Connectors را انتخاب کنید. روی آنچه در حال انجامش بودید باز می‌شود، پس جای کارتان را از دست نمی‌دهید.
2. اپ را جست‌وجو کنید. جست‌وجو کل کاتالوگ را در بر می‌گیرد، نه فقط آنچه روی صفحه است.
3. روی Connect کلیک کنید. صفحه‌ی ورود ارائه‌دهنده در برگه‌ی جدید باز می‌شود، پس پروژه و هر پیام نیمه‌نوشته‌ی شما سر جای خودشان می‌مانند.
4. دسترسی را آنجا تأیید کنید.
5. به برگه‌ی Mythex برگردید. اپ یک نقطه‌ی سبز نشان می‌دهد و Connected می‌خواند.

هر مجوزی را که ارائه‌دهنده می‌خواهد تأیید کنید. به‌خصوص گوگل دسترسی را بر اساس محصول تقسیم می‌کند: تأیید Gmail و نه Drive اتصال را نیمه‌کاره می‌گذارد، و وقتی عامل بخواهد از آن استفاده کند ACCESS_TOKEN_SCOPE_INSUFFICIENT را گزارش می‌دهد. راه‌حل این است که قطع کنید، دوباره وصل شوید، و همه را تأیید کنید.

آنچه می‌خواهید را بخواهید

وقتی وصل شد، فقط به زبان ساده بگویید. لازم نیست نام ابزار یا عمل را بیاورید.

قطع اتصال

Connectors را باز کنید، در نوار چپ به Connected بروید و روی اپ نشانگر ببرید. Disconnect فوراً دسترسی Mythex را نزد ارائه‌دهنده لغو می‌کند. هر چیزی که عامل از قبل ساخته باقی می‌ماند؛ فقط دیگر نمی‌تواند به آن حساب دسترسی داشته باشد.

برنامه‌ریزی هرگز ایمیلی نمی‌فرستد

در حالت Ask و Plan عامل فقط می‌تواند نگاه کند. می‌تواند اتصال‌هایتان را فهرست کند و بررسی کند چه کارهایی از آن‌ها برمی‌آید، اما نمی‌تواند عملی را اجرا کند یا اتصالی را شروع کند. این حالت Plan را جای امنی می‌کند برای فکر کردن به آنچه می‌خواهید، پیش از اینکه چیزی به صندوق ایمیل یا کانال‌هایتان برسد — بیشتر درباره‌ی آن در قبل از ساختن برنامه‌ریزی کنید.

سرورهای MCP سفارشی

همه‌چیز در کاتالوگ نیست. Connectors ← Custom MCP URL هر سرور MCP را می‌پذیرد — سرور خودتان، سرور شرکتتان، یا سروری که یک فروشنده به شما داده. یک نام و URL وارد کنید، روش احراز هویت را انتخاب کنید، و Add & authorize را بزنید:

• اگر سرور از شما بخواهد وارد شوید، صفحه‌ی تأییدیه‌ی خودش در یک برگه باز می‌شود.
• اگر یک توکن ثابت بخواهد، آن را در فیلد Bearer token بچسبانید. توکن ذخیره‌شده دیگر نشان داده نمی‌شود.
• اگر به چیزی نیاز نداشته باشد، فوراً وصل می‌شود.

فهرست ابزارها همان لحظه خوانده می‌شود، پس URL اشتباه یا توکن ردشده در فرم خطا می‌دهد، نه وسط یک بیلد. می‌توانید یک سرور را بدون حذف آن خاموش کنید، و Refresh ابزارهایش را بعد از تغییر دوباره می‌خواند. ورودها در پس‌زمینه تمدید می‌شوند. می‌توانید تا ده سرور برای هر حساب اضافه کنید.

محدودیت‌ها

• اتصال‌ها متعلق به شما هستند و بین همه‌ی پروژه‌های شما مشترک‌اند.
• همه‌ی اپ‌های فهرست‌شده هنوز نمی‌توانند وصل شوند. چند مورد در کاتالوگ این را پشتیبانی نمی‌کنند و به‌عنوان در دسترس‌نبودن نشان داده می‌شوند.
• محدودیت نرخ اعمال می‌شود روی اینکه عامل هر چند وقت یک بار می‌تواند یک اپ متصل را صدا بزند، تا سهمیه‌ی حساب ارائه‌دهنده‌ی خودتان حفظ شود.
• اگر ارائه‌دهنده مجوز را لغو کند یا منقضی شود — که پس از تغییر رمز یا تغییر دسترسی فضای کاری رایج است — عامل می‌گوید اپ نیاز به اتصال مجدد دارد. قطع کنید و دوباره وصل شوید.

این پست درباره‌ی کاری است که عامل در گفتگو می‌تواند برای شما انجام دهد. برای تصویر کامل، مستندات کانکتورها را بخوانید.