مرور کلی
هر دستیار هوش مصنوعی سازگار با MCP را به دادههای استخدامی Flowmingo خود متصل کنید — شغلها و کاندیداهای خود را بخوانید و اقدامات محافظتشده (دعوت، انتقال، رد، حذف از پروژه) را بهصورت امن و با اجازه شما انجام دهید. با دو مجوز اضافی که خودتان فعال میکنید، یک دستیار میتواند پروژههای استخدام و ارزیابی ایجاد کند و آگهی شغلی را منتشر، ببندد یا تقویت کند (به کارهایی که میتوانید انجام دهید مراجعه کنید). تازه با MCP آشنا شدهاید؟ این استاندارد باز است که به دستیارهای هوش مصنوعی اجازه میدهد با ابزارهایی مانند Flowmingo صحبت کنند. ببینید MCP چیست.
پروتکل انتقال: Streamable HTTP (پروتکل انتقال مدرن از راه دور). هیچ SSE قدیمی وجود ندارد — همیشه کلاینت خود را به /mcp هدایت کنید، هرگز به /sse.
با کلید API خود مانند رمز عبور رفتار کنید. ترجیح دهید از OAuth، ورودی اعلانشده یا متغیر محیطی استفاده کنید تا چسباندن کلید خام
fl_...در فایلی که ممکن است در git commit کنید (مثلاً.vscode/mcp.json،~/.cursor/mcp.json، تنظیمات Continue خود).
احراز هویت — دو گزینه
الف — ورود با Flowmingo (OAuth، توصیهشده). مرورگر شما صفحه رضایت Flowmingo را باز میکند؛ شما کلید API خود را آنجا paste میکنید. دستیار هرگز کلید خام شما را دریافت نمیکند. آن یک توکن دسترسی و یک توکن تازهسازی دریافت میکند که میتواند از آن برای دریافت توکن دسترسی جدید استفاده کند. ورود برای همیشه ماندگار نیست. توکن تازهسازی بهطور پیشفرض حدود ۳۰ روز اعتبار دارد، از زمان صدور آن، در زمان ورود یا در آخرین تازهسازی، بنابراین ورودی که حدود این مدت استفاده نشود منقضی میشود و انتشار Flowmingo که نحوه ذخیرهسازی ورودها را تغییر دهد ممکن است نیاز به ورود مجدد شما داشته باشد. سپس دستیار دوباره از شما میخواهد وارد شوید و دوباره کلید خود را paste کنید. برای قطع زودتر، آن کلید API را حذف کنید. نیازی به ایجاد شناسه مشتری یا راز نیست (Flowmingo از Dynamic Client Registration استفاده میکند). در کلاینتهایی که تنظیمات OAuth "پیشرفته" را نشان میدهند (مثلاً Claude.ai)، فیلدهای Client ID و Secret را خالی بگذارید.
ب — کلید API ثابت (هدر). کلید خود را بهصورت یکی از هدرها ارسال کنید:
x-api-key: fl_YOUR_KEY
Authorization: Bearer fl_YOUR_KEY
کلید خود را در Flowmingo → تنظیمات → یکپارچهسازیها → کلیدهای API دریافت کنید. Read hiring data و Read candidates را علامت بزنید — اولی شغلها، خط لوله و نتایج را پوشش میدهد، دومی چیزی است که به دستیار اجازه میدهد شخصی را جستجو کند. Manage pipeline / Invite candidates را برای اقدامات نوشتن محافظتشده اضافه کنید. برای اینکه به دستیار اجازه دهید پروژهها و ارزیابیها ایجاد کند و آگهی شغلی را منتشر یا تقویت کند، همچنین Create hiring projects و Create assessments را علامت بزنید. ابتدا ایجاد و انتشار را در بخش کارهایی که میتوانید انجام دهید بخوانید: این دو مجوز اختیاری هستند و ایجادکننده کلید باید مالک یا مدیر باشد.
کلید کامل چه شکلی است. یک مقدار طولانی: fl_live_، نام عمومی کلید، یک نقطه، سپس یک راز طولانی. نیمه راز فقط یکبار، بلافاصله پس از ایجاد کلید نشان داده میشود؛ بعداً لیست کلیدهای API فقط ابتدای آن را نشان میدهد. مقداری که نقطه ندارد فقط نام کلید است و رد خواهد شد. هر جا این راهنما fl_YOUR_KEY نوشته است، همه آن را با کلید کامل خود جایگزین کنید، بدون نقلقول و بدون فاصله.
اگر اتصال برقرار نشد. یک کلید بد یا خالی بهصورت Missing credential یا The Flowmingo API key was rejected برمیگردد؛ هر دو میتوانند به این معنی باشند که مقدار هرگز بهطور کامل به ما نرسیده است، بنابراین ابتدا مقدار را بررسی کنید. تنظیماتی مانند ${env:FLOWMINGO_API_KEY} فقط در صورتی کار میکند که برنامه بتواند آن متغیر را ببیند، و ویرایشگری که از داک یا منوی استارت باز میشود اغلب نمایه ترمینال شما را نمیخواند. یا آن را از ترمینالی که متغیر در آن تنظیم شده شروع کنید، یا کلید کامل خود را در فایل قرار دهید (و آن فایل را از git دور نگه دارید).
کدام را انتخاب کنیم؟ بیشتر کلاینتها از هر دو پشتیبانی میکنند؛ تعداد کمی (مثلاً ChatGPT) فقط OAuth هستند — هر برگه یادداشت میکند که آن کلاینت چه چیزی را پشتیبانی میکند. بهطور کلی، OAuth برای دستیارهای تعاملی مناسب است (Claude.ai، ChatGPT، VS Code); هدر کلید API برای CLIها، بدون سر/CI و ویرایشگرهایی مناسب است که ترجیح میدهید یک کلید وارد کنید.
کارهایی که میتوانید انجام دهید
خواندنها نیازی به تأیید ندارند. بیشتر نوشتنها محافظتشده هستند. یک دعوت، یک رد با اقدام رد، حذف کاندیداها از پروژه، حذف پروژه، یا معمولاً انتقال به مرحلهای که قرار است به کاندیدا ایمیل بزند، منتظر تأیید یک شخص در یک لینک، با ورود به Flowmingo است. دستیار نمیتواند آن را تأیید کند، و بله تایپشده در چت به حساب نمیآید. تنظیم ایمیل مرحله در زمان درخواست انتقال بررسی میشود. برای یک یادداشت، رتبهبندی، لیست کوتاه، برچسب، یا انتقال به مرحلهای که قرار نیست به کاندیدا ایمیل بزند، به دستیار گفته میشود ابتدا پیشنمایش را به شما نشان دهد و فقط وقتی موافقت کنید ادامه دهد، که این یک دستورالعمل به آن است، نه یک قفل. اعلانی که کلاینت AI شما قبل از اجرای یک ابزار نشان میدهد متعلق به خود کلاینت است و تأیید Flowmingo نیست: یک دعوت، یک رد با اقدام رد و انتقال به مرحله ایمیلدار همچنان منتظر لینک تأیید هستند، مهم نیست کلاینت چه چیزی خواسته باشد. یک لینک تأیید پس از ۱۵ دقیقه منقضی میشود و یک درخواست برای چند کاندیدا یا درخواست (حداکثر ۵۰) یک تأیید است که همه را فهرست میکند. پس از مرحلهبندی یک تغییر، دستیار میتواند وضعیت آن را بررسی کند، در حالی که هنوز منتظر است آن را پس بگیرد، و یک تغییر قابل بازگشت (یادداشت، رتبهبندی، علامت لیست کوتاه، برچسب، یا انتقالی که به کسی ایمیل نزده) را ظرف ۲۴ ساعت بازگرداند. بازگرداندن همیشه ممکن نیست: تغییر باید با یک مرجع بازگرداندن برگردد، ثبت آن بهترین تلاش است، و انتقال برای کاندیدایی که مرحله قبلی ندارد هیچ مرجعی ندارد، بنابراین دستیار باید بررسی کند و وقتی راه بازگشتی نیست بگوید. ایمیلی که ارسال شده قابل بازگرداندن نیست. ابزارهای فهرستشده در ایجاد و انتشار استثنا هستند، به جز delete_project: آنها بلافاصله عمل میکنند و برای تأیید مرحلهبندی نمیشوند. حذف و حذف پروژه قابل بازگرداندن نیست. همه چیز به سازمان شما محدود است.
خواندن
| قابلیت | چه کاری انجام میدهد |
|---|---|
| فهرست آگهیهای شغلی | نقشهای باز و بسته سازمان خود را مرور کنید. |
| فهرست مجموعههای مصاحبه و پروژهها | ارزیابیهای خود (مجموعههای مصاحبه) از هر نوع (مصاحبههای AI، ایفای نقش، آزمونهای مهارت، آزمونهای فنی، ارزیابی رزومه، نمایشگاهها و ضبطها؛ پرسشنامهها وقتی درخواست کنید) و پروژههای استخدام خود را ببینید. |
| فهرست خط لوله کاندیدا | درخواستها را بر اساس مرحله در یک پروژه مشاهده کنید. |
| خواندن نتایج و نمرات ارزیابی | نتایج هر نوع را بیاورید: مصاحبههای AI، ایفای نقش، آزمونهای مهارت، آزمونهای فنی، ارزیابی رزومه، نمایشگاهها، ضبطها و پرسشنامهها. هر نتیجه با نوع آن برچسبگذاری شده است. فقط برخی انواع نمره AI دارند: نمایشگاه و پرسشنامه هرگز نمرهدهی نمیشوند و آزمون مهارت درصد است. |
| جستجوی یک کاندیدا | نام، ایمیل و رزومه یک کاندیدا را بیاورید. |
| جستجوی کاندیداها | کاندیداها را با نام یا ایمیل پیدا کنید. |
| مقایسه کاندیداها | ۲ تا ۱۰ کاندیدا را کنار هم قرار دهید. به مجوز Read candidates و همچنین Read hiring data نیاز دارد. |
| نمای کلی استخدام | قیف برای همه چیزهایی که اتصال شما میتواند به آن دسترسی داشته باشد (کل شرکت، مگر اینکه کلید توسط شخصی محدود به برخی پروژهها ساخته شده باشد)، یا وقتی بخواهید محدود شود: درخواستها بر اساس مرحله، فعال در مقابل رد شده، و برای هر نوع ارزیابی که نتیجه دارد، نتایج تکمیلشده در مقابل در حال انجام و میانگین نمره. یک پروژه هر شمارش را محدود میکند، اما شمارش نتایج آن نتایج ارزیابیهای مرتبط با آن پروژه را پوشش میدهد، بنابراین یک کاندیدای پروژه دیگر که یکی از آن ارزیابیها را به اشتراک میگذارد نیز میتواند شمارش شود. یک ارزیابی فقط شمارش نتایج را محدود میکند: شمارش مرحله و درخواست در همه چیزهایی که اتصال شما میتواند به آن دسترسی داشته باشد باقی میماند. انواع هرگز با هم جمع نمیشوند. |
| کاندیداهای برتر | بالاترین نتایج رتبهبندیشده، مرتبشده بر اساس نمره کلی. هر نوع ارزیابی با هم رتبهبندی میشود مگر اینکه یک نوع یا یک ارزیابی (مجموعه مصاحبه) را بخواهید. |
| جزئیات نتیجه ارزیابی | نمرات هر شایستگی یک نتیجه به همراه خلاصه AI، برای انواعی که دارند. آزمون مهارت، آزمون فنی، نمایشگاه و پرسشنامه کم یا هیچ دارند. |
| جزئیات آگهی شغلی | جزئیات کامل یک آگهی شغلی. |
آیا آگهی شغلی برای عموم باز است؟ (get_job_post_publication) |
اینکه آیا هر کسی میتواند صفحه عمومی آگهی شغلی را باز کند: زنده، هنوز منتظر بررسی محتوای AI، رد شده توسط آن، پرچمگذاریشده، خاموش، یا پروژه آن باز نیست. همچنین آدرس عمومی و تقویت آن (خاموش، flowmingo یا extended). به Read hiring data نیاز دارد. |
| مصاحبههای آینده | دعوتنامههایی برای هر نوع ارزیابی که ارسال شده یا برنامهریزی شده و هنوز تکمیل نشدهاند. این تعداد همه افرادی که هنوز معوق هستند نیست: دعوتنامهای که کاندیدای آن یادآوری شده، یا لینک را باز کرده یا کلیک کرده، تا زمانی که کاندیدا شروع نکند کنار گذاشته میشود، و همچنین دعوتنامهای که ارسال نشده است. |
نوشتن (محافظتشده)
| قابلیت | چه کاری انجام میدهد |
|---|---|
| دعوت کاندیداها به یک ارزیابی | دعوتنامهها را برای مصاحبه AI، ایفای نقش، آزمون مهارت یا آزمون فنی آماده میکند و منتظر تأیید یک شخص در یک لینک است. قبل از آن چیزی ارسال نمیشود. یک ارزیابی و حداکثر ۵۰ کاندیدا در هر درخواست؛ آزمون مهارت یا آزمون فنی برای هر کاندیدا به یک پروژه و ایمیل نیاز دارد و یک آزمون حمایتشده میتواند وقتی کاندیدا شروع کند از کیف پول سازمان شما کم کند. |
| انتقال کاندیدا به مرحله دیگر | انتقال به مرحلهای که قرار است به کاندیدا ایمیل بزند معمولاً منتظر تأیید یک شخص در یک لینک است (تنظیم ایمیل مرحله فقط یکبار، درست قبل از انتقال، خوانده میشود، بنابراین تنظیمی که در آن لحظه روشن شود همچنان میتواند اجازه دهد یک ایمیل انتقال بدون تأیید ارسال شود). هر انتقال دیگر: به دستیار گفته میشود پیشنمایش کند و منتظر بله شما بماند، و معمولاً میتواند به مدت ۲۴ ساعت بازگردانده شود، وقتی با مرجع بازگرداندن برگردد. حداکثر ۵۰ درخواست در هر درخواست. |
| رد یک درخواست | تأیید را در یک لینک درخواست میکند. اگر شخصی تأیید کند، Flowmingo تلاش میکند درخواست را به مرحله رد شده پروژه منتقل کند؛ بعداً نتیجه را بررسی کنید. حداکثر ۵۰ درخواست در هر درخواست. |
حذف کاندیداها از پروژه (remove_application) |
به Manage pipeline نیاز دارد. تأیید را در یک لینک درخواست میکند. اگر شخصی تأیید کند، Flowmingo درخواستها را از پروژه حذف میکند؛ پروفایل کاندیدا در استخر استعداد شما و در پروژههای دیگر میماند. این رد نیست و بازگرداندنی وجود ندارد. حداکثر ۵۰ درخواست در هر درخواست. |
| افزودن یادداشت به یک نتیجه | به دستیار گفته میشود یادداشت پیشنهادی را پیشنمایش کند و قبل از ذخیره منتظر بله شما بماند. یک یادداشت متعلق به یک نتیجه ارزیابی (از هر نوع) است، نه به کل کاندیدا. |
| رتبهبندی یک نتیجه | به دستیار گفته میشود رتبهبندی را پیشنمایش کند و منتظر بله شما بماند. رتبهبندی برای یک نتیجه ارزیابی اعمال میشود. |
| لیست کوتاه یک نتیجه | به دستیار گفته میشود تغییر لیست کوتاه را پیشنمایش کند و منتظر بله شما بماند. برای یک نتیجه ارزیابی اعمال میشود. |
| برچسب / افزودن به مجموعه استعداد | به دستیار گفته میشود تغییر برچسب یا مجموعه استعداد را پیشنمایش کند و منتظر بله شما بماند. |
| بررسی، پسگرفتن یا بازگرداندن یک تغییر | بررسی کنید که یک تغییر مرحلهبندیشده کجاست (در انتظار، انجامشده، ناموفق، منقضی یا جایگزینشده با درخواست جدیدتر)، یکی که هنوز منتظر تأیید است را پس بگیرید، یا یک تغییر قابل بازگشت را ظرف ۲۴ ساعت بازگردانید، وقتی با مرجع بازگرداندن برگردد. |
ایجاد و انتشار (بلافاصله عمل میکند، به جز حذف پروژه)
این ابزارها چیزهایی ایجاد میکنند و به عموم باز میکنند. آنها با نوشتنهای محافظتشده بالا متفاوت رفتار میکنند:
- آنها بلافاصله عمل میکنند، به جز
delete_project. هیچ چیز برای تأیید یک شخص در یک لینک مرحلهبندی نمیشود و هیچکدام به کاندیدا ایمیل نمیزند.delete_projectمنتظر تأیید یک مالک یا مدیر در یک لینک است. - ایجادکننده کلید باید مالک یا مدیر باشد، برای هر ابزار در اینجا به جز لغو، که فقط به Invite candidates نیاز دارد. ابزارها با مجوزهای شخصی که کلید API را ایجاد کرده عمل میکنند. اگر آن شخص عضو باشد، فراخوانی رد میشود.
- دو مجوز اختیاری هستند. Create hiring projects و Create assessments بهصورت پیشفرض ارائه نمیشوند. با ورود به سیستم (گزینهٔ الف)، دستیار فقط در صورتی به آنها دسترسی پیدا میکند که هر دو شرط زیر برقرار باشند: کلاینت هنگام اتصال آنها را با نام مشخص کند و کلید API که در صفحهٔ رضایت وارد میکنید، شامل آنها باشد. کلاینتی که فهرستی از مجوزها ارسال نکند، چهار مجوز استاندارد (Read hiring data، Read candidates، Manage pipeline، Invite candidates) را که کلید در اختیار دارد دریافت میکند. هیچکدام از این دو مجوز را دریافت نمیکند، بنابراین دستیار ابزارهایی که به آنها نیاز دارند را نمیبیند. با استفاده از یک کلید ثابت (گزینه ب)، این ابزارها به دستیار نمایش داده میشوند؛ صرفنظر از مجوزهایی که کلید دارد. Flowmingo هر فراخوانیای را که کلید اجازه انجام آن را نداشته باشد، رد میکند.
- برخی فراخوانیها مدتی طول میکشند. انتشار منتظر بررسی محتوای AI است، تا حدود ۹۰ ثانیه. ایجاد یک پروژه یا ارزیابی از تولید AI استفاده میکند و ممکن است طولانیتر شود (آزمون فنی ۳ تا ۹ دقیقه طول میکشد). وقتی پاسخ میگوید کار هنوز در انتظار است، دستیار دوباره با همان کلید یکتا فراخوانی میکند تا ببیند کجا رسیده است. یک تلاش مجدد هرگز پروژه یا ارزیابی دوم ایجاد نمیکند.
| قابلیت | چه کاری انجام میدهد |
|---|---|
ایجاد پروژه استخدام (create_project) |
به Create hiring projects نیاز دارد (اختیاری). یک پروژه با چهار مرحله پیشفرض و یک آگهی شغلی نوشتهشده توسط همان AI داشبورد، از عنوان، موقعیت و توضیحات اختیاری ایجاد میکند. بهطور پیشفرض همچنین یک ارزیابی رزومه و یک مصاحبه AI ایجاد میکند؛ دستیار میتواند ارزیابیهای دیگر یا هیچ نام ببرد. آگهی شغلی روشن میشود و پس از تأیید بررسی محتوای AI، معمولاً ظرف یک دقیقه، عمومی میشود. محدود به ۱۰ پروژه در دقیقه و ۳۰۰ در روز برای شرکت شما. کلید یکتا اختیاری است: وقتی حذف شود، یکی از آرگومانها ساخته میشود، بنابراین یک تلاش مجدد هرگز پروژه دوم ایجاد نمیکند. |
ایجاد ارزیابی (create_assessment) |
به Create assessments نیاز دارد (اختیاری). یک ارزیابی با AI ایجاد میکند: مصاحبه AI، ارزیابی رزومه، آزمون مهارت، نمایشگاه، آزمون فنی یا ایفای نقش، از عنوان شغلی و توضیحات شغلی اختیاری، نام، پروژه و زبان (برچسبی مانند en یا vi-VN؛ آزمون مهارت و آزمون فنی زبان را نادیده میگیرند). آن را به یک پروژه پیوست کنید تا کاندیداها بتوانند به آزمون مهارت، آزمون فنی یا نمایشگاه دعوت شوند. کلید یکتا اختیاری است، همانطور که در بالا گفته شد. |
انتشار آگهی شغلی (publish_job_post) |
به Create hiring projects نیاز دارد. آگهی شغلی را روشن میکند و مطمئن میشود بررسی محتوای AI اجرا شده است. پاسخ میگوید آیا صفحه اکنون زنده است، هنوز منتظر بررسی است یا توسط آن رد شده است. پروژه استخدام باید فعال باشد. |
عدم انتشار آگهی شغلی (unpublish_job_post) |
به Create hiring projects نیاز دارد. آگهی شغلی را خاموش میکند، بنابراین لینک عمومی آن باز نمیشود. بهطور پیشفرض تقویت نیز خاموش میشود (withdraw_boost درست است). |
تقویت آگهی شغلی (boost_job_post) |
به Create hiring projects نیاز دارد. تقویت را به off، flowmingo یا extended تنظیم میکند. تقویت رایگان است. افزایش آن نیاز به آگهی شغلی روشن، پروژه فعال، لوگو و توضیحات شرکت و بررسی محتوای AI دارد؛ یک شرکت میتواند ۵۰ تقویت در روز افزایش دهد. |
باز کردن، پیشنویس یا آرشیو پروژه (set_project_state) |
به Create hiring projects نیاز دارد. پروژه استخدام را بین active، draft و archived جابهجا میکند. پیشنویس و بایگانیشده لینک شغلی را میبندند. دادههای کاندیدا حفظ میشود. |
لغو دعوت برنامهریزیشده (cancel_scheduled_invite) |
به Invite candidates نیاز دارد. دعوتنامهای که برای بعد برنامهریزی شده و هنوز ارسال نشده را لغو میکند، با استفاده از شناسه دعوت از نتیجه دعوت. به کسی ایمیل زده نمیشود. شخص در حساب شما و روی تخته پروژه میماند. |
حذف پروژه استخدام (delete_project) |
به Create hiring projects نیاز دارد (اختیاری). فقط میپرسد: بلافاصله حذف نمیکند، تأیید را در یک لینک درخواست میکند و چیزی حذف نمیشود تا یک مالک یا مدیر آن را تأیید کند. فقط یک پروژه فعال قابل حذف است. اگر شخصی تأیید کند، Flowmingo پروژه و آگهیهای شغلی آن را حذف میکند؛ درخواستهای کاندیدا یکییکی حذف نمیشوند و پروفایلها و تماسهای کاندیدا، ارزیابیهای شما و لینکهای دعوت حفظ میشوند. بازگرداندنی وجود ندارد. |
امنیت و اعتماد
- دادههای شما محدود به سازمان است — دستیار هرگز نمیتواند دادههای شرکت دیگری را ببیند.
- با OAuth، دستیار هرگز کلید API شما را دریافت نمیکند. آن یک توکن دسترسی دریافت میکند که پس از یک ساعت منقضی میشود، در حالی که متصل است بیصدا تازهسازی میشود. خود ورود به اندازه توکن تازهسازی آن، حدود ۳۰ روز بهطور پیشفرض از زمان صدور یا آخرین تازهسازی، طول میکشد، بنابراین پس از حدود ۳۰ روز بدون استفاده منقضی میشود و سپس دوباره وارد میشوید. با یک هدر ثابت (گزینه B) کلاینت دستیار شما کلید شما را نگه میدارد و آن را با هر درخواست ارسال میکند، بنابراین آن را از فایلهایی که ممکن است به اشتراک بگذارید یا commit کنید دور نگه دارید.
- قطع دستیار: کلید API که با آن مجوز دادهاید را حذف کنید، در تنظیمات → یکپارچهسازیها → کلیدهای API. دسترسی بلافاصله متوقف میشود. هنوز قطع اتصال جداگانه وجود ندارد، بنابراین اگر میخواهید یکییکی آنها را لغو کنید، به هر دستیار کلید خودش را بدهید.
- درخواستها به نقطه پایانی
/mcpاز نظر مبدأ بررسی میشوند: یک مبدأnullمبهم همیشه رد میشود و بررسی میتواند به لیست مجاز قفل شود، اما بهطور پیشفرض هر مبدأ واقعی پذیرفته میشود، بنابراین محافظت شما اعتبار شماست، نه مبدأ. هر جلسه به اعتباری که آن را باز کرده متصل است.
برای نحوه احراز هویت، به احراز هویت — دو گزینه مراجعه کنید؛ برای خواندنهای دقیق، نوشتنهای محافظتشده و اقداماتی که بلافاصله اتفاق میافتند، به کارهایی که میتوانید انجام دهید مراجعه کنید. وقتی آماده شدید، به دستیار خود را متصل کنید بروید و کلاینت خود را انتخاب کنید.
URL سرور MCP
دستیار خود را متصل کنید
Claude Code (CLI)
یک فرمان، Flowmingo را روی Streamable HTTP بومی اضافه میکند. با OAuth شروع کنید؛ --header ایستا جایگزین است.
مراحل: ۱) سرور را اضافه کنید، ۲) وارد شوید (کلید را در مرورگر → جایگذاری کنید)، ۳) claude mcp list را برای تأیید اجرا کنید.
# OAuth (recommended) — flags BEFORE the name:
claude mcp add --transport http flowmingo https://mcp.flowmingo.ai/mcp
claude mcp login flowmingo # browser opens; paste your fl_ key on the consent page
# Static API key instead (pick ONE header):
claude mcp add --transport http flowmingo https://mcp.flowmingo.ai/mcp \
--header "x-api-key: fl_YOUR_KEY"
# or: --header "Authorization: Bearer fl_YOUR_KEY"
# Share with a repo team (writes a git-committable .mcp.json):
claude mcp add --transport http --scope project flowmingo https://mcp.flowmingo.ai/mcp
claude mcp list && claude mcp get flowmingo
نکته: پرچمها باید قبل از نام بیایند، و همیشه از --transport http استفاده کنید (هرگز sse). fl_YOUR_KEY را با کلید کامل خود جایگزین کنید (به کلید کامل چه شکلی است در بخش احراز هویت در بالا مراجعه کنید).
عملکرد را بررسی کنید — بپرسید: "لیست مشاغل باز من."
Cursor
هدر استاتیک سادهترین مسیر است. Cursor همچنین میتواند از OAuth استفاده کند (از Dynamic Client Registration پشتیبانی میکند) — برای این کار، بلوک headers را حذف کنید.
مراحل: 1) سرور را به ~/.cursor/mcp.json اضافه کنید (در زیر)، 2) FLOWMINGO_API_KEY را با کلید کامل خود در پروفایل شل تنظیم کنید، 3) Cursor را ببندید و از ترمینالی که متغیر در آن تنظیم شده است، دوباره اجرا کنید، 4) در Settings → MCP، سرور را خاموش و روشن کنید تا بارگذاری شود.
Cursor باید متغیر را ببیند. Cursor مقدار ${env:FLOWMINGO_API_KEY} را از محیط خودش میخواند. اگر از داک یا منوی استارت اجرا شود، معمولاً متغیر تنظیمشده در پروفایل ترمینال شما را نمیبیند و در نتیجه هدر خالی یا بدون توسعه میرسد و سرور با خطای Missing credential پاسخ میدهد. اگر اجرای Cursor از ترمینال عملی نیست، ${env:FLOWMINGO_API_KEY} را در فایل با کلید کامل خود جایگزین کنید (و ~/.cursor/mcp.json را از git خارج نگه دارید).
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
}
}
}
به جای آن OAuth — بلوک headers را حذف کنید؛ Cursor Dynamic Client Registration را اجرا میکند و در اولین اتصال، صفحه رضایت مرورگر را باز میکند:
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp"
}
}
}
صحت کار را بررسی کنید — بپرسید: "لیست مشاغل باز من."
VS Code (Copilot، حالت عامل)
ابزارها فقط در Copilot Chat → حالت عامل ظاهر میشوند. کلید ریشه servers است (نه mcpServers) و نوع آن http است. مسیر کلید درخواستی در زیر تنظیم قابل اعتماد است.
مراحل: ۱) فایل .vscode/mcp.json را ایجاد کنید (یا MCP: افزودن سرور → HTTP را اجرا کنید)، ۲) هنگام شروع سرور، VS Code کلید شما را درخواست میکند (این کلید در فایل نوشته نمیشود)، ۳) از آن در حالت عامل استفاده کنید.
{
"servers": {
"flowmingo": {
"type": "http",
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${input:flowmingo_key}" }
}
},
"inputs": [
{ "id": "flowmingo_key", "type": "promptString", "description": "Flowmingo API key (fl_...)", "password": true }
]
}
VS Code همچنین میتواند OAuth را امتحان کند، اما پیکربندی مستند شده OAuth به شناسه کلاینت نیاز دارد؛ برای تنظیم قابل اعتماد از مسیر کلید درخواستی بالا استفاده کنید.
کارکرد آن را تأیید کنید — بپرسید: "لیست شغلهای باز من را نمایش بده."
Claude — claude.ai و Claude Desktop
هر دو از رابط کاربری کانکتورهای یکسان و جریان چسباندن URL یکسان استفاده میکنند. فقط OAuth (هیچ فیلد هدر در رابط کاربری وجود ندارد).
مراحل (وب یا دسکتاپ):
۱. به تنظیمات → کانکتورها بروید و روی افزودن کانکتور سفارشی کلیک کنید.
۲. نام آن را Flowmingo بگذارید و URL سرور MCP را در بالا بچسبانید. پیشرفته → شناسه/رمز کلاینت OAuth را خالی بگذارید.
۳. روی افزودن → اتصال کلیک کنید. در صفحه رضایت Flowmingo، کلید API fl_ خود را بچسبانید و مجوز دهید.
۴. تأیید کنید — از Claude بپرسید: "لیست شغلهای باز من را نمایش بده."
Remote MCP server URL: https://mcp.flowmingo.ai/mcp
Advanced → OAuth Client ID / Secret: (leave blank — Flowmingo uses Dynamic Client Registration)
تیم / سازمانی: یک مالک آن را یک بار تحت تنظیمات سازمان → کانکتورها → سفارشی اضافه میکند؛ سپس اعضا روی اتصال کلیک میکنند.
آیا به جای آن به یک کلید ثابت در Claude Desktop نیاز دارید؟ به تب هر کلاینتی (mcp-remote) مراجعه کنید.
مرورگر شما در اولین اتصال، صفحه رضایت Flowmingo را باز میکند — کلید API خود را پیست کرده و اجازه دسترسی بدهید. برای قطع دسترسی در آینده، آن کلید API را در تنظیمات → یکپارچهسازیها → کلیدهای API حذف کنید.
ChatGPT و OpenAI Codex CLI
هر دو متعلق به OpenAI هستند. ChatGPT از Developer Mode برای اتصالهای سفارشی (فقط OAuth) استفاده میکند؛ Codex به صورت بومی از CLI متصل میشود.
ChatGPT (وب)
- در chatgpt.com (Plus / Pro / Business / Enterprise / Edu — نه موبایل)، Settings → Apps → Advanced را باز کنید و Developer mode را روشن کنید.
- Apps → Create → نام
Flowmingoرا بگذارید، URL زیر را paste کنید، انتقال Streamable HTTP، احراز هویت OAuth. - پیشنویس را باز کنید، ابزارها را روشن کنید و Refresh را بزنید.
- از طریق منوی + در یک چت، آن را ضمیمه کنید.
Connector URL: https://mcp.flowmingo.ai/mcp
Transport: Streamable HTTP
Auth: OAuth (leave any static OAuth client ID / secret blank — Flowmingo uses Dynamic Client Registration)
Developer Mode در ChatGPT فقط با OAuth متصل میشود — هدر x-api-key / کلید API سفارشی را نمیپذیرد. اتصالهای ساده و عمیق فقط از search + fetch استفاده میکنند (شما هر دو را دارید). ابزار نوشتن (invite / move / reject) نیاز به Developer Mode دارند. پیامی که ChatGPT قبل از اجرای ابزار نشان میدهد متعلق به خود ChatGPT است و تأیید Flowmingo نیست: دعوت، رد کردن و انتقال به مرحلهای که به نامزد ایمیل میزند، همیشه منتظر تأیید شخص در لینک Flowmingo هستند.
OpenAI Codex CLI
نیازی به bridge نیست — Codex به صورت بومی با Streamable HTTP کار میکند.
# ~/.codex/config.toml — static fl_ key as a bearer (simplest)
[mcp_servers.flowmingo]
url = "https://mcp.flowmingo.ai/mcp"
bearer_token_env_var = "FLOWMINGO_API_KEY" # export FLOWMINGO_API_KEY=fl_...
startup_timeout_sec = 20
tool_timeout_sec = 120
# Static API key (bearer from env) — simplest:
codex mcp add flowmingo --url https://mcp.flowmingo.ai/mcp --bearer-token-env-var FLOWMINGO_API_KEY
# export FLOWMINGO_API_KEY=fl_... (or set it in ~/.codex/config.toml [mcp_servers.flowmingo])
# OAuth instead (no key stored):
codex mcp add flowmingo --url https://mcp.flowmingo.ai/mcp
codex mcp login flowmingo
codex mcp list
برای اطمینان از عملکرد، بپرسید: "لیست موقعیتهای شغلی باز من."
Gemini CLI و Code Assist
Gemini CLI (و حالت عامل Gemini Code Assist) از طریق ~/.gemini/settings.json به سرور MCP از راه دور دسترسی پیدا میکنند. برنامه مصرفکننده Gemini نمیتواند کانکتورهای MCP سفارشی اضافه کند — این مسیر فقط برای CLI / Code Assist است.
مراحل: ۱) سرور را تحت mcpServers در ~/.gemini/settings.json اضافه کنید، ۲) FLOWMINGO_API_KEY=fl_... را در محیط خود export کنید، ۳) gemini و /mcp را اجرا کنید تا تأیید شود ابزارها لیست شدهاند.
{
"mcpServers": {
"flowmingo": {
"httpUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${FLOWMINGO_API_KEY}" },
"timeout": 30000
}
}
}
httpUrl HTTP قابل جریانسازی بومی را انتخاب میکند. نگهدارنده ${FLOWMINGO_API_KEY} از محیط شما گسترش مییابد، بنابراین هیچ کلید خام در فایل نوشته نمیشود. ترجیح میدهید OAuth؟ Gemini CLI میتواند آن را به صورت بومی انجام دهد — بلوک headers را حذف کنید و "authProviderType": "dynamic_discovery" را به ورودی سرور اضافه کنید. CLI چالش ۴۰۱ را تشخیص میدهد، فراداده OAuth ما را کشف میکند و ثبت نام پویا کلاینت را به تنهایی انجام میدهد (نیازی به تنظیم شناسه کلاینت نیست).
کارکرد آن را تأیید کنید — در
gemini، بپرسید: "لیست شغلهای باز من را نمایش بده."
سایر کلاینتها — Windsurf · Zed · Cline · Continue · Antigravity
هر یک از کلاینتهای زیر با همان سرور کار میکند و بیشترشان از OAuth و هدر ثابت پشتیبانی میکنند. قطعهکدها از یک کلید ثابت در قالب متغیر محیطی استفاده میکنند؛ برای فعالکردن OAuth در کلاینتهایی که از آن پشتیبانی میکنند، بخش headers را حذف کنید. به تفاوت نام کلیدها در هر کلاینت که در ادامه مشخص شده است، توجه کنید.
Google Antigravity
https://mcp.flowmingo.ai/mcp را بهعنوان یک سرور MCP راه دور اضافه کنید و گزینه احراز هویت را انتخاب کنید: صفحهای از Flowmingo باز میشود و کلید API کامل شما را درخواست میکند (به بخش «یک کلید کامل چه شکلی است» در قسمت احراز هویت بالا مراجعه کنید). هر محیط Antigravity (IDE و CLI) باید جداگانه وارد شود. در فایل mcp_config.json مربوط به Antigravity، نشانی را در serverUrl قرار دهید و کلید ثابت را در بخش headers، با نام Authorization و مقدار Bearer بههمراه کلید کامل خود وارد کنید؛ مانند نمونههای رسمی Google برای Antigravity MCP. نتوانستهایم همه نسخههای Antigravity را آزمایش کنیم؛ بنابراین اگر منوهای شما با این موارد تفاوت دارد، برای مشاهده مراحل بهروز به راهنمای Google مراجعه کنید.
Windsurf (Cascade)
~/.codeium/windsurf/mcp_config.json — Windsurf serverUrl یا url را میپذیرد و از OAuth پشتیبانی میکند (برای فعالشدن آن، headers را حذف کنید).
{ "mcpServers": { "flowmingo": {
"serverUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Zed
~/.config/zed/settings.json — کلید موردنظر context_servers است؛ برای استفاده از OAuth داخلی، headers را حذف کنید. بهجای چسباندن کلید خام، FLOWMINGO_API_KEY=fl_... را در محیط خود تنظیم کنید.
{ "context_servers": { "flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Cline
MCP Servers → Configure — مقدار type: "streamableHttp" را تنظیم کنید (با camelCase)؛ در غیر این صورت، مقدار پیشفرض به SSE غیرفعال تبدیل میشود.
{ "mcpServers": { "flowmingo": {
"type": "streamableHttp",
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" },
"disabled": false, "autoApprove": []
} } }
Continue.dev
~/.continue/config.yaml — از طریق پل mcp-remote متصل شوید. مقدار FLOWMINGO_AUTH_HEADER را برابر با Bearer fl_YOUR_KEY قرار دهید.
name: Flowmingo MCP
version: 0.0.1
schema: v1
mcpServers:
- name: Flowmingo
command: npx
args: ["-y", "mcp-remote", "https://mcp.flowmingo.ai/mcp", "--transport", "http-only", "--header", "Authorization:${{ secrets.FLOWMINGO_AUTH_HEADER }}"]
عملکرد را بررسی کنید — بپرسید: «فهرست فرصتهای شغلی باز من را نشان بده.»
هر کلاینت (mcp-remote)
برای هر کلاینتی که فقط stdio را پشتیبانی میکند (یا کلاینتی آینده که انتقال بومی از راه دور ندارد)، با دستور stdio mcp-remote به Flowmingo وصل شوید. --transport http-only الزامی است — سرور SSE ندارد.
مراحل: 1) مطمئن شوید Node ≥ 18 دارید، 2) پل را بهعنوان دستور stdio در کلاینت خود اجرا کنید، 3) در اولین اجرای OAuth مرورگر باز میشود — کلید خود را وارد کنید.
# Bare terminal — OAuth, caches the token in ~/.mcp-auth:
npx -y mcp-remote https://mcp.flowmingo.ai/mcp --transport http-only
# Static key (no browser): --header on its own arg is fine
npx -y mcp-remote https://mcp.flowmingo.ai/mcp --transport http-only \
--header "x-api-key: fl_YOUR_KEY"
{
"mcpServers": {
"flowmingo": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.flowmingo.ai/mcp",
"--transport", "http-only", "--header", "x-api-key:${FLOWMINGO_KEY}"],
"env": { "FLOWMINGO_KEY": "fl_YOUR_KEY" }
}
}
}
راه نجات: اگر احراز هویت گیر کرد، rm -rf ~/.mcp-auth را اجرا کنید و دوباره تلاش کنید. fl_YOUR_KEY را با کلید کامل خود جایگزین کنید (نگاه کنید به یک کلید کامل چگونه است در بخش احراز هویت بالا). در args[] JSON، بعد از دو نقطه هدر فاصله نگذارید (مشکل فرار npx).
تأیید کنید که کار میکند — بپرسید: "لیست مشاغل باز من را بده."