Integrasi

Hubungkan Asisten AI (MCP)

Hubungkan asisten AI yang kompatibel dengan MCP apa pun — Claude, Claude Code, ChatGPT, Cursor, VS Code, dan lainnya — ke data perekrutan Flowmingo Anda, dan kelola pipeline Anda dalam bahasa biasa.

Our team is online
Butuh bantuan integrasi?

Terhambat di salah satu langkah atau perlu dukungan teknis? Tim kami dengan senang hati membantu — hubungi kami kapan saja dan kami akan membantu Anda terhubung.

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_project menunggu 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 /mcp diperiksa Origin-nya: origin null yang 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

URL server MCPhttps://mcp.flowmingo.ai/mcp

Hubungkan asisten Anda

Asisten mana yang Anda gunakan?

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."