Tinjauan
Hubungkan asisten AI yang kompatibel dengan MCP ke data perekrutan Flowmingo Anda — baca pekerjaan dan kandidat Anda, serta lakukan tindakan yang dijaga (undang, pindahkan, tolak, hapus dari proyek) dengan aman, dengan izin Anda. Dengan dua izin tambahan yang Anda aktifkan sendiri, asisten juga dapat membuat proyek perekrutan dan penilaian, serta menerbitkan, menutup, atau meningkatkan postingan pekerjaan (lihat Apa yang dapat Anda lakukan). Baru mengenal MCP? Ini adalah standar terbuka yang memungkinkan asisten AI berbicara dengan alat seperti Flowmingo. Pelajari apa itu MCP.
Transport: Streamable HTTP (transport jarak jauh modern). Tidak ada SSE lama — selalu arahkan klien Anda ke /mcp, jangan pernah ke /sse.
Perlakukan kunci API Anda seperti kata sandi. Utamakan OAuth, input yang diminta, atau variabel lingkungan daripada menempelkan kunci
fl_...mentah ke file yang mungkin Anda commit ke git (misalnya.vscode/mcp.json,~/.cursor/mcp.json, konfigurasi Continue Anda).
Autentikasi — dua opsi
A — Masuk dengan Flowmingo (OAuth, disarankan). Browser Anda membuka halaman persetujuan Flowmingo; Anda menempelkan kunci API Anda di sana. Asisten tidak pernah menerima kunci mentah Anda. Asisten menerima token akses dan token refresh, yang dapat digunakan untuk mendapatkan token akses baru. Masuk tidak berlangsung selamanya. Token refresh berlaku sekitar 30 hari secara default, dihitung sejak diterbitkan, saat masuk atau pada penyegaran terakhir, jadi masuk yang tidak digunakan selama itu akan berakhir, dan rilis Flowmingo yang mengubah cara penyimpanan masuk mungkin juga mengharuskan Anda masuk lagi. Asisten kemudian meminta Anda masuk lagi, dan Anda menempelkan kunci lagi. Untuk memutus lebih cepat, hapus kunci API tersebut. Tidak ada ID klien atau rahasia yang perlu dibuat (Flowmingo menggunakan Dynamic Client Registration). Pada klien yang menampilkan pengaturan OAuth "Lanjutan" (misalnya Claude.ai), biarkan Client ID dan Secret kosong.
B — Kunci API statis (header). Kirim kunci Anda sebagai salah satu header:
x-api-key: fl_YOUR_KEY
Authorization: Bearer fl_YOUR_KEY
Dapatkan kunci Anda di Flowmingo → Pengaturan → Integrasi → Kunci API. Centang Read hiring data dan Read candidates — yang pertama mencakup pekerjaan, pipeline, dan hasil, yang kedua memungkinkan asisten mencari seseorang. Tambahkan Manage pipeline / Invite candidates untuk tindakan tulis yang dijaga. Untuk mengizinkan asisten membuat proyek dan penilaian serta menerbitkan atau meningkatkan postingan pekerjaan, centang juga Create hiring projects dan Create assessments. Baca Buat dan terbitkan di bawah Apa yang dapat Anda lakukan terlebih dahulu: kedua izin ini bersifat opsional, dan pembuat kunci harus Owner atau Admin.
Seperti apa kunci lengkapnya. Satu nilai panjang: fl_live_, nama publik kunci, titik, lalu rahasia panjang. Bagian rahasia ditampilkan sekali, tepat setelah Anda membuat kunci; nanti daftar Kunci API hanya menampilkan awalnya. Nilai tanpa titik hanya nama kunci, dan akan ditolak. Di mana pun panduan ini menulis fl_YOUR_KEY, ganti semuanya dengan kunci lengkap Anda, tanpa tanda kutip dan tanpa spasi.
Jika tidak terhubung. Kunci yang salah atau kosong akan kembali sebagai Missing credential atau The Flowmingo API key was rejected; keduanya bisa berarti nilai tidak pernah sampai kepada kami secara lengkap, jadi periksa nilai terlebih dahulu. Pengaturan seperti ${env:FLOWMINGO_API_KEY} hanya berfungsi jika program dapat melihat variabel itu, dan editor yang dibuka dari dock atau menu Start sering kali tidak membaca profil terminal Anda. Mulailah dari terminal tempat variabel diatur, atau masukkan kunci lengkap Anda ke dalam file (dan jaga file itu keluar dari git).
Mana yang harus dipilih? Sebagian besar klien mendukung keduanya; beberapa (misalnya ChatGPT) hanya OAuth — setiap tab mencatat apa yang didukung klien itu. Secara umum, OAuth cocok untuk asisten interaktif (Claude.ai, ChatGPT, VS Code); header kunci API cocok untuk CLI, headless/CI, dan editor tempat Anda lebih suka memasukkan kunci.
Apa yang dapat Anda lakukan
Pembacaan tidak memerlukan persetujuan. Sebagian besar penulisan dijaga. Undangan, penolakan yang dilakukan dengan tindakan Tolak, penghapusan kandidat dari proyek, penghapusan proyek, atau, biasanya, pemindahan ke tahap yang diatur untuk mengirim email ke kandidat menunggu seseorang menyetujuinya di tautan, masuk ke Flowmingo. Asisten tidak dapat menyetujuinya, dan ketikan "ya" di obrolan tidak dihitung. Pengaturan email tahap diperiksa saat pemindahan diminta. Untuk catatan, penilaian, daftar pendek, tag, atau pemindahan ke tahap yang tidak diatur untuk mengirim email ke kandidat, asisten diperintahkan untuk menampilkan pratinjau terlebih dahulu dan melanjutkan hanya jika Anda setuju, yang merupakan instruksi untuk asisten, bukan kunci. Prompt yang ditampilkan klien AI Anda sebelum menjalankan alat adalah milik klien itu sendiri dan bukan persetujuan Flowmingo: undangan, penolakan yang dilakukan dengan tindakan Tolak, dan pemindahan ke tahap pengiriman email tetap menunggu tautan persetujuan, apa pun yang diminta klien. Tautan persetujuan kedaluwarsa setelah 15 menit, dan satu permintaan untuk beberapa kandidat atau lamaran (paling banyak 50) adalah satu persetujuan yang mencantumkan semua orang. Setelah perubahan dijadwalkan, asisten dapat memeriksa statusnya, menariknya saat masih menunggu, dan membatalkan perubahan yang dapat dibalik (catatan, penilaian, tanda daftar pendek, tag, atau pemindahan yang tidak mengirim email ke siapa pun) dalam 24 jam. Pembatalan tidak selalu tersedia: perubahan harus kembali dengan referensi pembatalan, mencatatnya adalah upaya terbaik, dan pemindahan untuk kandidat tanpa tahap sebelumnya tidak memiliki referensi, jadi asisten harus memeriksa dan mengatakannya saat tidak ada jalan kembali. Email yang telah dikirim tidak dapat dibatalkan. Alat yang tercantum di bawah Buat dan terbitkan adalah pengecualian untuk semua ini, kecuali delete_project: alat tersebut langsung beraksi dan tidak dijadwalkan untuk persetujuan. Penghapusan dan penghapusan proyek tidak dapat dibatalkan. Semuanya terbatas pada organisasi Anda.
Baca
| Kemampuan | Fungsinya |
|---|---|
| Daftar postingan pekerjaan | Jelajahi peran terbuka dan tertutup organisasi Anda. |
| Daftar set wawancara & proyek | Lihat penilaian (set wawancara) Anda dari semua jenis (wawancara AI, role-play, Tes Keterampilan, Tes Teknis, evaluasi CV, Showcase, dan rekaman; kuesioner saat Anda memintanya) dan proyek perekrutan Anda. |
| Daftar pipeline kandidat Anda | Lihat lamaran berdasarkan tahap di seluruh proyek. |
| Baca hasil & skor penilaian | Tarik hasil dari semua jenis: wawancara AI, role-play, Tes Keterampilan, Tes Teknis, evaluasi CV, Showcase, rekaman, dan kuesioner. Setiap hasil diberi label dengan jenisnya. Hanya beberapa jenis yang membawa skor AI: Showcase dan kuesioner tidak pernah diberi skor, dan Tes Keterampilan adalah persentase. |
| Cari kandidat | Ambil nama, email, dan CV satu kandidat. |
| Cari kandidat | Temukan kandidat berdasarkan nama atau email. |
| Bandingkan kandidat | Sejajarkan 2 hingga 10 kandidat berdampingan. Membutuhkan izin Read candidates serta Read hiring data. |
| Ringkasan perekrutan | Funnel untuk semua yang dapat dijangkau koneksi Anda (seluruh perusahaan, kecuali kunci dibuat oleh seseorang yang dibatasi pada beberapa proyek), atau dipersempit saat Anda meminta: lamaran per tahap, aktif vs ditolak, dan untuk setiap jenis penilaian yang memiliki hasil, hasil selesai vs sedang berlangsung dan skor rata-rata. Proyek mempersempit setiap hitungan, tetapi hitungan hasilnya mencakup hasil pada penilaian yang terkait dengan proyek itu, jadi kandidat dari proyek lain yang berbagi salah satu penilaian itu juga dapat dihitung. Penilaian hanya mempersempit hitungan hasil: hitungan tahap dan lamaran tetap pada semua yang dapat dijangkau koneksi Anda. Jenis tidak pernah dijumlahkan. |
| Kandidat terbaik | Hasil dengan peringkat tertinggi, diurutkan berdasarkan skor keseluruhan. Setiap jenis penilaian diperingkat bersama kecuali Anda meminta satu jenis atau satu penilaian (set wawancara). |
| Detail hasil penilaian | Skor per-kompetensi satu hasil plus ringkasan AI, untuk jenis yang memilikinya. Tes Keterampilan, Tes Teknis, Showcase, dan kuesioner memiliki sedikit atau tidak sama sekali. |
| Detail postingan pekerjaan | Detail lengkap satu postingan pekerjaan. |
Apakah postingan pekerjaan terbuka untuk publik? (get_job_post_publication) |
Apakah siapa pun dapat membuka halaman publik postingan pekerjaan: aktif, masih menunggu pemeriksaan konten AI, ditolak olehnya, ditandai, dimatikan, atau proyeknya tidak terbuka. Juga alamat publiknya dan boost-nya (nonaktif, flowmingo, atau diperpanjang). Membutuhkan Read hiring data. |
| Wawancara mendatang | Undangan ke jenis penilaian apa pun yang dikirim atau dijadwalkan dan belum selesai. Ini bukan hitungan semua yang masih tertunda: undangan yang kandidatnya telah diingatkan, atau telah membuka atau mengklik tautan, dikecualikan hingga kandidat mulai, dan juga yang gagal terkirim. |
Tulis (dijaga)
| Kemampuan | Fungsinya |
|---|---|
| Undang kandidat ke penilaian | Menyiapkan undangan untuk wawancara AI, role-play, Tes Keterampilan, atau Tes Teknis, dan menunggu seseorang menyetujuinya di tautan. Tidak ada yang dikirim sebelum itu. Satu penilaian dan paling banyak 50 kandidat per permintaan; Tes Keterampilan atau Tes Teknis membutuhkan proyek dan email untuk setiap kandidat, dan yang disponsori dapat mendebit dompet organisasi Anda saat kandidat memulainya. |
| Pindahkan kandidat ke tahap lain | Pemindahan ke tahap yang diatur untuk mengirim email ke kandidat biasanya menunggu seseorang menyetujuinya di tautan (pengaturan email tahap dibaca sekali, tepat sebelum pemindahan, jadi pengaturan yang diaktifkan saat itu masih dapat membiarkan email pemindahan tanpa persetujuan). Pemindahan lainnya: asisten diperintahkan untuk mempratinjau dan menunggu persetujuan Anda, dan biasanya dapat dibatalkan selama 24 jam, ketika kembali dengan referensi pembatalan. Paling banyak 50 lamaran per permintaan. |
| Tolak lamaran | Meminta persetujuan di tautan. Jika seseorang menyetujuinya, Flowmingo mencoba memindahkan lamaran ke tahap Ditolak proyek; periksa hasilnya setelahnya. Paling banyak 50 lamaran per permintaan. |
Hapus kandidat dari proyek (remove_application) |
Membutuhkan Manage pipeline. Meminta persetujuan di tautan. Jika seseorang menyetujuinya, Flowmingo menghapus lamaran dari proyek; profil kandidat tetap di talent pool Anda dan di proyek lain. Ini bukan penolakan, dan tidak ada pembatalan. Paling banyak 50 lamaran per permintaan. |
| Tambahkan catatan ke hasil | Asisten diperintahkan untuk mempratinjau catatan yang diusulkan dan menunggu persetujuan Anda sebelum menyimpannya. Catatan milik satu hasil penilaian (dari jenis apa pun), bukan kandidat secara keseluruhan. |
| Beri peringkat pada hasil | Asisten diperintahkan untuk mempratinjau peringkat dan menunggu persetujuan Anda. Peringkat berlaku untuk satu hasil penilaian. |
| Masukkan ke daftar pendek hasil | Asisten diperintahkan untuk mempratinjau perubahan daftar pendek dan menunggu persetujuan Anda. Ini berlaku untuk satu hasil penilaian. |
| Tag / tambahkan ke koleksi bakat | Asisten diperintahkan untuk mempratinjau perubahan tag atau koleksi bakat dan menunggu persetujuan Anda. |
| Periksa, tarik, atau batalkan perubahan | Periksa status perubahan yang dijadwalkan (menunggu, dilaksanakan, gagal, kedaluwarsa, atau digantikan oleh permintaan yang lebih baru), tarik yang masih menunggu persetujuan, atau batalkan perubahan yang dapat dibalik dalam 24 jam, ketika kembali dengan referensi pembatalan. |
Buat dan terbitkan (langsung beraksi, kecuali menghapus proyek)
Alat-alat ini membuat hal-hal dan membukanya untuk publik. Mereka berperilaku berbeda dari penulisan yang dijaga di atas:
- Mereka langsung beraksi, kecuali
delete_project. Tidak ada yang dijadwalkan untuk disetujui seseorang di tautan, dan tidak ada yang mengirim email ke kandidat.delete_projectmenunggu Owner atau Admin menyetujuinya di tautan. - Pembuat kunci harus Owner atau Admin, untuk setiap alat di sini kecuali pembatalan, yang hanya membutuhkan Invite candidates. Alat bertindak dengan izin orang yang membuat kunci API. Jika orang itu adalah Member, panggilan ditolak.
- Dua izin bersifat opsional. Create hiring projects dan Create assessments tidak diberikan secara default. Dengan masuk (opsi A), asisten hanya mendapatkannya jika keduanya terpenuhi: klien menyebutkannya satu per satu saat terhubung, dan kunci API yang Anda tempel di halaman persetujuan memuatnya. Klien yang tidak mengirim daftar izin akan mendapatkan empat izin standar (Read hiring data, Read candidates, Manage pipeline, Invite candidates) yang dimiliki kunci, dan tidak satupun dari kedua izin tersebut, sehingga asisten tidak melihat alat yang membutuhkannya. Dengan kunci statis (opsi B), asisten diperlihatkan alat-alat ini apa pun izin yang dimiliki kunci, dan Flowmingo menolak setiap panggilan yang tidak diizinkan oleh kunci.
- Beberapa panggilan memakan waktu. Penerbitan menunggu pemeriksaan konten AI, hingga sekitar 90 detik. Membuat proyek atau penilaian menggunakan generasi AI dan bisa lebih lama (Tes Teknis memakan 3 hingga 9 menit). Saat jawaban mengatakan pekerjaan masih tertunda, asisten memanggil lagi dengan kunci idempotensi yang sama untuk membaca progresnya. Percobaan ulang tidak pernah membuat proyek atau penilaian kedua.
| Kemampuan | Fungsinya |
|---|---|
Buat proyek perekrutan (create_project) |
Membutuhkan Create hiring projects (opsional). Membuat proyek dengan empat tahap default dan postingan pekerjaan yang ditulis oleh AI yang sama dengan dasbor, dari judul, posisi, dan deskripsi opsional. Secara default juga membuat Evaluasi CV dan Wawancara AI; asisten dapat menamai penilaian lain, atau tidak sama sekali. Postingan pekerjaan diaktifkan dan menjadi publik setelah pemeriksaan konten AI menyetujuinya, biasanya dalam satu menit. Terbatas pada 10 proyek per menit dan 300 per hari untuk perusahaan Anda. Kunci idempotensi opsional: saat dihilangkan, satu dibuat dari argumen, jadi percobaan ulang tidak pernah membuat proyek kedua. |
Buat penilaian (create_assessment) |
Membutuhkan Create assessments (opsional). Membuat satu penilaian dengan AI: Wawancara AI, Evaluasi CV, Tes Keterampilan, Showcase, Tes Teknis, atau Role-play, dari judul pekerjaan dan deskripsi pekerjaan opsional, nama, proyek, dan bahasa (tag seperti en atau vi-VN; Tes Keterampilan dan Tes Teknis mengabaikan bahasa). Lampirkan ke proyek sehingga kandidat dapat diundang ke Tes Keterampilan, Tes Teknis, atau Showcase. Kunci idempotensi opsional, seperti di atas. |
Terbitkan postingan pekerjaan (publish_job_post) |
Membutuhkan Create hiring projects. Mengaktifkan postingan pekerjaan dan memastikan pemeriksaan konten AI telah dijalankan. Jawaban mengatakan apakah halaman aktif sekarang, masih menunggu pemeriksaan, atau ditolak olehnya. Proyek perekrutan harus aktif. |
Batalkan penerbitan postingan pekerjaan (unpublish_job_post) |
Membutuhkan Create hiring projects. Menonaktifkan postingan pekerjaan, sehingga tautan publiknya berhenti terbuka. Secara default boost juga dimatikan (withdraw_boost benar). |
Tingkatkan postingan pekerjaan (boost_job_post) |
Membutuhkan Create hiring projects. Mengatur boost ke off, flowmingo, atau extended. Meningkatkan gratis. Menaikkannya membutuhkan postingan pekerjaan diaktifkan, proyeknya aktif, logo dan deskripsi perusahaan, dan pemeriksaan konten AI; perusahaan dapat menaikkan 50 boost per hari. |
Buka, draft, atau arsipkan proyek (set_project_state) |
Membutuhkan Create hiring projects. Memindahkan proyek perekrutan antara active, draft, dan archived. Draf dan arsip menutup tautan pekerjaan. Data kandidat tetap disimpan. |
Batalkan undangan terjadwal (cancel_scheduled_invite) |
Membutuhkan Invite candidates. Membatalkan undangan yang dijadwalkan untuk nanti dan belum dikirim, menggunakan id undangan dari hasil undangan. Tidak ada yang diemail. Orang tersebut tetap di akun Anda dan di papan proyek. |
Hapus proyek perekrutan (delete_project) |
Membutuhkan Create hiring projects (opsional). Ini hanya meminta: tidak menghapus sekaligus, meminta persetujuan di tautan, dan tidak ada yang dihapus sampai Owner atau Admin menyetujuinya. Hanya proyek aktif yang dapat dihapus. Jika seseorang menyetujuinya, Flowmingo menghapus proyek dan postingan pekerjaannya; lamaran kandidatnya tidak dihapus satu per satu, dan profil serta kontak kandidat, penilaian Anda, dan tautan undangan disimpan. Tidak ada pembatalan. |
Keamanan & kepercayaan
- Data Anda terbatas pada organisasi — asisten tidak akan pernah dapat melihat data perusahaan lain.
- Dengan OAuth, asisten tidak pernah menerima kunci API Anda. Mendapatkan token akses yang kedaluwarsa setelah satu jam, disegarkan secara diam-diam saat tetap terhubung. Masuk itu sendiri berlangsung selama token refreshnya, sekitar 30 hari secara default dari saat diterbitkan atau disegarkan terakhir, jadi berakhir setelah sekitar 30 hari tanpa digunakan, dan Anda kemudian masuk lagi. Dengan header statis (opsi B) klien asisten Anda memegang kunci Anda dan mengirimkannya dengan setiap permintaan, jadi jauhkan dari file yang mungkin Anda bagikan atau commit.
- Memutus asisten: hapus kunci API yang Anda gunakan untuk mengotorisasinya, di Pengaturan → Integrasi → Kunci API. Akses berhenti segera. Belum ada pemutusan per-asisten, jadi jika Anda ingin mencabutnya satu per satu, berikan setiap asisten kunci sendiri.
- Permintaan ke titik akhir
/mcpdiperiksa Origin-nya: originnullyang buram selalu ditolak, dan pemeriksaan dapat dikunci ke daftar izin, tetapi secara default setiap origin nyata diterima, jadi perlindungannya adalah kredensial Anda, bukan origin. Setiap sesi terikat pada kredensial yang membukanya.
Untuk cara mengautentikasi, lihat Autentikasi — dua opsi; untuk pembacaan yang tepat, penulisan yang dijaga, dan tindakan yang terjadi sekaligus, lihat Apa yang dapat Anda lakukan. Saat Anda siap, lompat ke Hubungkan asisten Anda dan pilih klien Anda.
URL server MCP
Hubungkan asisten Anda
Claude Code (CLI)
Satu perintah menambahkan Flowmingo melalui Streamable HTTP asli. Gunakan OAuth sebagai metode utama; --header statis adalah alternatifnya.
Langkah-langkah: 1) tambahkan server, 2) masuk (browser → tempel kunci), 3) jalankan claude mcp list untuk memverifikasi.
# 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
Perhatian: flag harus ditempatkan sebelum nama, dan selalu gunakan --transport http (jangan pernah sse). Ganti fl_YOUR_KEY dengan kunci lengkap Anda (lihat Seperti apa kunci lengkap di bagian Otentikasi di atas).
Verifikasi bahwa ini berfungsi — tanyakan: "daftarkan lowongan pekerjaan saya."
Cursor
Header statis adalah jalur paling sederhana. Cursor juga dapat menggunakan OAuth (mendukung Dynamic Client Registration) — untuk itu, hapus blok headers.
Langkah-langkah: 1) tambahkan server ke ~/.cursor/mcp.json (di bawah), 2) setel FLOWMINGO_API_KEY ke kunci lengkap Anda di profil shell, 3) keluar dari Cursor dan mulai dari terminal tempat variabel tersebut diatur, 4) di Settings → MCP, matikan lalu hidupkan server untuk memuat ulang.
Cursor harus dapat melihat variabel. Cursor membaca ${env:FLOWMINGO_API_KEY} dari lingkungannya sendiri. Jika dimulai dari dock atau menu Start, sering kali tidak melihat variabel yang diatur di profil terminal, sehingga header kosong atau tidak berkembang dan server menjawab Missing credential. Jika memulai Cursor dari terminal tidak praktis, ganti ${env:FLOWMINGO_API_KEY} dalam file dengan kunci lengkap Anda (dan jangan masukkan ~/.cursor/mcp.json ke git).
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
}
}
}
Alternatif OAuth — hapus blok headers; Cursor menjalankan Dynamic Client Registration dan membuka halaman persetujuan browser saat koneksi pertama:
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp"
}
}
}
Verifikasi bahwa ini berfungsi — tanyakan: "daftarkan lowongan saya yang sedang aktif."
VS Code (Copilot, mode agen)
Alat muncul hanya di Copilot Chat → Mode Agen. Kunci root adalah servers (bukan mcpServers) dan tipenya adalah http. Jalur kunci yang diminta di bawah ini adalah penyiapan yang andal.
Langkah-langkah: 1) buat .vscode/mcp.json (atau jalankan MCP: Tambahkan Server → HTTP), 2) saat Anda memulai server, VS Code meminta kunci Anda (kunci tersebut tidak ditulis ke dalam file), 3) gunakan di Mode Agen.
{
"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 juga dapat mencoba OAuth, tetapi konfigurasi OAuth yang didokumentasikan mengharapkan ID klien; gunakan jalur kunci yang diminta di atas untuk penyiapan yang andal.
Verifikasi berfungsi — tanyakan: "daftar pekerjaan terbuka saya."
Claude — claude.ai & Claude Desktop
Keduanya menggunakan UI Konektor yang sama dan alur tempel-URL yang sama. Hanya OAuth (tidak ada bidang header di UI).
Langkah-langkah (web atau desktop):
- Buka Pengaturan → Konektor dan klik Tambahkan konektor kustom.
- Beri nama
Flowmingodan tempel URL server MCP di atas. Biarkan Lanjutan → ID Klien OAuth / Rahasia kosong. - Klik Tambahkan → Hubungkan. Di halaman persetujuan Flowmingo, tempel kunci API
fl_Anda dan otorisasi. - Verifikasi — tanyakan Claude: "daftar pekerjaan terbuka saya."
Remote MCP server URL: https://mcp.flowmingo.ai/mcp
Advanced → OAuth Client ID / Secret: (leave blank — Flowmingo uses Dynamic Client Registration)
Tim / Perusahaan: Pemilik menambahkannya sekali di bawah Pengaturan Organisasi → Konektor → Kustom; anggota kemudian mengklik Hubungkan.
Perlu kunci statis di Claude Desktop sebagai gantinya? Gunakan tab Klien apa pun (mcp-remote).
Peramban Anda akan membuka halaman persetujuan Flowmingo saat pertama kali terhubung — tempelkan kunci API Anda dan otorisasi. Untuk memutuskan koneksi nanti, hapus kunci API tersebut di Pengaturan → Integrasi → Kunci API.
ChatGPT & OpenAI Codex CLI
Keduanya adalah OpenAI. ChatGPT menggunakan Mode Pengembang untuk konektor khusus (hanya OAuth); Codex terhubung secara native dari CLI.
ChatGPT (web)
- Di chatgpt.com (Plus / Pro / Business / Enterprise / Edu — bukan seluler), buka Settings → Apps → Advanced dan aktifkan Developer mode.
- Apps → Create → beri nama
Flowmingo, tempel URL di bawah, transport Streamable HTTP, auth OAuth. - Buka draf, aktifkan alat, dan Refresh.
- Lampirkan melalui menu + di obrolan.
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)
Mode Pengembang ChatGPT terhubung dengan hanya OAuth — tidak menerima x-api-key statis / header kunci API kustom. Konektor biasa dan riset mendalam hanya menggunakan search + fetch (Anda memiliki keduanya). Alat tulis (undang / pindah / tolak) memerlukan Mode Pengembang. Prompt yang ditampilkan ChatGPT sebelum menjalankan alat adalah milik ChatGPT sendiri dan bukan persetujuan Flowmingo: undangan, penolakan, dan pemindahan ke tahap yang mengirim email ke kandidat selalu menunggu persetujuan seseorang di tautan Flowmingo.
OpenAI Codex CLI
Tidak perlu jembatan — Codex berbicara Streamable HTTP secara native.
# ~/.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
Verifikasi berfungsi — tanyakan: "daftarkan pekerjaan saya yang terbuka."
Gemini CLI & Code Assist
Gemini CLI (dan mode agen Gemini Code Assist) menjangkau server MCP jarak jauh melalui ~/.gemini/settings.json. Aplikasi Gemini konsumen tidak dapat menambahkan konektor MCP kustom — jalur ini hanya untuk CLI / Code Assist.
Langkah-langkah: 1) tambahkan server di bawah mcpServers di ~/.gemini/settings.json, 2) ekspor FLOWMINGO_API_KEY=fl_..., 3) jalankan gemini dan /mcp untuk mengonfirmasi alat terdaftar.
{
"mcpServers": {
"flowmingo": {
"httpUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${FLOWMINGO_API_KEY}" },
"timeout": 30000
}
}
}
httpUrl memilih HTTP yang dapat dialirkan secara native. Placeholder ${FLOWMINGO_API_KEY} diperluas dari lingkungan Anda, sehingga tidak ada kunci mentah yang ditulis ke dalam file. Lebih suka OAuth? Gemini CLI dapat melakukannya secara native — hapus blok headers dan tambahkan "authProviderType": "dynamic_discovery" ke entri server. CLI mendeteksi tantangan 401, menemukan metadata OAuth kami, dan melakukan pendaftaran klien dinamis sendiri (tidak perlu mengatur ID klien).
Verifikasi berfungsi — di
gemini, tanyakan: "daftar pekerjaan terbuka saya."
Klien lainnya — Windsurf · Zed · Cline · Continue · Antigravity
Setiap klien di bawah bekerja dengan server yang sama — sebagian besar mendukung OAuth dan header statis. Cuplikan kode menggunakan kunci statis melalui variabel lingkungan; hilangkan headers untuk membiarkan klien menjalankan OAuth jika mendukungnya. Perhatikan jebakan nama kunci khusus klien yang disebutkan di bawah.
Google Antigravity
Tambahkan https://mcp.flowmingo.ai/mcp sebagai server MCP jarak jauh dan pilih untuk mengautentikasinya: halaman Flowmingo terbuka dan meminta kunci API lengkap Anda (lihat Seperti apa kunci lengkap itu di bagian Autentikasi di atas). Setiap permukaan Antigravity (IDE, CLI) masuk secara terpisah. Di mcp_config.json Antigravity, alamat ditempatkan di bawah serverUrl, dan kunci statis ditempatkan di blok headers sebagai Authorization dengan Bearer dan kunci lengkap Anda, seperti pada contoh MCP Antigravity milik Google. Kami belum dapat menguji setiap versi Antigravity, jadi jika menu Anda berbeda dari ini, panduan Google memiliki langkah-langkah terbaru.
Windsurf (Cascade)
~/.codeium/windsurf/mcp_config.json — Windsurf menerima serverUrl atau url, dan mendukung OAuth (hilangkan headers untuk memicunya).
{ "mcpServers": { "flowmingo": {
"serverUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Zed
~/.config/zed/settings.json — kuncinya adalah context_servers; hilangkan headers untuk OAuth asli. Setel FLOWMINGO_API_KEY=fl_... di lingkungan Anda daripada menempelkan kunci mentah.
{ "context_servers": { "flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Cline
MCP Servers → Konfigurasi — setel type: "streamableHttp" (camelCase), atau defaultnya adalah SSE yang mati.
{ "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 — hubungkan melalui jembatan mcp-remote. Setel 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 }}"]
Verifikasi berfungsi — tanyakan: "daftar lowongan kerja saya."
Klien apa pun (mcp-remote)
Untuk klien hanya stdio (atau klien masa depan tanpa transport remote asli), hubungkan ke Flowmingo dengan perintah stdio mcp-remote. --transport http-only wajib — server tidak memiliki SSE.
Langkah-langkah: 1) pastikan Node ≥ 18, 2) jalankan bridge sebagai perintah stdio di klien Anda, 3) pada OAuth pertama kali, browser terbuka — tempel kunci Anda.
# 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" }
}
}
}
Penyelamatan: jika autentikasi macet, jalankan rm -rf ~/.mcp-auth dan coba lagi. Ganti fl_YOUR_KEY dengan kunci lengkap Anda (lihat Seperti apa kunci lengkap di bagian Autentikasi di atas). Dalam args[] JSON, hindari spasi setelah titik dua header (keanehan pelolosan npx).
Verifikasi berhasil — tanyakan: "daftar pekerjaan saya yang terbuka."