Tổng quan
Kết nối bất kỳ trợ lý AI tương thích MCP nào với dữ liệu tuyển dụng Flowmingo của bạn — đọc công việc và ứng viên, thực hiện các hành động có kiểm soát (mời, chuyển giai đoạn, từ chối, xóa khỏi dự án) một cách an toàn, với sự cho phép của bạn. Với hai quyền bổ sung mà bạn tự bật, trợ lý cũng có thể tạo dự án tuyển dụng và bài đánh giá, xuất bản, đóng hoặc tăng cường bài đăng tuyển dụng (xem Những gì bạn có thể làm). Mới dùng MCP? Đây là tiêu chuẩn mở cho phép trợ lý AI kết nối với các công cụ như Flowmingo. Tìm hiểu MCP là gì.
Giao thức: Streamable HTTP (giao thức từ xa hiện đại). Không có SSE cũ — luôn trỏ máy khách của bạn tới /mcp, không bao giờ /sse.
Hãy coi khóa API như mật khẩu. Ưu tiên OAuth, nhập liệu khi được nhắc hoặc biến môi trường thay vì dán khóa
fl_...thô vào tệp mà bạn có thể commit lên git (ví dụ:.vscode/mcp.json,~/.cursor/mcp.json, cấu hình Continue của bạn).
Xác thực — hai tùy chọn
A — Đăng nhập bằng Flowmingo (OAuth, được khuyến nghị). Trình duyệt của bạn mở trang đồng ý của Flowmingo; bạn dán khóa API của mình vào đó. Trợ lý không bao giờ nhận được khóa thô của bạn. Nó nhận mã truy cập và mã làm mới, có thể dùng để lấy mã truy cập mới. Việc đăng nhập không kéo dài vĩnh viễn. Mã làm mới có hiệu lực khoảng 30 ngày mặc định, tính từ thời điểm được cấp, khi đăng nhập hoặc lần làm mới gần nhất, vì vậy phiên đăng nhập không được sử dụng trong khoảng thời gian đó sẽ hết hạn và bản phát hành Flowmingo thay đổi cách lưu trữ phiên đăng nhập cũng có thể yêu cầu bạn đăng nhập lại. Sau đó, trợ lý yêu cầu bạn đăng nhập lại và bạn lại dán khóa của mình. Để cắt sớm hơn, hãy xóa khóa API đó. Không cần tạo Client ID hoặc Secret (Flowmingo sử dụng Dynamic Client Registration). Trên các máy khách hiển thị cài đặt OAuth "Nâng cao" (ví dụ: Claude.ai), để trống Client ID và Secret.
B — Khóa API tĩnh (tiêu đề). Gửi khóa của bạn dưới dạng một trong các tiêu đề:
x-api-key: fl_YOUR_KEY
Authorization: Bearer fl_YOUR_KEY
Lấy khóa của bạn trong Flowmingo → Cài đặt → Tích hợp → Khóa API. Tick Read hiring data và Read candidates — quyền đầu tiên bao gồm công việc, kênh tuyển dụng và kết quả, quyền thứ hai cho phép trợ lý tra cứu thông tin ứng viên. Thêm Manage pipeline / Invite candidates cho các hành động ghi có kiểm soát. Để cho phép trợ lý tạo dự án và bài đánh giá, xuất bản hoặc tăng cường bài đăng tuyển dụng, cũng tick Create hiring projects và Create assessments. Đọc Tạo và xuất bản trong phần Những gì bạn có thể làm trước: hai quyền này là tùy chọn và người tạo khóa phải là Chủ sở hữu hoặc Quản trị viên.
Khóa hoàn chỉnh trông như thế nào. Một giá trị dài: fl_live_, tên công khai của khóa, một dấu chấm, sau đó là một chuỗi bí mật dài. Nửa bí mật chỉ được hiển thị một lần, ngay sau khi bạn tạo khóa; sau đó danh sách Khóa API chỉ hiển thị phần đầu của nó. Giá trị không có dấu chấm chỉ là tên của khóa và sẽ bị từ chối. Bất cứ nơi nào hướng dẫn này ghi fl_YOUR_KEY, hãy thay thế toàn bộ bằng khóa hoàn chỉnh của bạn, không có dấu ngoặc kép và không có khoảng trắng.
Nếu không kết nối được. Khóa sai hoặc trống sẽ trả về Missing credential hoặc The Flowmingo API key was rejected; cả hai có thể có nghĩa là giá trị chưa đến được chúng tôi đầy đủ, vì vậy hãy kiểm tra giá trị trước. Cài đặt như ${env:FLOWMINGO_API_KEY} chỉ hoạt động nếu chương trình có thể thấy biến đó và trình soạn thảo mở từ dock hoặc menu Start thường không đọc hồ sơ terminal của bạn. Hãy khởi động từ terminal nơi biến được đặt hoặc đặt khóa hoàn chỉnh vào tệp (và giữ tệp đó ngoài git).
Nên chọn cái nào? Hầu hết máy khách hỗ trợ cả hai; một số (ví dụ: ChatGPT) chỉ dùng OAuth — mỗi tab ghi chú những gì máy khách đó hỗ trợ. Nhìn chung, OAuth phù hợp với trợ lý tương tác (Claude.ai, ChatGPT, VS Code); tiêu đề khóa API phù hợp với CLI, headless/CI và trình soạn thảo nơi bạn muốn dán khóa trực tiếp.
Những gì bạn có thể làm
Các thao tác đọc không cần phê duyệt. Hầu hết các thao tác ghi đều có kiểm soát. Lời mời, từ chối bằng hành động Reject, xóa ứng viên khỏi dự án, xóa dự án hoặc thông thường, chuyển sang giai đoạn được cài đặt để gửi email cho ứng viên, sẽ chờ người phê duyệt tại một liên kết, đăng nhập vào Flowmingo. Trợ lý không thể phê duyệt và việc gõ "có" trong khung chat không được tính. Cài đặt email của giai đoạn được kiểm tra khi yêu cầu chuyển được thực hiện. Đối với ghi chú, xếp hạng, danh sách rút gọn, thẻ hoặc chuyển đến giai đoạn không được cài đặt gửi email cho ứng viên, trợ lý được yêu cầu hiển thị bản xem trước trước và chỉ thực hiện khi bạn đồng ý, đây là hướng dẫn cho trợ lý, không phải khóa cứng. Lời nhắc mà máy khách AI của bạn hiển thị trước khi chạy công cụ là của riêng máy khách, không phải sự phê duyệt của Flowmingo: lời mời, từ chối bằng hành động Reject và chuyển đến giai đoạn gửi email vẫn chờ liên kết phê duyệt, bất kể máy khách yêu cầu gì. Liên kết phê duyệt hết hạn sau 15 phút và một yêu cầu cho nhiều ứng viên hoặc đơn ứng tuyển (tối đa 50) là một lần phê duyệt liệt kê tất cả mọi người. Sau khi thay đổi được xếp hàng, trợ lý có thể kiểm tra trạng thái, rút lại khi vẫn đang chờ và hoàn tác thay đổi có thể đảo ngược (ghi chú, xếp hạng, đánh dấu danh sách rút gọn, thẻ hoặc chuyển không gửi email cho ai) trong vòng 24 giờ. Không phải lúc nào cũng có thể hoàn tác: thay đổi phải trả về tham chiếu hoàn tác, việc ghi lại là nỗ lực tốt nhất và việc chuyển ứng viên không có giai đoạn trước đó không có tham chiếu đó, vì vậy trợ lý nên kiểm tra và nói rõ khi không có cách quay lại. Email đã gửi không thể hoàn tác. Các công cụ được liệt kê trong Create and publish là ngoại lệ cho tất cả những điều này, ngoại trừ delete_project: chúng hoạt động ngay lập tức và không được xếp hàng để phê duyệt. Việc xóa và xóa dự án không thể hoàn tác. Mọi thứ được giới hạn trong tổ chức của bạn.
Đọc
| Khả năng | Chức năng |
|---|---|
| Danh sách bài đăng tuyển dụng | Duyệt các vai trò đang mở và đã đóng của tổ chức bạn. |
| Liệt kê bộ phỏng vấn & dự án | Xem các bài đánh giá (bộ phỏng vấn) của bạn ở mọi loại (phỏng vấn AI, nhập vai, Bài kiểm tra kỹ năng, Bài kiểm tra kỹ thuật, đánh giá CV, Showcase và bản ghi; bảng câu hỏi khi bạn yêu cầu) và các dự án tuyển dụng của bạn. |
| Liệt kê kênh ứng viên của bạn | Xem đơn ứng tuyển theo giai đoạn trong một dự án. |
| Đọc kết quả & điểm đánh giá | Lấy kết quả ở mọi loại: phỏng vấn AI, nhập vai, Bài kiểm tra kỹ năng, Bài kiểm tra kỹ thuật, đánh giá CV, Showcase, bản ghi và bảng câu hỏi. Mỗi kết quả được gắn nhãn loại. Chỉ một số loại có điểm AI: Showcase và bảng câu hỏi không bao giờ được chấm điểm và Bài kiểm tra kỹ năng là tỷ lệ phần trăm. |
| Tra cứu ứng viên | Lấy tên, email và CV của một ứng viên. |
| Tìm kiếm ứng viên | Tìm ứng viên theo tên hoặc email. |
| So sánh ứng viên | Xếp 2 đến 10 ứng viên cạnh nhau. Cần quyền Read candidates cũng như Read hiring data. |
| Tổng quan tuyển dụng | Kênh tuyển dụng cho mọi thứ mà kết nối của bạn có thể truy cập (toàn công ty, trừ khi khóa được tạo bởi người bị giới hạn trong một số dự án) hoặc thu hẹp khi bạn yêu cầu: đơn ứng tuyển theo giai đoạn, đang hoạt động so với bị từ chối và đối với từng loại đánh giá có kết quả, kết quả hoàn thành so với đang thực hiện và điểm trung bình. Một dự án thu hẹp mọi số đếm, nhưng số kết quả của nó bao gồm các kết quả trên các bài đánh giá được liên kết với dự án đó, vì vậy ứng viên của một dự án khác dùng chung một trong các bài đánh giá đó cũng có thể được tính. Một bài đánh giá chỉ thu hẹp số kết quả: số giai đoạn và đơn ứng tuyển vẫn giữ nguyên cho mọi thứ mà kết nối của bạn có thể truy cập. Các loại không bao giờ được cộng lại với nhau. |
| Ứng viên xuất sắc nhất | Các kết quả xếp hạng cao nhất, được sắp xếp theo điểm tổng. Mọi loại đánh giá được xếp hạng cùng nhau trừ khi bạn yêu cầu một loại hoặc một bài đánh giá (bộ phỏng vấn). |
| Chi tiết kết quả đánh giá | Điểm theo năng lực của một kết quả cộng với tóm tắt AI, cho các loại có. Bài kiểm tra kỹ năng, Bài kiểm tra kỹ thuật, Showcase và bảng câu hỏi có ít hoặc không có. |
| Chi tiết bài đăng tuyển dụng | Thông tin chi tiết đầy đủ của một bài đăng tuyển dụng. |
Bài đăng tuyển dụng có mở công khai không? (get_job_post_publication) |
Liệu bất kỳ ai có thể mở trang công khai của bài đăng: đang hoạt động, vẫn đang chờ kiểm tra nội dung AI, bị từ chối bởi nó, bị gắn cờ, tắt hay dự án của nó không mở. Cũng có địa chỉ công khai và mức tăng cường (tắt, flowmingo hoặc mở rộng). Cần Read hiring data. |
| Phỏng vấn sắp tới | Lời mời đến bất kỳ loại đánh giá nào đã được gửi hoặc được lên lịch và chưa hoàn thành. Đây không phải là số lượng tất cả những người còn tồn đọng: lời mời có ứng viên đã được nhắc nhở hoặc đã mở hoặc nhấp vào liên kết sẽ bị bỏ qua cho đến khi ứng viên bắt đầu, cũng như lời mời không gửi được. |
Ghi (có kiểm soát)
| Khả năng | Chức năng |
|---|---|
| Mời ứng viên tham gia đánh giá | Chuẩn bị lời mời cho phỏng vấn AI, nhập vai, Bài kiểm tra kỹ năng hoặc Bài kiểm tra kỹ thuật và chờ người phê duyệt tại một liên kết. Không có gì được gửi trước đó. Một bài đánh giá và tối đa 50 ứng viên mỗi yêu cầu; Bài kiểm tra kỹ năng hoặc Bài kiểm tra kỹ thuật cần một dự án và email cho mỗi ứng viên và bài được tài trợ có thể ghi nợ ví tổ chức của bạn khi ứng viên bắt đầu. |
| Chuyển ứng viên sang giai đoạn khác | Chuyển đến giai đoạn được cài đặt gửi email cho ứng viên thường chờ người phê duyệt tại một liên kết (cài đặt email của giai đoạn được đọc một lần, ngay trước khi chuyển, vì vậy cài đặt được bật vào lúc đó vẫn có thể cho phép chuyển gửi email mà không cần phê duyệt). Bất kỳ chuyển nào khác: trợ lý được yêu cầu xem trước và chờ bạn đồng ý, và thường có thể hoàn tác trong 24 giờ khi có tham chiếu hoàn tác. Tối đa 50 đơn ứng tuyển mỗi yêu cầu. |
| Từ chối đơn ứng tuyển | Yêu cầu phê duyệt tại một liên kết. Nếu người phê duyệt, Flowmingo cố gắng chuyển đơn ứng tuyển đến giai đoạn Rejected của dự án; kiểm tra kết quả sau đó. Tối đa 50 đơn ứng tuyển mỗi yêu cầu. |
Xóa ứng viên khỏi dự án (remove_application) |
Cần Manage pipeline. Yêu cầu phê duyệt tại một liên kết. Nếu người phê duyệt, Flowmingo xóa đơn ứng tuyển khỏi dự án; hồ sơ ứng viên vẫn nằm trong kho ứng viên của bạn và trong các dự án khác. Đây không phải từ chối và không thể hoàn tác. Tối đa 50 đơn ứng tuyển mỗi yêu cầu. |
| Thêm ghi chú vào kết quả | Trợ lý được yêu cầu xem trước ghi chú đề xuất và chờ bạn đồng ý trước khi lưu. Ghi chú thuộc về một kết quả đánh giá (bất kỳ loại nào), không phải toàn bộ ứng viên. |
| Xếp hạng kết quả | Trợ lý được yêu cầu xem trước xếp hạng và chờ bạn đồng ý. Xếp hạng áp dụng cho một kết quả đánh giá. |
| Đưa vào danh sách rút gọn | Trợ lý được yêu cầu xem trước thay đổi danh sách rút gọn và chờ bạn đồng ý. Áp dụng cho một kết quả đánh giá. |
| Gắn thẻ / thêm vào bộ sưu tập tài năng | Trợ lý được yêu cầu xem trước thay đổi thẻ hoặc bộ sưu tập tài năng và chờ bạn đồng ý. |
| Kiểm tra, rút lại hoặc hoàn tác thay đổi | Kiểm tra trạng thái thay đổi được xếp hàng (đang chờ, đã thực hiện, thất bại, hết hạn hoặc bị thay thế bởi yêu cầu mới hơn), rút lại thay đổi vẫn đang chờ phê duyệt hoặc hoàn tác thay đổi có thể đảo ngược trong vòng 24 giờ, khi có tham chiếu hoàn tác. |
Tạo và xuất bản (hoạt động ngay lập tức, trừ việc xóa dự án)
Các công cụ này tạo ra các thứ và mở chúng công khai. Chúng hoạt động khác với các thao tác ghi có kiểm soát ở trên:
- Chúng hoạt động ngay lập tức, trừ
delete_project. Không có gì được xếp hàng để người phê duyệt tại một liên kết và không có công cụ nào gửi email cho ứng viên.delete_projectchờ Chủ sở hữu hoặc Quản trị viên phê duyệt tại một liên kết. - Người tạo khóa phải là Chủ sở hữu hoặc Quản trị viên, đối với mọi công cụ ở đây trừ việc hủy, chỉ cần Invite candidates. Các công cụ hoạt động với quyền của người đã tạo khóa API. Nếu người đó là Thành viên, lệnh gọi sẽ bị từ chối.
- Hai quyền hạn là tùy chọn. Create hiring projects và Create assessments không được cấp theo mặc định. Với đăng nhập (tùy chọn A), trợ lý chỉ nhận được chúng nếu cả hai điều kiện đều đúng: máy khách liệt kê chúng theo tên khi kết nối, và khóa API bạn dán trên trang đồng ý có chúng. Máy khách không gửi danh sách quyền sẽ nhận bốn quyền tiêu chuẩn (Read hiring data, Read candidates, Manage pipeline, Invite candidates) mà khóa có, và không nhận được hai quyền này, vì vậy trợ lý không thấy các công cụ cần chúng. Với khóa tĩnh (tùy chọn B), trợ lý được hiển thị các công cụ này bất kể khóa có quyền gì, và Flowmingo từ chối mọi cuộc gọi mà khóa không cho phép.
- Một số lệnh gọi mất thời gian. Xuất bản chờ kiểm tra nội dung AI, lên tới khoảng 90 giây. Tạo dự án hoặc bài đánh giá sử dụng tạo AI và có thể mất lâu hơn (Bài kiểm tra kỹ thuật mất 3 đến 9 phút). Khi câu trả lời nói công việc vẫn đang chờ xử lý, trợ lý gọi lại với cùng khóa idempotency để đọc tiến trình. Việc thử lại không bao giờ tạo dự án hoặc bài đánh giá thứ hai.
| Khả năng | Chức năng |
|---|---|
Tạo dự án tuyển dụng (create_project) |
Cần Create hiring projects (tùy chọn). Tạo một dự án với bốn giai đoạn mặc định và một bài đăng tuyển dụng được viết bởi cùng AI như bảng điều khiển, từ tiêu đề, vị trí và mô tả tùy chọn. Theo mặc định, nó cũng tạo Đánh giá CV và Phỏng vấn AI; trợ lý có thể đặt tên các bài đánh giá khác hoặc không. Bài đăng được bật và công khai khi kiểm tra nội dung AI phê duyệt, thường trong vòng một phút. Giới hạn 10 dự án mỗi phút và 300 mỗi ngày cho công ty của bạn. Khóa idempotency là tùy chọn: khi bỏ qua, một khóa được tạo từ các đối số, vì vậy việc thử lại không bao giờ tạo dự án thứ hai. |
Tạo bài đánh giá (create_assessment) |
Cần Create assessments (tùy chọn). Tạo một bài đánh giá với AI: Phỏng vấn AI, Đánh giá CV, Bài kiểm tra kỹ năng, Showcase, Bài kiểm tra kỹ thuật hoặc Nhập vai, từ tiêu đề công việc và mô tả công việc tùy chọn, tên, dự án và ngôn ngữ (thẻ như en hoặc vi-VN; Bài kiểm tra kỹ năng và Bài kiểm tra kỹ thuật bỏ qua ngôn ngữ). Đính kèm vào dự án để có thể mời ứng viên tham gia Bài kiểm tra kỹ năng, Bài kiểm tra kỹ thuật hoặc Showcase. Khóa idempotency là tùy chọn, như trên. |
Xuất bản bài đăng tuyển dụng (publish_job_post) |
Cần Create hiring projects. Bật bài đăng và đảm bảo kiểm tra nội dung AI đã chạy. Câu trả lời cho biết trang có đang hoạt động, vẫn đang chờ kiểm tra hay bị từ chối. Dự án tuyển dụng phải đang hoạt động. |
Hủy xuất bản bài đăng tuyển dụng (unpublish_job_post) |
Cần Create hiring projects. Tắt bài đăng, vì vậy liên kết công khai ngừng mở. Theo mặc định, tăng cường cũng được tắt (withdraw_boost là true). |
Tăng cường bài đăng tuyển dụng (boost_job_post) |
Cần Create hiring projects. Đặt tăng cường thành off, flowmingo hoặc extended. Tăng cường miễn phí. Nâng cấp cần bài đăng được bật, dự án hoạt động, logo công ty và mô tả, và kiểm tra nội dung AI; công ty có thể nâng 50 lần mỗi ngày. |
Mở, nháp hoặc lưu trữ dự án (set_project_state) |
Cần Create hiring projects. Di chuyển một dự án tuyển dụng giữa active, draft và archived. Bản nháp và đã lưu trữ sẽ đóng liên kết công việc. Dữ liệu ứng viên được giữ lại. |
Hủy lời mời đã lên lịch (cancel_scheduled_invite) |
Cần Invite candidates. Hủy lời mời được lên lịch sau và chưa được gửi, sử dụng mã lời mời từ kết quả mời. Không ai bị gửi email. Người đó vẫn ở trong tài khoản của bạn và trên bảng dự án. |
Xóa dự án tuyển dụng (delete_project) |
Cần Create hiring projects (tùy chọn). Nó chỉ yêu cầu: không xóa ngay lập tức, yêu cầu phê duyệt tại một liên kết và không có gì bị xóa cho đến khi Chủ sở hữu hoặc Quản trị viên phê duyệt. Chỉ có dự án đang hoạt động mới có thể bị xóa. Nếu người phê duyệt, Flowmingo xóa dự án và bài đăng tuyển dụng của nó; đơn ứng tuyển không bị xóa từng cái một và hồ sơ ứng viên và thông tin liên lạc, bài đánh giá của bạn và liên kết mời được giữ. Không thể hoàn tác. |
Bảo mật & độ tin cậy
- Dữ liệu của bạn được giới hạn trong tổ chức — trợ lý không bao giờ có thể thấy dữ liệu của công ty khác.
- Với OAuth, trợ lý không bao giờ nhận được khóa API của bạn. Nó nhận mã truy cập hết hạn sau một giờ, được làm mới âm thầm khi vẫn kết nối. Việc đăng nhập kéo dài bằng mã làm mới của nó, khoảng 30 ngày mặc định từ khi được cấp hoặc làm mới gần nhất, vì vậy nó hết hạn sau khoảng 30 ngày không sử dụng và bạn đăng nhập lại. Với tiêu đề tĩnh (tùy chọn B), máy khách của trợ lý giữ khóa của bạn và gửi nó với mỗi yêu cầu, vì vậy hãy tránh đưa vào các tệp bạn có thể chia sẻ hoặc commit.
- Cắt kết nối trợ lý: xóa khóa API bạn đã cấp quyền cho nó trong Cài đặt → Tích hợp → Khóa API. Truy cập dừng ngay lập tức. Chưa có tính năng ngắt kết nối riêng cho từng trợ lý, vì vậy nếu bạn muốn thu hồi từng cái, hãy cấp cho mỗi trợ lý một khóa riêng.
- Các yêu cầu đến endpoint
/mcpđược kiểm tra Origin: originnullkhông rõ ràng luôn bị từ chối và kiểm tra có thể bị khóa vào danh sách cho phép, nhưng theo mặc định, mọi origin thực đều được chấp nhận, vì vậy sự bảo vệ là thông tin xác thực của bạn, không phải origin. Mỗi phiên được liên kết với thông tin xác thực đã mở nó.
Để biết cách xác thực, xem Xác thực — hai tùy chọn; để biết chính xác các thao tác đọc, ghi có kiểm soát và hành động ngay lập tức, xem Những gì bạn có thể làm. Khi sẵn sàng, hãy chuyển đến Kết nối trợ lý của bạn và chọn máy khách của bạn.
URL máy chủ MCP
Kết nối trợ lý của bạn
Claude Code (CLI)
Một lệnh thêm Flowmingo qua Streamable HTTP gốc. Dẫn đầu bằng OAuth; tùy chọn --header tĩnh là phương án thay thế.
Các bước: 1) thêm máy chủ, 2) đăng nhập (trình duyệt → dán khóa), 3) claude mcp list để xác minh.
# 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
Lưu ý: các cờ phải đặt trước tên, và luôn dùng --transport http (không bao giờ dùng sse). Thay fl_YOUR_KEY bằng khóa đầy đủ của bạn (xem Khóa đầy đủ trông như thế nào trong phần Xác thực ở trên).
Kiểm tra hoạt động — hãy hỏi: "liệt kê các công việc đang mở của tôi."
Cursor
Tiêu đề tĩnh là cách đơn giản nhất. Cursor cũng có thể sử dụng OAuth (hỗ trợ Đăng ký Máy khách Động) — để làm vậy, hãy bỏ khối headers.
Các bước: 1) thêm máy chủ vào ~/.cursor/mcp.json (bên dưới), 2) đặt FLOWMINGO_API_KEY thành khóa đầy đủ của bạn trong hồ sơ shell, 3) thoát Cursor và khởi động lại từ terminal nơi biến được đặt, 4) trong Cài đặt → MCP, bật/tắt máy chủ để tải lại.
Cursor phải nhìn thấy biến. Cursor đọc ${env:FLOWMINGO_API_KEY} từ môi trường của chính nó. Khi khởi động từ dock hoặc Start menu, nó thường không nhìn thấy biến được đặt trong hồ sơ terminal, và header sẽ trống hoặc không được mở rộng, và máy chủ trả lời Missing credential. Nếu việc khởi động Cursor từ terminal là không khả thi, hãy thay thế ${env:FLOWMINGO_API_KEY} trong tệp bằng khóa đầy đủ của bạn (và giữ ~/.cursor/mcp.json ngoài git).
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
}
}
}
Thay vào đó dùng OAuth — bỏ khối headers; Cursor chạy Đăng ký Máy khách Động và mở trang đồng ý trong trình duyệt khi kết nối lần đầu:
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp"
}
}
}
Kiểm tra hoạt động — hỏi: "liệt kê các công việc đang mở của tôi."
VS Code (Copilot, chế độ tác nhân)
Các công cụ chỉ xuất hiện trong Copilot Chat → Chế độ tác nhân. Khóa gốc là servers (không phải mcpServers) và loại là http. Đường dẫn nhập liệu theo lời nhắc bên dưới là thiết lập đáng tin cậy.
Các bước: 1) tạo .vscode/mcp.json (hoặc chạy MCP: Thêm Máy chủ → HTTP), 2) khi bạn khởi động máy chủ, VS Code sẽ yêu cầu khóa của bạn (khóa không được ghi vào tệp), 3) sử dụng nó trong Chế độ tác nhâ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 cũng có thể thử OAuth, nhưng cấu hình OAuth được ghi lại yêu cầu ID khách hàng; hãy sử dụng đường dẫn nhập liệu theo lời nhắc ở trên để có một thiết lập đáng tin cậy.
Xác minh nó hoạt động — hỏi: "liệt kê các công việc đang mở của tôi."
Claude — claude.ai & Claude Desktop
Cả hai đều sử dụng Giao diện Người dùng Trình kết nối giống nhau và quy trình dán URL giống nhau. Chỉ hỗ trợ OAuth (không có trường header trong giao diện người dùng).
Các bước (web hoặc desktop):
- Mở Cài đặt → Trình kết nối và nhấp vào Thêm trình kết nối tùy chỉnh.
- Đặt tên là
Flowmingovà dán URL máy chủ MCP ở trên. Để trống phần Nâng cao → OAuth Client ID / Secret. - Nhấp vào Thêm → Kết nối. Trên trang đồng ý của Flowmingo, dán khóa API
fl_của bạn và ủy quyền. - Xác minh — hỏi Claude: "liệt kê các công việc đang mở của tôi."
Remote MCP server URL: https://mcp.flowmingo.ai/mcp
Advanced → OAuth Client ID / Secret: (leave blank — Flowmingo uses Dynamic Client Registration)
Nhóm / Doanh nghiệp: Một Chủ sở hữu thêm nó một lần trong Cài đặt Tổ chức → Trình kết nối → Tùy chỉnh; sau đó các thành viên nhấp vào Kết nối.
Cần khóa tĩnh trên Claude Desktop thay thế? Sử dụng tab Bất kỳ máy khách nào (mcp-remote).
Trình duyệt của bạn sẽ mở một trang cho phép Flowmingo khi kết nối lần đầu — dán khóa API của bạn và ủy quyền. Để ngắt kết nối sau này, hãy xóa khóa API đó trong Cài đặt → Tích hợp → Khóa API.
ChatGPT & OpenAI Codex CLI
Cả hai đều là OpenAI. ChatGPT sử dụng Chế độ nhà phát triển cho các đầu nối tùy chỉnh (chỉ OAuth); Codex kết nối trực tiếp từ CLI.
ChatGPT (web)
- Trên chatgpt.com (Plus / Pro / Business / Enterprise / Edu — không phải mobile), mở Cài đặt → Ứng dụng → Nâng cao và bật Chế độ nhà phát triển.
- Ứng dụng → Tạo → đặt tên
Flowmingo, dán URL bên dưới, phương thức truyền Streamable HTTP, xác thực OAuth. - Mở bản nháp, bật các công cụ và Làm mới.
- Đính kèm qua menu + trong cuộc trò chuyện.
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)
Chế độ nhà phát triển của ChatGPT kết nối với chỉ OAuth — nó không chấp nhận tiêu đề x-api-key / khóa API tùy chỉnh tĩnh. Các đầu nối nghiên cứu thông thường và chuyên sâu chỉ sử dụng search + fetch (bạn có cả hai). Các công cụ ghi (mời / di chuyển / từ chối) yêu cầu Chế độ nhà phát triển. Lời nhắc mà ChatGPT hiển thị trước khi chạy một công cụ là của riêng ChatGPT và không phải là sự phê duyệt của Flowmingo: một lời mời, một từ chối và một di chuyển vào giai đoạn gửi email cho ứng viên luôn chờ một người phê duyệt tại liên kết Flowmingo.
OpenAI Codex CLI
Không cần cầu nối — Codex nói Streamable HTTP một cách tự nhiên.
# ~/.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
Xác minh nó hoạt động — hỏi: "liệt kê công việc đang mở của tôi."
Gemini CLI & Hỗ trợ Code
Gemini CLI (và tác nhân Hỗ trợ Code Gemini) truy cập máy chủ MCP từ xa thông qua ~/.gemini/settings.json. Ứng dụng Gemini tiêu dùng không thể thêm trình kết nối MCP tùy chỉnh — đường dẫn này chỉ dành cho CLI / Hỗ trợ Code.
Các bước: 1) thêm máy chủ vào mcpServers trong ~/.gemini/settings.json, 2) xuất FLOWMINGO_API_KEY=fl_..., 3) chạy gemini và /mcp để xác nhận các công cụ đã được liệt kê.
{
"mcpServers": {
"flowmingo": {
"httpUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${FLOWMINGO_API_KEY}" },
"timeout": 30000
}
}
}
httpUrl chọn Streamable HTTP gốc. Placeholder ${FLOWMINGO_API_KEY} được mở rộng từ môi trường của bạn, vì vậy không có khóa thô nào được ghi vào tệp. Ưu tiên OAuth? Gemini CLI có thể thực hiện điều đó gốc — bỏ khối headers và thêm "authProviderType": "dynamic_discovery" vào mục máy chủ. CLI phát hiện thách thức 401, khám phá siêu dữ liệu OAuth của chúng tôi và tự động thực hiện đăng ký khách hàng (không cần đặt ID khách hàng).
Xác minh nó hoạt động — trong
gemini, hỏi: "liệt kê các công việc đang mở của tôi."
Khách hàng khác — Windsurf · Zed · Cline · Continue · Antigravity
Mỗi khách hàng bên dưới hoạt động với cùng một máy chủ — hầu hết hỗ trợ cả OAuth và một header tĩnh. Các đoạn mã sử dụng một khóa tĩnh qua biến môi trường; bỏ phần headers để cho khách hàng chạy OAuth nếu nó hỗ trợ. Lưu ý các bẫy tên khóa riêng của từng khách hàng được nêu dưới đây.
Google Antigravity
Thêm https://mcp.flowmingo.ai/mcp làm máy chủ MCP từ xa và chọn xác thực nó: một trang Flowmingo sẽ mở và yêu cầu khóa API đầy đủ của bạn (xem Khóa đầy đủ trông như thế nào trong phần Xác thực ở trên). Mỗi bề mặt Antigravity (IDE, CLI) đăng nhập riêng. Trong mcp_config.json của Antigravity, địa chỉ đi dưới serverUrl, và khóa tĩnh nằm trong khối headers dưới dạng Authorization với Bearer và khóa đầy đủ của bạn, như trong ví dụ Antigravity MCP của Google. Chúng tôi chưa thể kiểm tra mọi phiên bản Antigravity, vì vậy nếu menu của bạn khác, hướng dẫn của Google có các bước hiện tại.
Windsurf (Cascade)
~/.codeium/windsurf/mcp_config.json — Windsurf chấp nhận serverUrl hoặc url, và hỗ trợ OAuth (bỏ headers để kích hoạt nó).
{ "mcpServers": { "flowmingo": {
"serverUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Zed
~/.config/zed/settings.json — khóa là context_servers; bỏ headers cho OAuth gốc. Đặt FLOWMINGO_API_KEY=fl_... trong môi trường của bạn thay vì dán khóa thô.
{ "context_servers": { "flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Cline
MCP Servers → Configure — đặt type: "streamableHttp" (camelCase), nếu không nó mặc định là SSE chết.
{ "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 — kết nối qua cầu mcp-remote. Đặt 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 }}"]
Kiểm tra hoạt động — hỏi: "liệt kê công việc đang mở của tôi."
Bất kỳ client nào (mcp-remote)
Đối với chỉ-stdio client (hoặc client tương lai không có transport từ xa gốc), kết nối với Flowmingo bằng lệnh stdio mcp-remote. Bắt buộc --transport http-only — máy chủ không có SSE.
Các bước: 1) đảm bảo Node ≥ 18, 2) chạy bridge như một lệnh stdio trong client của bạn, 3) ở lần xác thực OAuth đầu tiên, trình duyệt mở ra — dán khóa của bạ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" }
}
}
}
Khôi phục: nếu xác thực bị kẹt, chạy rm -rf ~/.mcp-auth và thử lại. Thay fl_YOUR_KEY bằng khóa đầy đủ của bạn (xem Khóa đầy đủ trông như thế nào trong phần Xác thực ở trên). Trong args[] JSON, tránh khoảng trắng sau dấu hai chấm của header (lỗi thoát npx).
Kiểm tra hoạt động — hỏi: "liệt kê công việc đang mở của tôi."