Genel Bakış
MCP uyumlu herhangi bir AI asistanını Flowmingo işe alım verilerinize bağlayın — işlerinizi ve adaylarınızı okuyun ve güvenli bir şekilde, sizin izninizle korumalı eylemler gerçekleştirin (davet etme, taşıma, reddetme, projeden çıkarma). Kendi başınıza açtığınız iki ek izinle, bir asistan ayrıca işe alım projeleri ve değerlendirmeleri oluşturabilir ve bir iş ilanını yayınlayabilir, kapatabilir veya öne çıkarabilir (bkz. Neler yapabilirsiniz). MCP'de yeni misiniz? AI asistanlarının Flowmingo gibi araçlarla konuşmasını sağlayan açık standarttır. MCP'nin ne olduğunu öğrenin.
Taşıma: Streamable HTTP (modern uzak taşıma). Eski SSE yoktur — istemcinizi her zaman /mcp adresine yönlendirin, asla /sse adresine değil.
API anahtarınızı şifre gibi koruyun. GitHub'a işleyebileceğiniz bir dosyaya (ör.
.vscode/mcp.json,~/.cursor/mcp.json, Continue yapılandırmanız) ham birfl_...anahtarı yapıştırmak yerine OAuth, istemli bir giriş veya bir ortam değişkeni tercih edin.
Kimlik doğrulama — iki seçenek
A — Flowmingo ile oturum açın (OAuth, önerilir). Tarayıcınız bir Flowmingo onay sayfası açar; API anahtarınızı oraya yapıştırırsınız. Asistan ham anahtarınızı asla almaz. Yeni bir erişim anahtarı almak için kullanabileceği bir erişim anahtarı ve bir yenileme anahtarı alır. Oturum açma sonsuza kadar sürmez. Yenileme anahtarı varsayılan olarak verildiği andan itibaren, oturum açma sırasında veya en son yenilemede yaklaşık 30 gün geçerlidir; bu nedenle yaklaşık bu süre kullanılmayan bir oturum açma sona erer ve Flowmingo'nun oturum açma bilgilerinin saklanma şeklini değiştiren bir sürümü de yeniden oturum açmanızı gerektirebilir. Asistan daha sonra sizden tekrar oturum açmanızı ister ve anahtarınızı tekrar yapıştırırsınız. Daha erken kesmek için o API anahtarını silin. Oluşturulacak istemci kimliği veya sırrı yoktur (Flowmingo Dinamik İstemci Kaydı kullanır). "Gelişmiş" OAuth ayarlarını gösteren istemcilerde (ör. Claude.ai), İstemci Kimliği ve Sırrı boş bırakın.
B — Statik API anahtarı (başlık). Anahtarınızı şu başlıklardan biri olarak gönderin:
x-api-key: fl_YOUR_KEY
Authorization: Bearer fl_YOUR_KEY
Anahtarınızı Flowmingo → Ayarlar → Entegrasyonlar → API Anahtarları bölümünden alın. Read hiring data ve Read candidates seçeneklerini işaretleyin — ilki işleri, boru hattını ve sonuçları kapsar, ikincisi bir asistanın birini aramasını sağlar. Korumalı yazma eylemleri için Manage pipeline / Invite candidates ekleyin. Bir asistanın projeler ve değerlendirmeler oluşturmasına ve bir iş ilanını yayınlamasına veya öne çıkarmasına izin vermek için Create hiring projects ve Create assessments seçeneklerini de işaretleyin. Önce Neler yapabilirsiniz altındaki Oluştur ve yayınla bölümünü okuyun: bu iki izin isteğe bağlıdır ve anahtarın oluşturucusu Sahip veya Yönetici olmalıdır.
Tam bir anahtar neye benzer. Tek bir uzun değer: fl_live_, anahtarın genel adı, bir nokta ve ardından uzun bir sır. Sır yarısı yalnızca anahtarı oluşturduktan hemen sonra bir kez gösterilir; daha sonra API Anahtarları listesi yalnızca başlangıcını gösterir. Nokta içermeyen bir değer yalnızca anahtarın adıdır ve reddedilir. Bu kılavuz fl_YOUR_KEY yazdığında, tümünü tam anahtarınızla değiştirin, tırnak işareti ve boşluk olmadan.
Bağlanmazsa. Geçersiz veya boş bir anahtar Missing credential veya The Flowmingo API key was rejected olarak geri gelir; her ikisi de değerin tamamının bize ulaşmadığı anlamına gelebilir, bu yüzden önce değeri kontrol edin. ${env:FLOWMINGO_API_KEY} gibi bir ayar yalnızca program bu değişkeni görebiliyorsa çalışır ve dock'tan veya Başlangıç menüsünden açılan bir düzenleyici genellikle terminal profilinizi okumaz. Değişkenin ayarlandığı bir terminalden başlatın veya tam anahtarınızı dosyaya koyun (ve bu dosyayı git'ten uzak tutun).
Hangisini seçmeli? Çoğu istemci her ikisini de destekler; birkaçı (ör. ChatGPT) yalnızca OAuth destekler — her sekme o istemcinin neyi desteklediğini not eder. Genel olarak OAuth, etkileşimli asistanlar (Claude.ai, ChatGPT, VS Code) için uygundur; API anahtarı başlığı, CLS'ler, başsız/CI ve anahtar bırakmayı tercih ettiğiniz düzenleyiciler için uygundur.
Neler yapabilirsiniz
Okumalar onay gerektirmez. Çoğu yazma korumalıdır. Bir davet, Reddet eylemiyle yapılan bir ret, adayların bir projeden çıkarılması, bir projenin silinmesi veya normalde adaya e-posta gönderecek şekilde ayarlanmış bir aşamaya taşıma, bir kişinin Flowmingo'da oturum açmış olarak bir bağlantıda onaylamasını bekler. Asistan bunu onaylayamaz ve sohbete yazılan bir "evet" sayılmaz. Aşamanın e-posta ayarı, taşıma istendiğinde kontrol edilir. Bir not, puan, kısa liste, etiket veya adaya e-posta gönderecek şekilde ayarlanmamış bir aşamaya taşıma için asistana önce bir önizleme göstermesi ve yalnızca siz kabul ettiğinizde devam etmesi söylenir; bu bir kilit değil, ona verilen bir talimattır. AI istemcinizin bir araç çalıştırmadan önce gösterdiği komut istemi istemcinin kendisine aittir ve Flowmingo'nun onayı değildir: bir davet, Reddet eylemiyle yapılan bir ret ve e-posta gönderen bir aşamaya taşıma, istemci ne isterse istesin yine de onay bağlantısını bekler. Onay bağlantısı 15 dakika sonra sona erer ve birkaç aday veya başvuru için yapılan bir istek (en fazla 50) herkesi listeleyen tek bir onaydır. Bir değişiklik aşamalandıktan sonra asistan nerede olduğunu kontrol edebilir, hâlâ beklerken geri çekebilir ve 24 saat içinde geri alınabilir bir değişikliği (not, puan, kısa liste işareti, etiket veya kimseye e-posta göndermeyen bir taşıma) geri alabilir. Geri alma her zaman mümkün değildir: değişikliğin bir geri alma referansıyla gelmesi gerekir, bir tane kaydetmek en iyi çabadır ve önceki aşaması olmayan bir aday için taşımanın hiçbir geri alma referansı yoktur, bu yüzden asistan kontrol etmeli ve geri dönüş yolu olmadığında bunu söylemelidir. Gönderilmiş bir e-posta geri alınamaz. Oluştur ve yayınla altında listelenen araçlar, delete_project dışında tüm bunların istisnasıdır: hemen harekete geçerler ve onay için aşamalandırılmazlar. Bir çıkarma ve bir proje silme geri alınamaz. Her şey kuruluşunuzla sınırlıdır.
Oku
| Yetenek | Ne yapar |
|---|---|
| İş ilanlarını listele | Kuruluşunuzun açık ve kapalı rollerine göz atın. |
| Görüşme setlerini ve projeleri listele | Her türden değerlendirmelerinizi (AI görüşmeleri, rol oyunları, Beceri Testleri, Teknik Testler, CV değerlendirmeleri, Vitrinler ve kayıtlar; istediğinizde anketler) ve işe alım projelerinizi görün. |
| Aday boru hattınızı listele | Bir proje genelinde aşamalara göre başvuruları görüntüleyin. |
| Değerlendirme sonuçlarını ve puanlarını oku | Her türden sonucu çekin: AI görüşmeleri, rol oyunları, Beceri Testleri, Teknik Testler, CV değerlendirmeleri, Vitrinler, kayıtlar ve anketler. Her sonuç türüyle etiketlenir. Yalnızca bazı türler AI puanı taşır: bir Vitrin ve bir anket asla puanlanmaz ve bir Beceri Testi yüzdedir. |
| Bir adayı arayın | Bir adayın adını, e-postasını ve CV'sini getirin. |
| Adayları ara | Adayları ada veya e-postaya göre bulun. |
| Adayları karşılaştır | 2 ila 10 adayı yan yana sıralayın. Read candidates izninin yanı sıra Read hiring data gerektirir. |
| İşe alım genel bakış | Bağlantınızın erişebildiği her şey için huni (tüm şirket, anahtar bazı projelerle sınırlı biri tarafından yapılmadıysa) veya istediğinizde daraltılmış: aşama başına başvurular, aktif vs. reddedilen ve sonuçları olan her değerlendirme türü için tamamlanan vs. devam eden sonuçlar ve ortalama puan. Bir proje her sayıyı daraltır, ancak sonuç sayıları o projeye bağlı değerlendirmelerdeki sonuçları kapsar, bu nedenle bu değerlendirmelerden birini paylaşan başka bir projenin adayı da sayılabilir. Bir değerlendirme yalnızca sonuç sayılarını daraltır: aşama ve başvuru sayıları bağlantınızın erişebildiği her şeyde kalır. Türler asla toplanmaz. |
| En iyi adaylar | Genel puana göre sıralanmış en yüksek puanlı sonuçlar. Belirli bir tür veya tek bir değerlendirme (görüşme seti) istemediğiniz sürece her değerlendirme türü birlikte sıralanır. |
| Değerlendirme sonucu ayrıntısı | Bir sonucun yetkinlik başına puanları ve AI özeti, bu türlere sahip olanlar için. Bir Beceri Testi, Teknik Test, Vitrin ve anketin çok az veya hiç yoktur. |
| İş ilanı ayrıntısı | Tek bir iş ilanının tam ayrıntısı. |
Bir iş ilanı halka açık mı? (get_job_post_publication) |
Herkesin bir iş ilanının genel sayfasını açıp açamayacağı: canlı, hâlâ AI içerik kontrolünü bekliyor, tarafından reddedildi, işaretlendi, kapatıldı veya projesi açık değil. Ayrıca genel adresi ve öne çıkarma durumu (kapalı, flowmingo veya genişletilmiş). Read hiring data gerektirir. |
| Yaklaşan görüşmeler | Gönderilen veya planlanan ve henüz tamamlanmamış her tür değerlendirme için davetler. Bekleyen herkesin sayısı değildir: adayı hatırlatılan, bağlantıyı açan veya tıklayan bir davet, aday başlayana kadar hariç tutulur ve teslim edilemeyen bir davet de öyle. |
Yaz (korumalı)
| Yetenek | Ne yapar |
|---|---|
| Adayları bir değerlendirmeye davet et | Bir AI görüşmesi, rol oyunu, Beceri Testi veya Teknik Test için davetiyeleri hazırlar ve bir kişinin bunları bir bağlantıda onaylamasını bekler. Ondan önce hiçbir şey gönderilmez. İstek başına bir değerlendirme ve en fazla 50 aday; bir Beceri Testi veya Teknik Test, her aday için bir proje ve e-posta gerektirir ve sponsorlu bir tane, bir aday başlattığında kuruluşunuzun cüzdanından borçlandırabilir. |
| Bir adayı başka bir aşamaya taşı | Bir adaya e-posta gönderecek şekilde ayarlanmış bir aşamaya taşıma normalde bir kişinin bir bağlantıda onaylamasını bekler (aşamanın e-posta ayarı taşımadan hemen önce bir kez okunur, bu nedenle o anda açılan bir ayar yine de bir taşımanın onay olmadan e-posta göndermesine izin verebilir). Diğer tüm taşımalar: asistana önizleme yapması ve evetinizi beklemesi söylenir ve genellikle bir geri alma referansıyla geldiğinde 24 saat boyunca geri alınabilir. İstek başına en fazla 50 başvuru. |
| Bir başvuruyu reddet | Bir bağlantıda onay ister. Bir kişi onaylarsa, Flowmingo başvuruyu projenin Reddedilen aşamasına taşımayı dener; sonucu sonradan kontrol edin. İstek başına en fazla 50 başvuru. |
Adayları bir projeden çıkar (remove_application) |
Manage pipeline gerektirir. Bir bağlantıda onay ister. Bir kişi onaylarsa, Flowmingo başvuruları projeden siler; adayın profili yetenek havuzunuzda ve diğer projelerde kalır. Bu bir ret değildir ve geri alınamaz. İstek başına en fazla 50 başvuru. |
| Bir sonuca not ekle | Asistana önerilen notu önizlemesi ve kaydetmeden önce evetinizi beklemesi söylenir. Not, bir değerlendirme sonucuna (herhangi bir tür) aittir, adayın tamamına değil. |
| Bir sonucu puanla | Asistana puanı önizlemesi ve evetinizi beklemesi söylenir. Puan, bir değerlendirme sonucuna uygulanır. |
| Bir sonucu kısa listeye al | Asistana kısa liste değişikliğini önizlemesi ve evetinizi beklemesi söylenir. Bir değerlendirme sonucuna uygulanır. |
| Etiketle / yetenek koleksiyonuna ekle | Asistana etiketi veya yetenek koleksiyonu değişikliğini önizlemesi ve evetinizi beklemesi söylenir. |
| Bir değişikliği kontrol et, geri çek veya geri al | Aşamalı bir değişikliğin nerede olduğunu kontrol edin (bekliyor, gerçekleştirildi, başarısız, süresi doldu veya daha yeni bir istekle değiştirildi), hâlâ onay bekleyen birini geri çekin veya bir geri alma referansıyla geldiğinde 24 saat içinde geri alınabilir bir değişikliği geri alın. |
Oluştur ve yayınla (bir projeyi silmek dışında hemen harekete geçer)
Bu araçlar bir şeyler oluşturur ve halka açıklar. Yukarıdaki korumalı yazmalardan farklı davranırlar:
delete_projectdışında hemen harekete geçerler. Bir kişinin bir bağlantıda onaylaması için hiçbir şey aşamalandırılmaz ve hiçbiri bir adaya e-posta göndermez.delete_project, bir Sahip veya Yöneticinin bir bağlantıda onaylamasını bekler.- Anahtarın oluşturucusu bir Sahip veya Yönetici olmalıdır, yalnızca Invite candidates gerektiren iptal dışında buradaki her araç için. Araçlar, API anahtarını oluşturan kişinin izinleriyle hareket eder. Bu kişi bir Üye ise, çağrı reddedilir.
- İki izin isteğe bağlıdır. Create hiring projects ve Create assessments varsayılan olarak verilmez. Oturum açma (A seçeneği) ile asistan bu izinleri yalnızca şu iki koşulun ikisi de doğruysa alır: istemci bağlanırken bu izinleri adlarıyla listeler ve izin sayfasına yapıştırdığınız API anahtarı bu izinleri içerir. İzin listesi göndermeyen bir istemci, anahtarın sahip olduğu dört standart izni (Read hiring data, Read candidates, Manage pipeline, Invite candidates) alır. Bu iki izinden hiçbirini almaz, bu nedenle asistan bu izinleri gerektiren araçları görmez. Statik anahtarla (B seçeneği), anahtar hangi izinlere sahip olursa olsun asistan bu araçları görür. Flowmingo, anahtarın izin vermediği herhangi bir çağrıyı reddeder.
- Bazı çağrılar biraz zaman alır. Yayınlama, AI içerik kontrolünü bekler, yaklaşık 90 saniyeye kadar. Bir proje veya değerlendirme oluşturma AI üretimi kullanır ve daha uzun sürebilir (bir Teknik Test 3 ila 9 dakika sürer). Cevap işin hâlâ beklemede olduğunu söylediğinde, asistan nereye ulaştığını okumak için aynı idempotency anahtarıyla tekrar çağırır. Bir yeniden deneme asla ikinci bir proje veya değerlendirme oluşturmaz.
| Yetenek | Ne yapar |
|---|---|
Bir işe alım projesi oluştur (create_project) |
Create hiring projects (isteğe bağlı) gerektirir. Dört varsayılan aşaması ve kontrol paneliyle aynı AI tarafından yazılmış bir iş ilanıyla bir proje oluşturur; bir başlıktan, pozisyondan ve isteğe bağlı bir açıklamadan. Varsayılan olarak ayrıca bir CV Değerlendirmesi ve bir AI Görüşmesi oluşturur; asistan başka değerlendirmeler veya hiçbirini adlandırabilir. İş ilanı açılır ve AI içerik kontrolü onayladığında, normalde bir dakika içinde halka açılır. Şirketiniz için dakikada 10 proje ve günde 300 ile sınırlıdır. İdempotency anahtarı isteğe bağlıdır: atlanırsa, bağımsız değişkenlerden bir tane yapılır, bu nedenle bir yeniden deneme asla ikinci bir proje oluşturmaz. |
Bir değerlendirme oluştur (create_assessment) |
Create assessments (isteğe bağlı) gerektirir. AI ile tek bir değerlendirme oluşturur: bir AI Görüşmesi, CV Değerlendirmesi, Beceri Testi, Vitrin, Teknik Test veya Rol Oyunu; bir iş unvanından ve isteğe bağlı bir iş açıklamasından, addan, projeden ve dilden (en veya vi-VN gibi bir etiket; bir Beceri Testi ve Teknik Test dili yok sayar). Adayların bir Beceri Testine, Teknik Teste veya Vitrine davet edilebilmesi için bir projeye ekleyin. İdempotency anahtarı yukarıdaki gibi isteğe bağlıdır. |
Bir iş ilanı yayınla (publish_job_post) |
Create hiring projects gerektirir. İş ilanını açar ve AI içerik kontrolünün çalıştığından emin olur. Cevap, sayfanın şu anda canlı olup olmadığını, hâlâ kontrolü beklediğini veya tarafından reddedildiğini söyler. İşe alım projesi aktif olmalıdır. |
Bir iş ilanını yayından kaldır (unpublish_job_post) |
Create hiring projects gerektirir. İş ilanını kapatır, böylece genel bağlantısı açılmayı durdurur. Varsayılan olarak öne çıkarma da kapatılır (withdraw_boost true'dur). |
Bir iş ilanını öne çıkar (boost_job_post) |
Create hiring projects gerektirir. Öne çıkarmayı off, flowmingo veya extended olarak ayarlar. Öne çıkarma ücretsizdir. Yükseltmek, iş ilanının açık olmasını, projesinin aktif olmasını, bir şirket logosu ve açıklamasını ve AI içerik kontrolünü gerektirir; bir şirket günde 50 öne çıkarma yapabilir. |
Bir projeyi aç, taslak veya arşivle (set_project_state) |
Create hiring projects gerekir. Bir işe alım projesini active, draft ve archived arasında taşır. Taslak ve arşivlenen iş bağlantısını kapatır. Aday verileri saklanır. |
Planlanmış bir daveti iptal et (cancel_scheduled_invite) |
Invite candidates gerektirir. Daha sonra planlanmış ve henüz gönderilmemiş bir daveti, davet sonucundaki davet kimliğini kullanarak iptal eder. Kimseye e-posta gönderilmez. Kişi hesabınızda ve proje panosunda kalır. |
Bir işe alım projesini sil (delete_project) |
Create hiring projects (isteğe bağlı) gerektirir. Yalnızca ister: hemen silmez, bir bağlantıda onay ister ve bir Sahip veya Yönetici onaylayana kadar hiçbir şey silinmez. Yalnızca aktif bir proje silinebilir. Bir kişi onaylarsa, Flowmingo projeyi ve iş ilanlarını siler; aday başvuruları tek tek silinmez ve aday profilleri ve kişileri, değerlendirmeleriniz ve davet bağlantılarınız saklanır. Geri alınamaz. |
Güvenlik ve güven
- Verileriniz kuruluş kapsamındadır — asistan asla başka bir şirketin verilerini göremez.
- OAuth ile asistan API anahtarınızı asla almaz. Bir saat sonra sona eren ve bağlı kaldığı sürece sessizce yenilenen bir erişim anahtarı alır. Oturum açma, yenileme anahtarı süresince, varsayılan olarak verildiği veya en son yenilendiği andan itibaren yaklaşık 30 gün sürer; bu nedenle yaklaşık 30 gün kullanılmadan sona erer ve ardından tekrar oturum açarsınız. Statik bir başlıkla (seçenek B) asistanınızın istemcisi anahtarınızı tutar ve her istekle birlikte gönderir; bu nedenle paylaşabileceğiniz veya işleyebileceğiniz dosyalardan uzak tutun.
- Bir asistanı kesmek: Ayarlar → Entegrasyonlar → API Anahtarları bölümünde yetki verdiğiniz API anahtarını silin. Erişim anında durur. Henüz asistan başına bağlantı kesme yoktur, bu nedenle tek tek iptal etmek istiyorsanız her asistana kendi anahtarını verin.
/mcpuç noktasına yapılan istekler Origin açısından kontrol edilir: opak birnullorigin her zaman reddedilir ve kontrol bir beyaz listeye kilitlenebilir, ancak varsayılan olarak her gerçek origin kabul edilir, bu nedenle koruma kimlik bilginizdir, origin değil. Her oturum, onu açan kimlik bilgisine bağlıdır.
Kimlik doğrulama için Kimlik doğrulama — iki seçenek bölümüne bakın; tam okumalar, korumalı yazmalar ve anında gerçekleşen eylemler için Neler yapabilirsiniz bölümüne bakın. Hazır olduğunuzda Asistanınızı bağlayın bölümüne geçin ve istemcinizi seçin.
MCP sunucu URL'si
Asistanınızı bağlayın
Claude Code (CLI)
Tek bir komut, yerel Streamable HTTP üzerinden Flowmingo'yu ekler. OAuth ile öne çıkın; statik --header alternatiftir.
Adımlar: 1) sunucuyu ekleyin, 2) giriş yapın (tarayıcı → anahtarı yapıştırın), 3) doğrulamak için claude mcp list komutunu çalıştırın.
# 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
Dikkat: bayraklar adın önünde olmalıdır ve her zaman --transport http kullanın (sse kullanmayın). fl_YOUR_KEY yerine tam anahtarınızı yazın (yukarıdaki Kimlik Doğrulama bölümündeki Tam anahtar neye benzer kısmına bakın).
Çalıştığını doğrulayın — şunu sorun: "açık işlerimi listele."
Cursor
Statik başlık en basit yoldur. Cursor ayrıca OAuth kullanabilir (Dinamik İstemci Kaydını destekler) — bunun için headers bloğunu kaldırın.
Adımlar: 1) sunucuyu ~/.cursor/mcp.json dosyasına ekleyin (aşağıda), 2) FLOWMINGO_API_KEY ortam değişkenini kabuk profilinizde tam anahtarınızla ayarlayın, 3) Cursor uygulamasından çıkıp, değişkenin ayarlandığı bir terminalden yeniden başlatın, 4) Ayarlar → MCP bölümünde sunucuyu kapatıp açarak yeniden yükleyin.
Cursor değişkeni görebilmelidir. Cursor, ${env:FLOWMINGO_API_KEY} ifadesini kendi ortamından okur. Dock'tan veya Başlangıç menüsünden başlatıldığında, terminal profilinizde ayarladığınız değişkeni genellikle göremez ve bu durumda başlık boş veya genişletilmemiş gelir ve sunucu Missing credential şeklinde yanıt verir. Cursor uygulamasını bir terminalden başlatmak pratik değilse, dosyadaki ${env:FLOWMINGO_API_KEY} ifadesini tam anahtarınızla değiştirin (ve ~/.cursor/mcp.json dosyasını git dışında tutun).
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
}
}
}
Alternatif olarak OAuth — headers bloğunu kaldırın; Cursor Dinamik İstemci Kaydını çalıştırır ve ilk bağlantıda bir tarayıcı onay sayfası açar:
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp"
}
}
}
Çalıştığını doğrulayın — şunu sorun: "açık işlerimi listele."
VS Code (Copilot, ajan modu)
Araçlar yalnızca Copilot Chat → Ajan modunda görünür. Kök anahtar servers'dır ( mcpServers değil) ve türü http'dir. Aşağıdaki istemle anahtar yolu güvenilir kurulumdur.
Adımlar: 1) .vscode/mcp.json dosyasını oluşturun (veya MCP: Sunucu Ekle → HTTP komutunu çalıştırın), 2) sunucuyu başlattığınızda, VS Code anahtarınızı ister (dosyaya yazılmaz), 3) Ajan modunda kullanın.
{
"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 ayrıca OAuth'u deneyebilir, ancak belgelenmiş OAuth yapılandırması bir istemci kimliği bekler; güvenilir bir kurulum için yukarıdaki istemle anahtar yolunu kullanın.
Çalıştığını doğrulayın — şunu sorun: "açık işlerimi listele."
Claude — claude.ai ve Claude Desktop
Her ikisi de aynı Bağlayıcılar kullanıcı arayüzünü ve aynı URL yapıştırma akışını kullanır. Yalnızca OAuth (arayüzde başlık alanı yoktur).
Adımlar (web veya masaüstü):
- Ayarlar → Bağlayıcılar'ı açın ve Özel bağlayıcı ekle'ye tıklayın.
- Adını
Flowmingoolarak belirleyin ve yukarıdaki MCP sunucu URL'sini yapıştırın. Gelişmiş → OAuth İstemci Kimliği / Sırrı'nı boş bırakın. - Ekle → Bağlan'a tıklayın. Flowmingo onay sayfasında, API anahtarınızı (
fl_) yapıştırın ve yetkilendirin. - Doğrulayın — Claude'a şunu sorun: "açık işlerimi listele."
Remote MCP server URL: https://mcp.flowmingo.ai/mcp
Advanced → OAuth Client ID / Secret: (leave blank — Flowmingo uses Dynamic Client Registration)
Ekip / Kurumsal: Bir Sahip, Kuruluş Ayarları → Bağlayıcılar → Özel bölümü altında bir kez ekler; üyeler daha sonra Bağlan'a tıklar.
Bunun yerine Claude Desktop'ta statik bir anahtar mı gerekiyor? mcp-remote sekmesini kullanın.
İlk bağlantıda tarayıcınız bir Flowmingo onay sayfası açar — API anahtarınızı yapıştırın ve yetkilendirin. Daha sonra bağlantıyı kesmek için API anahtarınızı Ayarlar → Entegrasyonlar → API Anahtarları bölümünden silin.
ChatGPT ve OpenAI Codex CLI
Her ikisi de OpenAI'dir. ChatGPT, özel bağlayıcılar için (yalnızca OAuth) Geliştirici Modu'nu kullanır; Codex, CLI'dan doğal olarak bağlanır.
ChatGPT (web)
- chatgpt.com üzerinde (Plus / Pro / Business / Enterprise / Edu — mobil değil), Ayarlar → Uygulamalar → Gelişmiş bölümünü açın ve Geliştirici modu'nu AÇIK konuma getirin.
- Uygulamalar → Oluştur → adı
Flowmingoolarak ayarlayın, aşağıdaki URL'yi yapıştırın, taşıma Streamable HTTP, kimlik doğrulama OAuth. - Taslağı açın, araçları etkinleştirin ve Yenile'ye tıklayın.
- Bir sohbette + menüsünden ekleyin.
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)
ChatGPT'nin Geliştirici Modu yalnızca OAuth ile bağlanır — statik bir x-api-key / özel API anahtarı başlığını kabul etmez. Normal ve derin araştırma bağlayıcıları yalnızca search + fetch kullanır (her ikisine de sahipsiniz). Yazma araçları (davet / reddet / taşı) Geliştirici Modu gerektirir. ChatGPT'nin bir aracı çalıştırmadan önce gösterdiği bir istem, ChatGPT'nin kendisine aittir ve Flowmingo'nun onayı değildir: bir davet, bir reddetme ve adaya e-posta gönderen bir aşamaya taşıma, her zaman bir kişinin Flowmingo bağlantısında onayını bekler.
OpenAI Codex CLI
Köprüye gerek yok — Codex, Streamable HTTP'yi doğal olarak konuşur.
# ~/.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
Çalıştığını doğrulayın — sorun: "açık işlerimi listele."
Gemini CLI ve Kod Yardımı
Gemini CLI (ve Gemini Kod Yardımı ajan modu), ~/.gemini/settings.json aracılığıyla uzak bir MCP sunucusuna ulaşır. Tüketici Gemini uygulaması özel MCP bağlayıcıları ekleyemez — bu yol yalnızca CLI / Kod Yardımı içindir.
Adımlar: 1) ~/.gemini/settings.json dosyasındaki mcpServers altına sunucuyu ekleyin, 2) FLOWMINGO_API_KEY=fl_... ortam değişkenini ayarlayın, 3) gemini'yi çalıştırın ve araçların listelendiğini doğrulamak için /mcp komutunu kullanın.
{
"mcpServers": {
"flowmingo": {
"httpUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${FLOWMINGO_API_KEY}" },
"timeout": 30000
}
}
}
httpUrl, yerel Akışlı HTTP'yi seçer. ${FLOWMINGO_API_KEY} yer tutucusu ortamınızdan genişletilir, bu nedenle dosyaya ham bir anahtar yazılmaz. OAuth'u mu tercih ediyorsunuz? Gemini CLI bunu yerel olarak yapabilir — headers bloğunu atlayın ve sunucu girdisine "authProviderType": "dynamic_discovery" ekleyin. CLI, 401 zorluğunu algılar, OAuth meta verilerimizi keşfeder ve kendi başına dinamik istemci kaydı gerçekleştirir (ayarlanacak istemci kimliği yok).
Çalıştığını doğrulayın —
geminiiçinde şunu sorun: "açık işlerimi listele."
Diğer istemciler — Windsurf · Zed · Cline · Continue · Antigravity
Aşağıdaki her istemci aynı sunucuya bağlanır — çoğu hem OAuth hem de statik bir başlık destekler. Snippet'ler bir ortam değişkeni aracılığıyla statik bir anahtar kullanır; headers kısmını çıkararak istemcinin desteklediği yerlerde OAuth çalıştırmasını sağlayabilirsiniz. Aşağıda belirtilen istemciye özel anahtar adı tuzaklarına dikkat edin.
Google Antigravity
https://mcp.flowmingo.ai/mcp adresini uzak bir MCP sunucusu olarak ekleyin ve kimlik doğrulamayı seçin: bir Flowmingo sayfası açılır ve tam API anahtarınızı ister (yukarıdaki Kimlik Doğrulama bölümünde Tam anahtar neye benzer kısmına bakın). Her Antigravity yüzeyi (IDE, CLI) ayrı ayrı oturum açar. Antigravity'nin mcp_config.json dosyasında adres serverUrl altında, statik bir anahtar ise Google'ın kendi Antigravity MCP örneklerinde olduğu gibi headers bloğunda Authorization olarak Bearer ve tam anahtarınızla birlikte yer alır. Her Antigravity sürümünü test edemedik; bu nedenle menüleriniz bundan farklıysa, Google'ın rehberi güncel adımları içerir.
Windsurf (Cascade)
~/.codeium/windsurf/mcp_config.json — Windsurf serverUrl veya url kabul eder ve OAuth destekler (tetiklemek için headers kısmını çıkarın).
{ "mcpServers": { "flowmingo": {
"serverUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Zed
~/.config/zed/settings.json — anahtar context_servers şeklindedir; yerel OAuth için headers kısmını çıkarın. Ortamınıza FLOWMINGO_API_KEY=fl_... değişkenini ham anahtarı yapıştırmak yerine ayarlayın.
{ "context_servers": { "flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Cline
MCP Sunucuları → Yapılandır — type: "streamableHttp" (camelCase) ayarlayın, aksi takdirde varsayılan olarak ölü SSE kullanır.
{ "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 köprüsü üzerinden bağlanın. FLOWMINGO_AUTH_HEADER = Bearer fl_YOUR_KEY ayarlayın.
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 }}"]
Çalıştığını doğrulayın — sorun: "açık iş ilanlarımı listele."
Herhangi bir istemci (mcp-remote)
Yalnızca stdio destekleyen herhangi bir istemci (veya yerel uzaktan aktarımı olmayan gelecekteki bir istemci) için, mcp-remote stdio komutuyla Flowmingo'ya köprü kurun. --transport http-only gereklidir — sunucuda SSE yoktur.
Adımlar: 1) Node ≥ 18 olduğundan emin olun, 2) köprüyü istemcinizde bir stdio komutu olarak çalıştırın, 3) ilk OAuth çalıştırmasında tarayıcı açılır — anahtarınızı yapıştırın.
# 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" }
}
}
}
Kurtarma: kimlik doğrulama takılırsa, rm -rf ~/.mcp-auth komutunu çalıştırıp tekrar deneyin. fl_YOUR_KEY yerine tam anahtarınızı yazın (yukarıdaki Kimlik Doğrulama bölümündeki Tam anahtar neye benzer kısmına bakın). JSON args[] içinde, başlık iki noktasından sonra boşluk bırakmayın (npx kaçış tuhaflığı).
Çalıştığını doğrulayın — şunu sorun: "açık işlerimi listele."