Gambaran Keseluruhan
Sambungkan mana-mana pembantu AI yang serasi dengan MCP ke data pengambilan pekerja Flowmingo anda — baca pekerjaan dan calon anda serta lakukan tindakan terkawal (jemput, pindah, tolak, alih keluar daripada projek), secara selamat, dengan kebenaran anda. Dengan dua kebenaran tambahan yang anda hidupkan sendiri, pembantu juga boleh mencipta projek pengambilan dan penilaian serta menerbitkan, menutup atau menaikkan iklan kerja (lihat Apa yang boleh anda lakukan). Baru kepada MCP? Ia adalah piawaian terbuka yang membolehkan pembantu AI bercakap dengan alat seperti Flowmingo. Ketahui apa itu MCP.
Pengangkutan: Streamable HTTP (pengangkutan jauh moden). Tiada SSE lama — sentiasa halakan klien anda ke /mcp, bukan /sse.
Layan kunci API anda seperti kata laluan. Utamakan OAuth, input yang diminta, atau pemboleh ubah persekitaran daripada menampal kunci
fl_...mentah ke dalam fail yang mungkin anda commit ke git (cth..vscode/mcp.json,~/.cursor/mcp.json, konfigurasi Continue anda).
Pengesahan — dua pilihan
A — Daftar masuk dengan Flowmingo (OAuth, disyorkan). Penyemak imbas anda membuka halaman kebenaran Flowmingo; anda menampal kunci API anda di sana. Pembantu tidak pernah menerima kunci mentah anda. Ia menerima token akses dan token muat semula, yang boleh digunakan untuk mendapatkan token akses baharu. Daftar masuk tidak kekal selama-lamanya. Token muat semula bertahan kira-kira 30 hari secara lalai, dikira dari masa ia dikeluarkan, semasa daftar masuk atau pada muat semula terkini, jadi daftar masuk yang tidak digunakan untuk tempoh itu akan luput, dan keluaran Flowmingo yang mengubah cara daftar masuk disimpan juga mungkin memerlukan anda daftar masuk semula. Pembantu kemudian meminta anda daftar masuk semula, dan anda menampal kunci anda semula. Untuk memotongnya lebih awal, padamkan kunci API itu. Tiada ID klien atau rahsia yang perlu dibuat (Flowmingo menggunakan Dynamic Client Registration). Pada klien yang menunjukkan tetapan OAuth "Lanjutan" (cth. Claude.ai), biarkan Client ID dan Secret kosong.
B — Kunci API statik (header). Hantar kunci anda sebagai salah satu header:
x-api-key: fl_YOUR_KEY
Authorization: Bearer fl_YOUR_KEY
Dapatkan kunci anda di Flowmingo → Tetapan → Integrasi → Kunci API. Tandakan Read hiring data dan Read candidates — yang pertama meliputi pekerjaan, saluran paip dan keputusan, yang kedua membolehkan pembantu mencari seseorang. Tambah Manage pipeline / Invite candidates untuk tindakan tulis terkawal. Untuk membolehkan pembantu mencipta projek dan penilaian serta menerbitkan atau menaikkan iklan kerja, juga tandakan Create hiring projects dan Create assessments. Baca Cipta dan terbitkan di bawah Apa yang boleh anda lakukan dahulu: dua kebenaran ini adalah pilihan, dan pencipta kunci mestilah Pemilik atau Pentadbir.
Rupa kunci lengkap. Satu nilai panjang: fl_live_, nama awam kunci, titik, kemudian rahsia panjang. Separuh rahsia ditunjukkan sekali, sejurus selepas anda mencipta kunci; kemudian senarai Kunci API hanya menunjukkan permulaannya. Nilai tanpa titik hanyalah nama kunci, dan ia akan ditolak. Di mana-mana panduan ini menulis fl_YOUR_KEY, gantikan semuanya dengan kunci lengkap anda, tanpa petikan dan tanpa ruang.
Jika ia tidak dapat disambungkan. Kunci yang buruk atau kosong akan kembali sebagai Missing credential atau The Flowmingo API key was rejected; kedua-duanya boleh bermakna nilai tidak sampai kepada kami sepenuhnya, jadi semak nilai dahulu. Tetapan seperti ${env:FLOWMINGO_API_KEY} hanya berfungsi jika program dapat melihat pemboleh ubah itu, dan editor yang dibuka dari dok atau menu Mula selalunya tidak membaca profil terminal anda. Sama ada mulakannya dari terminal di mana pemboleh ubah ditetapkan, atau letakkan kunci lengkap anda dalam fail (dan simpan fail itu daripada git).
Yang mana untuk dipilih? Kebanyakan klien menyokong kedua-duanya; beberapa (cth. ChatGPT) adalah OAuth sahaja — setiap tab mencatat apa yang disokong oleh klien itu. Secara umum, OAuth sesuai untuk pembantu interaktif (Claude.ai, ChatGPT, VS Code); header kunci API sesuai untuk CLI, tanpa kepala/CI, dan editor di mana anda lebih suka meletakkan kunci.
Apa yang boleh anda lakukan
Bacaan tidak memerlukan kelulusan. Kebanyakan tulis adalah terkawal. Jemputan, penolakan yang dibuat dengan tindakan Tolak, pengalihan calon daripada projek, pemadaman projek, atau, biasanya, pemindahan ke peringkat yang ditetapkan untuk e-mel calon, menunggu seseorang untuk meluluskannya di pautan, setelah daftar masuk ke Flowmingo. Pembantu tidak boleh meluluskannya, dan "ya" yang ditaip dalam sembang tidak dikira. Tetapan e-mel peringkat diperiksa apabila pemindahan diminta. Untuk nota, penilaian, senarai pendek, tag, atau pemindahan ke peringkat yang tidak ditetapkan untuk e-mel calon, pembantu diarahkan untuk menunjukkan pratonton dahulu dan meneruskan hanya apabila anda bersetuju, yang merupakan arahan kepadanya, bukan kunci. Prompt yang klien AI anda tunjukkan sebelum menjalankan alat adalah milik klien itu sendiri dan bukan kelulusan Flowmingo: jemputan, penolakan yang dibuat dengan tindakan Tolak dan pemindahan ke peringkat e-mel masih menunggu pautan kelulusan, apa sahaja yang klien minta. Pautan kelulusan luput selepas 15 minit, dan satu permintaan untuk beberapa calon atau permohonan (paling banyak 50) adalah satu kelulusan yang menyenaraikan semua orang. Setelah perubahan dipentaskan, pembantu boleh menyemak di mana ia berada, menarik baliknya semasa ia masih menunggu, dan membuat asal perubahan boleh balik (nota, penilaian, tanda senarai pendek, tag, atau pemindahan yang tidak menghantar e-mel kepada sesiapa) dalam tempoh 24 jam. Buat asal tidak selalu tersedia: perubahan itu perlu kembali dengan rujukan buat asal, merekodkannya adalah usaha terbaik, dan pemindahan untuk calon tanpa peringkat awal tidak mempunyai sebarang, jadi pembantu perlu menyemak dan menyatakannya apabila tiada jalan kembali. E-mel yang telah dihantar tidak boleh dibatalkan. Alat yang disenaraikan di bawah Cipta dan terbitkan adalah pengecualian kepada semua ini, kecuali delete_project: ia bertindak serta-merta dan tidak dipentaskan untuk kelulusan. Pengalihan dan pemadaman projek tidak boleh dibuat asal. Semua terhad kepada organisasi anda.
Baca
| Keupayaan | Apa yang ia lakukan |
|---|---|
| Senaraikan iklan kerja | Layari peranan terbuka dan tertutup organisasi anda. |
| Senaraikan set temuduga & projek | Lihat penilaian anda (set temuduga) dari setiap jenis (temuduga AI, main peranan, Ujian Kemahiran, Ujian Teknikal, penilaian CV, Showcase dan rakaman; soal selidik apabila anda memintanya) dan projek pengambilan anda. |
| Senaraikan saluran paip calon anda | Lihat permohonan mengikut peringkat merentas projek. |
| Baca keputusan & skor penilaian | Tarik keputusan dari setiap jenis: temuduga AI, main peranan, Ujian Kemahiran, Ujian Teknikal, penilaian CV, Showcase, rakaman dan soal selidik. Setiap keputusan dilabel dengan jenisnya. Hanya beberapa jenis yang membawa skor AI: Showcase dan soal selidik tidak pernah diberi skor, dan Ujian Kemahiran adalah peratusan. |
| Cari calon | Dapatkan nama, e-mel, dan CV seorang calon. |
| Cari calon | Cari calon mengikut nama atau e-mel. |
| Bandingkan calon | Susun 2 hingga 10 calon bersebelahan. Memerlukan kebenaran Read candidates serta Read hiring data. |
| Gambaran keseluruhan pengambilan | Corong untuk semua yang boleh dicapai oleh sambungan anda (seluruh syarikat, melainkan kunci dibuat oleh seseorang yang terhad kepada beberapa projek), atau disempitkan apabila anda minta: permohonan mengikut peringkat, aktif vs ditolak, dan, untuk setiap jenis penilaian yang mempunyai keputusan, keputusan selesai vs dalam proses dan skor purata. Projek menyempitkan setiap kiraan, tetapi kiraan keputusannya merangkumi keputusan pada penilaian yang dipautkan ke projek itu, jadi calon projek lain yang berkongsi salah satu penilaian itu juga boleh dikira. Penilaian menyempitkan hanya kiraan keputusan: kiraan peringkat dan permohonan kekal pada semua yang boleh dicapai oleh sambungan anda. Jenis tidak pernah ditambah bersama. |
| Calon teratas | Keputusan berpangkat tertinggi, diisih mengikut skor keseluruhan. Setiap jenis penilaian diranking bersama melainkan anda meminta satu jenis atau satu penilaian (set temuduga). |
| Butiran keputusan penilaian | Skor per-kompetensi satu keputusan serta ringkasan AI, untuk jenis yang memilikinya. Ujian Kemahiran, Ujian Teknikal, Showcase dan soal selidik mempunyai sedikit atau tiada. |
| Butiran iklan kerja | Butiran penuh satu iklan kerja. |
Adakah iklan kerja terbuka kepada awam? (get_job_post_publication) |
Sama ada sesiapa boleh membuka halaman awam iklan kerja: langsung, masih menunggu semakan kandungan AI, ditolak olehnya, ditanda, dimatikan, atau projeknya tidak terbuka. Juga alamat awamnya dan boostnya (mati, flowmingo atau lanjutan). Memerlukan Read hiring data. |
| Temuduga akan datang | Jemputan ke mana-mana jenis penilaian yang dihantar atau dijadualkan dan belum selesai. Bukan kiraan semua yang masih belum selesai: jemputan yang calonnya telah diingatkan, atau telah membuka atau mengklik pautan, dikecualikan sehingga calon bermula, dan begitu juga yang gagal dihantar. |
Tulis (terkawal)
| Keupayaan | Apa yang ia lakukan |
|---|---|
| Jemput calon ke penilaian | Sediakan jemputan untuk temuduga AI, main peranan, Ujian Kemahiran atau Ujian Teknikal, dan tunggu seseorang untuk meluluskannya di pautan. Tiada apa-apa dihantar sebelum itu. Satu penilaian dan paling banyak 50 calon setiap permintaan; Ujian Kemahiran atau Ujian Teknikal memerlukan projek dan e-mel untuk setiap calon, dan yang ditaja boleh mendebit dompet organisasi anda apabila calon memulakannya. |
| Pindah calon ke peringkat lain | Pemindahan ke peringkat yang ditetapkan untuk e-mel calon biasanya menunggu seseorang untuk meluluskannya di pautan (tetapan e-mel peringkat dibaca sekali, tepat sebelum pemindahan, jadi tetapan yang dihidupkan pada saat itu masih boleh membenarkan pemindahan e-mel tanpa kelulusan). Mana-mana pemindahan lain: pembantu diarahkan untuk pratontonnya dan menunggu "ya" anda, dan ia biasanya boleh dibuat asal selama 24 jam, apabila ia kembali dengan rujukan buat asal. Paling banyak 50 permohonan setiap permintaan. |
| Tolak permohonan | Minta kelulusan di pautan. Jika seseorang meluluskannya, Flowmingo cuba memindahkan permohonan ke peringkat Ditolak projek; semak keputusan selepas itu. Paling banyak 50 permohonan setiap permintaan. |
Alih keluar calon daripada projek (remove_application) |
Memerlukan Manage pipeline. Minta kelulusan di pautan. Jika seseorang meluluskannya, Flowmingo memadamkan permohonan daripada projek; profil calon kekal dalam kolam bakat anda dan dalam projek lain. Ia bukan penolakan, dan tiada buat asal. Paling banyak 50 permohonan setiap permintaan. |
| Tambah nota pada keputusan | Pembantu diarahkan untuk pratonton nota yang dicadangkan dan menunggu "ya" anda sebelum menyimpannya. Nota kepunyaan satu keputusan penilaian (dari mana-mana jenis), bukan calon secara keseluruhan. |
| Nilaikan keputusan | Pembantu diarahkan untuk pratonton penilaian dan menunggu "ya" anda. Penilaian digunakan pada satu keputusan penilaian. |
| Senarai pendek keputusan | Pembantu diarahkan untuk pratonton perubahan senarai pendek dan menunggu "ya" anda. Ia digunakan pada satu keputusan penilaian. |
| Tag / tambah ke koleksi bakat | Pembantu diarahkan untuk pratonton perubahan tag atau koleksi bakat dan menunggu "ya" anda. |
| Semak, tarik balik atau buat asal perubahan | Semak di mana perubahan berperingkat berada (menunggu, dilaksanakan, gagal, luput atau digantikan oleh permintaan yang lebih baru), tarik balik yang masih menunggu kelulusan, atau buat asal perubahan boleh balik dalam tempoh 24 jam, apabila ia kembali dengan rujukan buat asal. |
Cipta dan terbitkan (bertindak serta-merta, kecuali memadam projek)
Alat ini mencipta perkara dan membukanya kepada awam. Ia berkelakuan berbeza daripada tulis terkawal di atas:
- Mereka bertindak serta-merta, kecuali
delete_project. Tiada apa-apa yang dipentaskan untuk seseorang meluluskan di pautan, dan tiada seorang pun daripada mereka menghantar e-mel kepada calon.delete_projectmenunggu Pemilik atau Pentadbir untuk meluluskannya di pautan. - Pencipta kunci mestilah Pemilik atau Pentadbir, untuk setiap alat di sini kecuali pembatalan, yang hanya memerlukan Invite candidates. Alat bertindak dengan kebenaran orang yang mencipta kunci API. Jika orang itu adalah Ahli, panggilan ditolak.
- Dua kebenaran adalah pilihan masuk. Create hiring projects dan Create assessments tidak diberikan secara lalai. Dengan log masuk (pilihan A), pembantu mendapatnya hanya jika kedua-duanya benar: klien menyenaraikannya dengan nama semasa menyambung, dan kunci API yang anda tampal pada halaman persetujuan memegangnya. Klien yang tidak menghantar senarai kebenaran mendapat empat kebenaran standard (Read hiring data, Read candidates, Manage pipeline, Invite candidates) yang dipegang oleh kunci, dan tidak mendapat mana-mana daripada dua kebenaran ini, jadi pembantu tidak melihat alat yang memerlukannya. Dengan kunci statik (pilihan B), pembantu ditunjukkan alat ini tanpa mengira kebenaran yang dipegang oleh kunci, dan Flowmingo menolak sebarang panggilan yang tidak dibenarkan oleh kunci.
- Sesetengah panggilan mengambil masa. Penerbitan menunggu semakan kandungan AI, sehingga kira-kira 90 saat. Mencipta projek atau penilaian menggunakan penjanaan AI dan boleh mengambil masa lebih lama (Ujian Teknikal mengambil 3 hingga 9 minit). Apabila jawapan mengatakan kerja masih belum selesai, pembantu memanggil semula dengan kunci idempotensi yang sama untuk membaca di mana ia telah sampai. Cuba semula tidak pernah membuat projek atau penilaian kedua.
| Keupayaan | Apa yang ia lakukan |
|---|---|
Cipta projek pengambilan (create_project) |
Memerlukan Create hiring projects (pilihan). Membuat projek dengan empat peringkat lalai dan iklan kerja yang ditulis oleh AI yang sama dengan papan pemuka, dari tajuk, jawatan dan penerangan pilihan. Secara lalai ia juga membuat Penilaian CV dan Temuduga AI; pembantu boleh menamakan penilaian lain, atau tiada. Iklan kerja dihidupkan dan menjadi awam sebaik sahaja semakan kandungan AI meluluskannya, biasanya dalam satu minit. Terhad kepada 10 projek seminit dan 300 sehari untuk syarikat anda. Kunci idempotensi adalah pilihan: apabila ditinggalkan, satu dibuat daripada argumen, jadi cuba semula tidak pernah membuat projek kedua. |
Cipta penilaian (create_assessment) |
Memerlukan Create assessments (pilihan). Membuat satu penilaian dengan AI: Temuduga AI, Penilaian CV, Ujian Kemahiran, Showcase, Ujian Teknikal atau Main Peranan, dari tajuk kerja dan penerangan kerja pilihan, nama, projek dan bahasa (tag seperti en atau vi-VN; Ujian Kemahiran dan Ujian Teknikal mengabaikan bahasa). Lampirkannya ke projek supaya calon boleh dijemput ke Ujian Kemahiran, Ujian Teknikal atau Showcase. Kunci idempotensi adalah pilihan, seperti di atas. |
Terbitkan iklan kerja (publish_job_post) |
Memerlukan Create hiring projects. Menghidupkan iklan kerja dan memastikan semakan kandungan AI telah dijalankan. Jawapan menyatakan sama ada halaman itu langsung sekarang, masih menunggu semakan, atau ditolak olehnya. Projek pengambilan mestilah aktif. |
Nyahterbit iklan kerja (unpublish_job_post) |
Memerlukan Create hiring projects. Mematikan iklan kerja, supaya pautan awamnya berhenti dibuka. Secara lalai boost juga dimatikan (withdraw_boost adalah benar). |
Naikkan iklan kerja (boost_job_post) |
Memerlukan Create hiring projects. Menetapkan boost kepada off, flowmingo atau extended. Menaikkan adalah percuma. Menaikkannya memerlukan iklan kerja dihidupkan, projeknya aktif, logo dan penerangan syarikat, dan semakan kandungan AI; syarikat boleh menaikkan 50 boost sehari. |
Buka, draf atau arkibkan projek (set_project_state) |
Memerlukan Create hiring projects. Memindahkan projek pengambilan pekerja antara active, draft dan archived. Draf dan arkib menutup pautan jawatan. Data calon dikekalkan. |
Batal jemputan berjadual (cancel_scheduled_invite) |
Memerlukan Invite candidates. Membatalkan jemputan yang dijadualkan untuk kemudian dan belum dihantar, menggunakan id jemputan daripada keputusan jemputan. Tiada siapa yang dihantar e-mel. Orang itu kekal dalam akaun anda dan di papan projek. |
Padam projek pengambilan (delete_project) |
Memerlukan Create hiring projects (pilihan). Ia hanya meminta: ia tidak memadam serta-merta, ia meminta kelulusan di pautan, dan tiada apa-apa dipadam sehingga Pemilik atau Pentadbir meluluskannya. Hanya projek aktif yang boleh dipadam. Jika seseorang meluluskannya, Flowmingo memadamkan projek dan iklan kerjanya; permohonan calonnya tidak dipadam satu per satu, dan profil dan kenalan calon, penilaian anda dan pautan jemputan disimpan. Tiada buat asal. |
Keselamatan & kepercayaan
- Data anda adalah terhad kepada organisasi — pembantu tidak akan dapat melihat data syarikat lain.
- Dengan OAuth, pembantu tidak pernah menerima kunci API anda. Ia mendapat token akses yang tamat selepas sejam, dimuat semula secara senyap semasa ia kekal bersambung. Daftar masuk itu sendiri bertahan selama token muat semulanya, kira-kira 30 hari secara lalai dari masa ia dikeluarkan atau dimuat semula terakhir, jadi ia luput selepas kira-kira 30 hari tanpa digunakan, dan anda kemudian daftar masuk semula. Dengan header statik (pilihan B), klien pembantu anda memegang kunci anda dan menghantarnya dengan setiap permintaan, jadi simpan daripada fail yang mungkin anda kongsi atau commit.
- Memotong pembantu: padamkan kunci API yang anda berikan kebenaran dengannya, di Tetapan → Integrasi → Kunci API. Akses berhenti serta-merta. Belum ada pemutusan per-pembantu, jadi jika anda ingin menarik balik satu per satu, berikan setiap pembantu kunci sendiri.
- Permintaan ke titik akhir
/mcpdiperiksa untuk Originnya: asalnullyang legap sentiasa ditolak, dan semakan boleh dikunci ke senarai kebenaran, tetapi secara lalai setiap asal sebenar diterima, jadi perlindungan adalah kredensial anda, bukan asalnya. Setiap sesi terikat dengan kredensial yang membukanya.
Untuk cara mengesahkan, lihat Pengesahan — dua pilihan; untuk bacaan tepat, tulis terkawal dan tindakan yang berlaku serta-merta, lihat Apa yang boleh anda lakukan. Apabila anda bersedia, lompat ke Sambungkan pembantu anda dan pilih klien anda.
URL pelayan MCP
Sambungkan pembantu anda
Claude Code (CLI)
Satu arahan sahaja untuk menambah Flowmingo melalui Streamable HTTP asli. Utamakan OAuth; --header statik adalah alternatif.
Langkah: 1) tambah pelayan, 2) log masuk (pelayar → tampal kunci), 3) claude mcp list untuk mengesahkan.
# 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
Peringatan: bendera mesti diletakkan sebelum nama, dan sentiasa gunakan --transport http (jangan sekali-kali sse). Gantikan fl_YOUR_KEY dengan kunci penuh anda (lihat Rupa bentuk kunci penuh dalam bahagian Pengesahan di atas).
Sahkan ia berfungsi — tanya: "senaraikan pekerjaan aktif saya."
Cursor
Pengepala statik adalah laluan paling mudah. Cursor juga boleh menggunakan OAuth (ia menyokong Pendaftaran Klien Dinamik) — untuk itu, buang blok headers.
Langkah-langkah: 1) tambah pelayan ke ~/.cursor/mcp.json (di bawah), 2) tetapkan FLOWMINGO_API_KEY kepada kunci penuh anda dalam profil shell anda, 3) keluar dari Cursor dan mulakan semula dari terminal di mana pemboleh ubah ditetapkan, 4) dalam Tetapan → MCP, togol pelayan mati dan hidup untuk memuatkan semula.
Cursor mesti dapat melihat pemboleh ubah. Cursor membaca ${env:FLOWMINGO_API_KEY} dari persekitarannya sendiri. Jika dimulakan dari dok atau menu Mula, ia selalunya tidak melihat pemboleh ubah yang ditetapkan dalam profil terminal anda, dan kemudian pengepala tiba kosong atau tidak dikembangkan dan pelayan menjawab Missing credential. Jika memulakan Cursor dari terminal tidak praktikal, gantikan ${env:FLOWMINGO_API_KEY} dalam fail dengan kunci penuh anda (dan simpan ~/.cursor/mcp.json keluar dari git).
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
}
}
}
OAuth sebagai gantian — buang blok headers; Cursor menjalankan Pendaftaran Klien Dinamik dan membuka halaman kebenaran pelayar pada sambungan pertama:
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp"
}
}
}
Sahkan ia berfungsi — tanya: "senaraikan pekerjaan terbuka saya."
VS Code (Copilot, mod ejen)
Alatan hanya muncul dalam Sembang Copilot → Mod Ejen. Kunci akar ialah servers (bukan mcpServers) dan jenisnya ialah http. Laluan kunci yang diminta di bawah ialah persediaan yang boleh dipercayai.
Langkah: 1) cipta .vscode/mcp.json (atau jalankan MCP: Tambah Pelayan → HTTP), 2) apabila anda memulakan pelayan, VS Code meminta kunci anda (ia tidak ditulis ke dalam fail), 3) gunakannya dalam Mod Ejen.
{
"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 boleh cuba OAuth, tetapi konfigurasi OAuth yang didokumentasikan memerlukan ID pelanggan; gunakan laluan kunci yang diminta di atas untuk persediaan yang boleh dipercayai.
Sahkan ia berfungsi — tanya: "senaraikan pekerjaan terbuka saya."
Claude — claude.ai & Claude Desktop
Kedua-duanya menggunakan UI Penyambung yang sama dan aliran tampal-URL yang sama. OAuth sahaja (tiada medan pengepala dalam UI).
Langkah (web atau desktop):
- Buka Tetapan → Penyambung dan klik Tambah penyambung tersuai.
- Namakannya
Flowmingodan tampal URL pelayan MCP di atas. Biarkan Lanjutan → ID Pelanggan OAuth / Rahsia kosong. - Klik Tambah → Sambung. Pada halaman kebenaran Flowmingo, tampal kunci API
fl_anda dan benarkan. - Sahkan — tanya Claude: "senaraikan pekerjaan terbuka saya."
Remote MCP server URL: https://mcp.flowmingo.ai/mcp
Advanced → OAuth Client ID / Secret: (leave blank — Flowmingo uses Dynamic Client Registration)
Pasukan / Perusahaan: Pemilik menambahkannya sekali di bawah Tetapan Organisasi → Penyambung → Tersuai; ahli kemudian klik Sambung.
Perlukan kunci statik pada Claude Desktop sebaliknya? Gunakan tab Mana-mana pelanggan (mcp-remote).
Pelayar anda akan membuka halaman kebenaran Flowmingo semasa sambungan pertama — tampalkan Kunci API anda dan benarkan. Untuk memutuskan sambungan kemudian, padamkan Kunci API tersebut dalam Tetapan → Integrasi → Kunci API.
ChatGPT & OpenAI Codex CLI
Kedua-duanya adalah OpenAI. ChatGPT menggunakan Mod Pembangun untuk penyambung tersuai (OAuth sahaja); Codex menyambung secara asli dari CLI.
ChatGPT (web)
- Di chatgpt.com (Plus / Pro / Business / Enterprise / Edu — bukan mudah alih), buka Settings → Apps → Advanced dan togol Developer mode ON.
- Apps → Create → namakan
Flowmingo, tampal URL di bawah, pengangkutan Streamable HTTP, auth OAuth. - Buka draf, togol alat, dan Refresh.
- Lampirkan melalui menu + dalam perbualan.
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)
Mod Pembangun ChatGPT bersambung dengan OAuth sahaja — ia tidak menerima x-api-key statik / header kekunci API tersuai. Penyambung biasa dan penyelidikan mendalam hanya menggunakan search + fetch (anda ada kedua-duanya). Alat tulis (invite / move / reject) memerlukan Mod Pembangun. Arahan yang ChatGPT tunjukkan sebelum menjalankan alat adalah milik ChatGPT sendiri dan bukan kelulusan Flowmingo: jemputan, penolakan dan pemindahan ke peringkat yang menghantar e-mel kepada calon sentiasa menunggu seseorang untuk meluluskannya di pautan Flowmingo.
OpenAI Codex CLI
Tiada jambatan diperlukan — Codex bercakap Streamable HTTP secara asli.
# ~/.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
Sahkan ia berfungsi — tanya: "senaraikan pekerjaan saya yang terbuka."
Gemini CLI & Code Assist
Gemini CLI (dan mod ejen Gemini Code Assist) mencapai pelayan MCP jauh melalui ~/.gemini/settings.json. Aplikasi Gemini pengguna tidak boleh menambah penyambung MCP tersuai — laluan ini hanya untuk CLI / Code Assist.
Langkah: 1) tambahkan pelayan di bawah mcpServers dalam ~/.gemini/settings.json, 2) eksport FLOWMINGO_API_KEY=fl_..., 3) jalankan gemini dan /mcp untuk mengesahkan alatan disenaraikan.
{
"mcpServers": {
"flowmingo": {
"httpUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${FLOWMINGO_API_KEY}" },
"timeout": 30000
}
}
}
httpUrl memilih HTTP Boleh Strime asli. Pengganti ${FLOWMINGO_API_KEY} diperluaskan daripada persekitaran anda, jadi tiada kunci mentah ditulis ke dalam fail. Lebih suka OAuth? Gemini CLI boleh melakukannya secara asli — buang blok headers dan tambahkan "authProviderType": "dynamic_discovery" pada entri pelayan. CLI mengesan cabaran 401, menemui metadata OAuth kami, dan melakukan pendaftaran pelanggan dinamik dengan sendirinya (tiada ID pelanggan untuk ditetapkan).
Sahkan ia berfungsi — dalam
gemini, tanya: "senaraikan pekerjaan terbuka saya."
Pelanggan lain — Windsurf · Zed · Cline · Continue · Antigravity
Setiap pelanggan di bawah berfungsi dengan pelayan yang sama — kebanyakannya menyokong kedua-dua OAuth dan header statik. Coretan menggunakan kekunci statik melalui pemboleh ubah persekitaran; buang headers untuk membiarkan pelanggan menjalankan OAuth jika ia menyokongnya. Perhatikan perangkap nama kekunci khusus pelanggan yang dinyatakan di bawah.
Google Antigravity
Tambahkan https://mcp.flowmingo.ai/mcp sebagai pelayan MCP jauh dan pilih untuk mengesahkannya: halaman Flowmingo terbuka dan meminta kekunci API lengkap anda (lihat Rupa kekunci lengkap di bahagian Pengesahan di atas). Setiap permukaan Antigravity (IDE, CLI) log masuk secara berasingan. Dalam mcp_config.json Antigravity, alamat diletakkan di bawah serverUrl, dan kekunci statik diletakkan dalam blok headers sebagai Authorization dengan Bearer dan kekunci lengkap anda, seperti dalam contoh MCP Antigravity Google sendiri. Kami belum dapat menguji setiap versi Antigravity, jadi jika menu anda berbeza, panduan Google mempunyai langkah terkini.
Windsurf (Cascade)
~/.codeium/windsurf/mcp_config.json — Windsurf menerima serverUrl atau url, dan menyokong OAuth (buang headers untuk mencetuskannya).
{ "mcpServers": { "flowmingo": {
"serverUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Zed
~/.config/zed/settings.json — kuncinya ialah context_servers; buang headers untuk OAuth asli. Tetapkan FLOWMINGO_API_KEY=fl_... dalam persekitaran anda daripada menampal kekunci mentah.
{ "context_servers": { "flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Cline
MCP Servers → Configure — tetapkan type: "streamableHttp" (camelCase), atau ia akan lalai kepada 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 — sambung melalui jambatan mcp-remote. Tetapkan 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 }}"]
Sahkan ia berfungsi — tanya: "senaraikan pekerjaan terbuka saya."
Sebarang klien (mcp-remote)
Untuk mana-mana klien stdio-only (atau klien masa depan tanpa transportasi jarak jauh asli), hubungkan ke Flowmingo dengan perintah stdio mcp-remote. --transport http-only diperlukan — pelayan tidak mempunyai SSE.
Langkah-langkah: 1) pastikan Node ≥ 18, 2) jalankan jambatan sebagai perintah stdio dalam klien anda, 3) pada run OAuth pertama, penyemak imbas terbuka — tampal 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 pengesahan tersekat, jalankan rm -rf ~/.mcp-auth dan cuba semula. Gantikan fl_YOUR_KEY dengan kunci lengkap anda (lihat Rupa kunci lengkap dalam bahagian Pengesahan di atas). Dalam args[] JSON, elakkan ruang selepas kolon tajuk (quirks pelarian npx).
Sahkan ia berfungsi — tanya: "senaraikan kerja terbuka saya."