개요
MCP 호환 AI 어시스턴트를 Flowmingo 채용 데이터에 연결하세요 — 채용 공고와 지원자를 읽고, 안전하게 권한 있는 작업(초대, 이동, 거절, 프로젝트에서 제거)을 수행할 수 있습니다. 두 가지 추가 권한을 직접 켜면, 어시스턴트가 채용 프로젝트와 평가를 생성하고 채용 공고를 게시, 마감 또는 부스트할 수도 있습니다 (할 수 있는 작업 참조). MCP가 처음이신가요? AI 어시스턴트가 Flowmingo와 같은 도구와 대화할 수 있게 하는 공개 표준입니다. MCP가 무엇인지 알아보기.
전송: Streamable HTTP (최신 원격 전송). 레거시 SSE는 없습니다 — 항상 클라이언트를 /mcp로 지정하고, /sse는 사용하지 마세요.
API 키를 비밀번호처럼 취급하세요. OAuth, 프롬프트 입력, 또는 환경 변수를 사용하여 git에 커밋할 수 있는 파일(예:
.vscode/mcp.json,~/.cursor/mcp.json, Continue 설정)에 원시fl_...키를 붙여넣는 것보다 선호합니다.
인증 — 두 가지 옵션
A — Flowmingo로 로그인 (OAuth, 권장). 브라우저에서 Flowmingo 동의 페이지가 열리고, API 키를 붙여넣습니다. 어시스턴트는 원시 키를 받지 않습니다. 대신 액세스 토큰과 리프레시 토큰을 받아 새 액세스 토큰을 얻는 데 사용할 수 있습니다. 로그인은 영원히 지속되지 않습니다. 리프레시 토큰은 기본적으로 발급 시점(로그인 또는 최신 리프레시)부터 약 30일 동안 유효하므로, 약 30일 동안 사용되지 않으면 만료되고, Flowmingo 릴리스에서 로그인 저장 방식을 변경하면 다시 로그인해야 할 수 있습니다. 어시스턴트가 다시 로그인을 요청하면 키를 다시 붙여넣어야 합니다. 더 일찍 중단하려면 해당 API 키를 삭제하세요. 클라이언트 ID나 시크릿을 만들 필요가 없습니다 (Flowmingo는 동적 클라이언트 등록 사용). "고급" OAuth 설정을 표시하는 클라이언트(예: Claude.ai)에서는 클라이언트 ID와 시크릿을 비워 두세요.
B — 정적 API 키 (헤더). 키를 다음 헤더 중 하나로 보내세요:
x-api-key: fl_YOUR_KEY
Authorization: Bearer fl_YOUR_KEY
키를 Flowmingo → 설정 → 통합 → API 키에서 받으세요. Read hiring data 및 Read candidates을 체크하세요 — 첫 번째는 채용 공고, 파이프라인 및 결과를 포함하고, 두 번째는 어시스턴트가 지원자를 조회할 수 있게 합니다. 보호된 쓰기 작업을 위해 Manage pipeline / Invite candidates을 추가하세요. 어시스턴트가 프로젝트와 평가를 생성하고 채용 공고를 게시하거나 부스트하도록 하려면 Create hiring projects 및 Create assessments도 체크하세요. 먼저 "할 수 있는 작업"에서 만들기 및 게시를 읽으세요: 이 두 권한은 선택 사항이며, 키 생성자는 소유자 또는 관리자여야 합니다.
완전한 키의 형태. 하나의 긴 값: fl_live_, 키의 공개 이름, 점, 긴 시크릿. 시크릿 절반은 키 생성 직후 한 번만 표시됩니다. 이후 API 키 목록에는 시작 부분만 표시됩니다. 점이 없는 값은 키 이름일 뿐이며 거부됩니다. 이 가이드에 fl_YOUR_KEY라고 쓰여 있으면 전체 키로 바꾸고 따옴표나 공백 없이 사용하세요.
연결이 안 되는 경우. 잘못되었거나 빈 키는 Missing credential 또는 The Flowmingo API key was rejected로 반환됩니다. 둘 다 값이 완전히 도달하지 않았음을 의미할 수 있으므로 먼저 값을 확인하세요. ${env:FLOWMINGO_API_KEY}와 같은 설정은 프로그램이 해당 변수를 볼 수 있을 때만 작동하며, 독(Dock)이나 시작 메뉴에서 연 편집기는 터미널 프로필을 읽지 못하는 경우가 많습니다. 변수가 설정된 터미널에서 시작하거나, 파일에 전체 키를 넣고 (해당 파일을 git에서 제외) 사용하세요.
어떤 것을 선택할까요? 대부분의 클라이언트는 둘 다 지원합니다. 일부(예: ChatGPT)는 OAuth 전용입니다. 각 탭에서 해당 클라이언트가 지원하는 내용을 확인하세요. 일반적으로 OAuth는 대화형 어시스턴트(Claude.ai, ChatGPT, VS Code)에 적합하고, API 키 헤더는 CLI, 헤드리스/CI, 그리고 키를 바로 넣고 싶은 편집기에 적합합니다.
할 수 있는 작업
읽기는 승인 없이 수행됩니다. 대부분의 쓰기는 보호됩니다. 초대, 거절 작업으로 만든 거절, 프로젝트에서 지원자 제거, 프로젝트 삭제, 또는 일반적으로 후보자에게 이메일을 보내도록 설정된 단계로의 이동은 Flowmingo에 로그인한 사람이 링크에서 승인할 때까지 대기합니다. 어시스턴트는 승인할 수 없으며, 채팅에 "예"를 입력하는 것은 승인으로 간주되지 않습니다. 단계의 이메일 설정은 이동이 요청될 때 확인됩니다. 메모, 평점, 숏리스트, 태그 또는 후보자에게 이메일을 보내지 않도록 설정된 단계로의 이동의 경우, 어시스턴트는 먼저 미리 보기를 표시하고 동의한 경우에만 진행하도록 지시받습니다. 이는 지시사항이지 잠금이 아닙니다. AI 클라이언트가 도구를 실행하기 전에 표시하는 프롬프트는 클라이언트 자체의 것이며 Flowmingo의 승인이 아닙니다: 초대, 거절 작업으로 만든 거절, 이메일을 보내는 단계로의 이동은 클라이언트가 무엇을 요청했든 승인 링크를 기다립니다. 승인 링크는 15분 후 만료되며, 여러 지원자/지원서(최대 50명)에 대한 하나의 요청은 모든 사람을 나열하는 하나의 승인입니다. 변경이 준비되면 어시스턴트는 상태를 확인하고, 대기 중인 변경을 철회하거나, 24시간 이내에 되돌릴 수 있는 변경(메모, 평점, 숏리스트 표시, 태그 또는 아무에게도 이메일을 보내지 않은 이동)을 되돌릴 수 있습니다. 되돌리기가 항상 가능한 것은 아닙니다: 변경에 되돌리기 참조가 함께 반환되어야 하며, 기록하는 것은 최선의 노력이며, 이전 단계가 없는 후보자의 이동에는 되돌리기 참조가 없으므로, 어시스턴트는 되돌릴 방법이 없을 때 확인하고 알려야 합니다. 이미 보낸 이메일은 되돌릴 수 없습니다. 만들기 및 게시에 나열된 도구는 delete_project를 제외하고 이 모든 것의 예외입니다: 즉시 실행되며 승인을 위해 준비되지 않습니다. 제거 및 프로젝트 삭제는 되돌릴 수 없습니다. 모든 것은 조직 범위로 제한됩니다.
읽기
| 기능 | 설명 |
|---|---|
| 채용 공고 목록 | 조직의 공개 및 마감 직무를 탐색합니다. |
| 인터뷰 세트 및 프로젝트 목록 | 모든 종류의 평가(인터뷰 세트)를 확인합니다 (AI 인터뷰, 롤플레이, 스킬 테스트, 기술 테스트, CV 평가, 쇼케이스 및 녹화; 요청 시 설문지) 및 채용 프로젝트. |
| 후보자 파이프라인 목록 | 프로젝트의 단계별 지원자 현황을 확인합니다. |
| 평가 결과 및 점수 읽기 | 모든 종류의 결과를 가져옵니다: AI 인터뷰, 롤플레이, 스킬 테스트, 기술 테스트, CV 평가, 쇼케이스, 녹화 및 설문지. 각 결과는 종류로 표시됩니다. 일부 종류만 AI 점수를 포함합니다: 쇼케이스와 설문지는 절대 점수가 없고, 스킬 테스트는 백분율입니다. |
| 후보자 조회 | 한 후보자의 이름, 이메일, CV를 가져옵니다. |
| 후보자 검색 | 이름 또는 이메일로 후보자를 찾습니다. |
| 후보자 비교 | 2~10명의 후보자를 나란히 비교합니다. Read candidates 권한과 Read hiring data 권한이 필요합니다. |
| 채용 개요 | 연결이 접근할 수 있는 모든 것에 대한 퍼널 (특정 프로젝트로 제한된 키가 아닌 경우 전체 회사), 또는 요청 시 좁혀진 범위: 단계별 지원자 수, 활성 vs 거절, 그리고 결과가 있는 각 평가 종류에 대해 완료 vs 진행 중 결과 및 평균 점수. 프로젝트는 모든 수를 좁히지만, 결과 수는 해당 프로젝트에 연결된 평가의 결과를 포함하므로, 해당 평가를 공유하는 다른 프로젝트의 후보자도 포함될 수 있습니다. 평가는 결과 수만 좁힙니다: 단계 및 지원자 수는 연결이 접근할 수 있는 모든 것에 유지됩니다. 종류는 합산되지 않습니다. |
| 상위 후보자 | 전체 점수 순으로 정렬된 최고 순위 결과. 특정 종류나 특정 평가(인터뷰 세트)를 요청하지 않는 한 모든 종류의 평가가 함께 순위가 매겨집니다. |
| 평가 결과 상세 | 하나의 결과에 대한 역량별 점수 및 AI 요약 (해당 종류의 경우). 스킬 테스트, 기술 테스트, 쇼케이스 및 설문지는 거의 또는 전혀 없습니다. |
| 채용 공고 상세 | 단일 채용 공고의 전체 세부 정보. |
채용 공고가 공개되어 있나요? (get_job_post_publication) |
누구나 채용 공고의 공개 페이지를 열 수 있는지 여부: 활성, AI 콘텐츠 검사 대기 중, 거부됨, 플래그됨, 꺼짐, 또는 프로젝트가 열려 있지 않음. 또한 공개 주소 및 부스트 상태(꺼짐, flowmingo 또는 확장). Read hiring data 필요. |
| 예정된 인터뷰 | 모든 종류의 평가에 대한 초대가 전송되었거나 예약되었지만 아직 완료되지 않은 초대. 아직 완료되지 않은 모든 사람의 수는 아닙니다: 후보자가 리마인드되거나 링크를 열었거나 클릭한 초대는 후보자가 시작할 때까지 제외되며, 전달에 실패한 초대도 제외됩니다. |
쓰기 (보호됨)
| 기능 | 설명 |
|---|---|
| 평가에 후보자 초대 | AI 인터뷰, 롤플레이, 스킬 테스트 또는 기술 테스트에 대한 초대를 준비하고, 사람이 링크에서 승인할 때까지 대기합니다. 그 전에는 아무것도 전송되지 않습니다. 요청당 하나의 평가와 최대 50명의 후보자; 스킬 테스트 또는 기술 테스트에는 프로젝트와 모든 후보자의 이메일이 필요하며, 후원된 테스트는 후보자가 시작할 때 조직의 지갑에서 차감될 수 있습니다. |
| 후보자를 다른 단계로 이동 | 후보자에게 이메일을 보내도록 설정된 단계로의 이동은 일반적으로 사람이 링크에서 승인할 때까지 대기합니다 (단계의 이메일 설정은 이동 직전에 한 번 읽히므로, 그 시점에 켜진 설정은 승인 없이 이메일을 보낼 수 있습니다). 다른 이동: 어시스턴트는 미리 보기를 표시하고 승인을 기다리도록 지시받으며, 되돌리기 참조가 반환된 경우 24시간 동안 되돌릴 수 있습니다. 요청당 최대 50개의 지원서. |
| 지원 거절 | 링크에서 승인을 요청합니다. 사람이 승인하면 Flowmingo는 지원서를 프로젝트의 거절 단계로 이동하려고 시도합니다. 결과를 확인하세요. 요청당 최대 50개의 지원서. |
프로젝트에서 후보자 제거 (remove_application) |
Manage pipeline 필요. 링크에서 승인을 요청합니다. 사람이 승인하면 Flowmingo는 프로젝트에서 지원서를 삭제합니다. 후보자의 프로필은 인재 풀과 다른 프로젝트에 유지됩니다. 거절이 아니며 되돌릴 수 없습니다. 요청당 최대 50개의 지원서. |
| 결과에 메모 추가 | 어시스턴트는 제안된 메모를 미리 보고 저장 전에 승인을 기다리도록 지시받습니다. 메모는 한 평가 결과(모든 종류)에 속하며, 후보자 전체에 속하지 않습니다. |
| 결과 평점 | 어시스턴트는 평점을 미리 보고 승인을 기다리도록 지시받습니다. 평점은 한 평가 결과에 적용됩니다. |
| 결과 숏리스트 | 어시스턴트는 숏리스트 변경을 미리 보고 승인을 기다리도록 지시받습니다. 한 평가 결과에 적용됩니다. |
| 태그 / 인재 컬렉션에 추가 | 어시스턴트는 태그 또는 인재 컬렉션 변경을 미리 보고 승인을 기다리도록 지시받습니다. |
| 변경 확인, 철회 또는 되돌리기 | 준비된 변경의 상태를 확인하고(대기, 실행, 실패, 만료 또는 새 요청으로 대체됨), 승인을 기다리는 변경을 철회하거나, 되돌리기 참조가 반환된 경우 24시간 이내에 되돌릴 수 있는 변경을 되돌립니다. |
만들기 및 게시 (프로젝트 삭제 제외, 즉시 실행)
이 도구들은 항목을 만들고 공개합니다. 위의 보호된 쓰기와 다르게 동작합니다:
delete_project를 제외하고 즉시 실행됩니다. 사람이 링크에서 승인할 준비가 되지 않으며, 후보자에게 이메일을 보내지 않습니다.delete_project는 소유자 또는 관리자가 링크에서 승인할 때까지 대기합니다.- 키 생성자는 모든 도구에 대해 소유자 또는 관리자여야 합니다. 취소는 Invite candidates만 필요합니다. 도구는 API 키를 생성한 사람의 권한으로 실행됩니다. 그 사람이 멤버인 경우 호출이 거부됩니다.
- 두 가지 권한은 선택 사항입니다. Create hiring projects 및 Create assessments는 기본적으로 부여되지 않습니다. 로그인(옵션 A)을 사용하는 경우, 어시스턴트는 다음 두 조건이 모두 충족될 때만 해당 권한을 받습니다: 클라이언트가 연결 시 권한을 이름으로 명시하고, 동의 페이지에 붙여넣은 API 키에 해당 권한이 포함되어 있어야 합니다. 권한 목록을 보내지 않는 클라이언트는 키에 포함된 네 가지 표준 권한(Read hiring data, Read candidates, Manage pipeline, Invite candidates)만 받으며, 이 두 가지는 받지 않으므로 어시스턴트는 해당 권한이 필요한 도구를 볼 수 없습니다. 정적 키(옵션 B)를 사용하는 경우, 키에 포함된 권한과 관계없이 어시스턴트에게 이러한 도구가 표시되며, Flowmingo는 키가 허용하지 않는 호출을 거부합니다.
- 일부 호출은 시간이 걸립니다. 게시는 AI 콘텐츠 검사를 최대 약 90초 동안 기다립니다. 프로젝트 또는 평가 생성은 AI 생성에 시간이 걸릴 수 있습니다 (기술 테스트는 3~9분). 응답이 작업이 아직 진행 중이라고 하면, 어시스턴트는 동일한 멱등 키로 다시 호출하여 진행 상황을 읽습니다. 재시도는 두 번째 프로젝트나 평가를 만들지 않습니다.
| 기능 | 설명 |
|---|---|
채용 프로젝트 생성 (create_project) |
Create hiring projects (선택 사항) 필요. 대시보드와 동일한 AI로 작성된 채용 공고와 함께 네 가지 기본 단계를 가진 프로젝트를 만듭니다. 제목, 직위 및 선택적 설명으로부터. 기본적으로 CV 평가와 AI 인터뷰도 만듭니다. 어시스턴트는 다른 평가를 지정하거나 없음을 지정할 수 있습니다. 채용 공고는 AI 콘텐츠 검사가 승인하면 켜지고 공개되며, 일반적으로 1분 이내에 완료됩니다. 회사당 분당 10개, 하루 300개로 제한됩니다. 멱등 키는 선택 사항입니다: 생략하면 인수에서 생성되므로 재시도는 두 번째 프로젝트를 만들지 않습니다. |
평가 생성 (create_assessment) |
Create assessments (선택 사항) 필요. AI로 하나의 평가를 만듭니다: AI 인터뷰, CV 평가, 스킬 테스트, 쇼케이스, 기술 테스트 또는 롤플레이, 직무 제목과 선택적 직무 설명, 이름, 프로젝트 및 언어(예: en 또는 vi-VN; 스킬 테스트와 기술 테스트는 언어를 무시합니다)로부터. 후보자를 스킬 테스트, 기술 테스트 또는 쇼케이스에 초대할 수 있도록 프로젝트에 연결하세요. 멱등 키는 위와 같이 선택 사항입니다. |
채용 공고 게시 (publish_job_post) |
Create hiring projects 필요. 채용 공고를 켜고 AI 콘텐츠 검사가 실행되었는지 확인합니다. 응답은 페이지가 현재 활성인지, 검사 대기 중인지, 또는 거부되었는지 알려줍니다. 채용 프로젝트가 활성이어야 합니다. |
채용 공고 게시 취소 (unpublish_job_post) |
Create hiring projects 필요. 채용 공고를 꺼서 공개 링크가 열리지 않게 합니다. 기본적으로 부스트도 꺼집니다 (withdraw_boost가 true). |
채용 공고 부스트 (boost_job_post) |
Create hiring projects 필요. 부스트를 off, flowmingo 또는 extended로 설정합니다. 부스트는 무료입니다. 올리려면 채용 공고가 켜져 있고, 프로젝트가 활성이며, 회사 로고와 설명, AI 콘텐츠 검사가 필요합니다. 회사는 하루 50개의 부스트를 올릴 수 있습니다. |
프로젝트 열기, 초안 또는 보관 (set_project_state) |
Create hiring projects 필요. 채용 프로젝트를 active, draft, archived 사이로 이동합니다. 초안 및 보관 처리 시 채용 링크가 닫힙니다. 지원자 데이터는 유지됩니다. |
예약된 초대 취소 (cancel_scheduled_invite) |
Invite candidates 필요. 나중에 예약되었지만 아직 전송되지 않은 초대를 취소합니다. 초대 결과의 초대 ID를 사용합니다. 누구에게도 이메일이 전송되지 않습니다. 후보자는 계정과 프로젝트 보드에 유지됩니다. |
채용 프로젝트 삭제 (delete_project) |
Create hiring projects (선택 사항) 필요. 요청만 합니다: 즉시 삭제하지 않고 링크에서 승인을 요청하며, 소유자 또는 관리자가 승인하기 전에는 아무것도 삭제되지 않습니다. 활성 프로젝트만 삭제할 수 있습니다. 사람이 승인하면 Flowmingo는 프로젝트와 채용 공고를 삭제합니다. 후보자 지원서는 하나씩 삭제되지 않으며, 후보자 프로필과 연락처, 평가 및 초대 링크는 유지됩니다. 되돌릴 수 없습니다. |
보안 및 신뢰
- 데이터는 조직 범위입니다 — 어시스턴트는 다른 회사의 데이터를 볼 수 없습니다.
- OAuth를 사용하면 어시스턴트는 API 키를 받지 않습니다. 1시간 후 만료되는 액세스 토큰을 받으며, 연결된 동안 자동으로 갱신됩니다. 로그인 자체는 리프레시 토큰이 유효한 동안 지속되며, 기본적으로 발급 또는 마지막 갱신 시점부터 약 30일이므로 약 30일 동안 사용하지 않으면 만료되고 다시 로그인합니다. 정적 헤더(옵션 B)를 사용하면 어시스턴트의 클라이언트가 키를 보유하고 모든 요청에 키를 보내므로, 공유하거나 커밋할 수 있는 파일에 키를 넣지 마세요.
- 어시스턴트 연결 차단: 설정 → 통합 → API 키에서 권한을 부여한 API 키를 삭제하세요. 액세스가 즉시 중지됩니다. 어시스턴트별 연결 해제 기능은 아직 없으므로 하나씩 취소하려면 각 어시스턴트에 고유한 키를 부여하세요.
/mcp엔드포인트에 대한 요청은 Origin을 확인합니다: 불투명한nullOrigin은 항상 거부되며, 확인은 허용 목록으로 잠글 수 있지만 기본적으로 모든 실제 Origin이 허용되므로 보호는 자격 증명이지 Origin이 아닙니다. 각 세션은 세션을 연 자격 증명에 바인딩됩니다.
인증 방법은 인증 — 두 가지 옵션을 참조하고, 정확한 읽기, 보호된 쓰기 및 즉시 실행되는 작업은 할 수 있는 작업을 참조하세요. 준비가 되면 어시스턴트 연결로 이동하여 클라이언트를 선택하세요.
MCP 서버 URL
어시스턴트 연결
Claude Code (CLI)
한 줄의 명령으로 네이티브 Streamable HTTP 위에 Flowmingo를 추가할 수 있습니다. OAuth를 우선 사용하고, 정적 --header는 대안입니다.
단계: 1) 서버 추가, 2) 로그인(브라우저 → 키 붙여넣기), 3) claude mcp list로 확인.
# 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
주의: 플래그는 이름 앞에 와야 하며, 항상 --transport http를 사용하세요(sse는 사용하지 마세요). fl_YOUR_KEY를 전체 키로 교체하세요(위 인증 섹션의 전체 키의 형태 참고).
작동 확인 — 이렇게 물어보세요: "내 진행 중인 채용 공고 목록을 보여줘."
Cursor
정적 헤더는 가장 간단한 방법입니다. Cursor는 OAuth도 지원합니다(동적 클라이언트 등록 지원) — 이 경우 headers 블록을 제거하세요.
단계: 1) 서버를 ~/.cursor/mcp.json에 추가하고(아래 참조), 2) 셸 프로필에 전체 키를 FLOWMINGO_API_KEY로 설정하고, 3) Cursor를 종료한 후 변수가 설정된 터미널에서 다시 시작하고, 4) 설정 → MCP에서 서버를 껐다 켜서 다시 로드하세요.
Cursor는 변수를 볼 수 있어야 합니다. Cursor는 자체 환경에서 ${env:FLOWMINGO_API_KEY}를 읽습니다. Dock이나 시작 메뉴에서 시작하면 터미널 프로필에 설정된 변수를 보지 못하는 경우가 많아서 헤더가 비어 있거나 확장되지 않은 채로 전달되고 서버는 Missing credential로 응답합니다. 터미널에서 Cursor를 시작하는 것이 실용적이지 않다면, 파일에서 ${env:FLOWMINGO_API_KEY}를 전체 키로 대체하세요(그리고 ~/.cursor/mcp.json을 git에 포함하지 마세요).
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
}
}
}
OAuth 대신 — headers 블록을 제거하세요; Cursor는 동적 클라이언트 등록을 실행하고 첫 연결 시 브라우저 동의 페이지를 엽니다:
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp"
}
}
}
작동 확인 — 물어보세요: "내 개설된 채용 공고를 나열해줘."
VS Code (Copilot, 에이전트 모드)
도구는 Copilot Chat → 에이전트 모드에서만 나타납니다. 루트 키는 servers ( mcpServers 아님)이며 유형은 http입니다. 아래 프롬프트 키 경로는 안정적인 설정입니다.
단계: 1) .vscode/mcp.json 생성 (또는 MCP: 서버 추가 → HTTP 실행), 2) 서버 시작 시 VS Code가 키를 묻습니다 (파일에 기록되지 않음), 3) 에이전트 모드에서 사용합니다.
{
"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는 OAuth도 시도할 수 있지만, 문서화된 OAuth 구성은 클라이언트 ID를 예상합니다. 안정적인 설정을 위해서는 위의 프롬프트 키 경로를 사용하세요.
작동하는지 확인하세요 — 질문: "내 열린 채용 공고 목록을 보여줘."
Claude — claude.ai 및 Claude 데스크톱
둘 다 동일한 커넥터 UI와 동일한 URL 붙여넣기 흐름을 사용합니다. OAuth 전용 (UI에 헤더 필드가 없습니다).
단계 (웹 또는 데스크톱):
- 설정 → 커넥터를 열고 사용자 지정 커넥터 추가를 클릭합니다.
- 이름을
Flowmingo로 지정하고 위의 MCP 서버 URL을 붙여넣습니다. 고급 → OAuth 클라이언트 ID / 비밀번호는 비워 둡니다. - 추가 → 연결을 클릭합니다. Flowmingo 동의 페이지에서
fl_API 키를 붙여넣고 승인합니다. - 확인 — Claude에게 질문합니다: "내 열린 채용 공고 목록을 보여줘."
Remote MCP server URL: https://mcp.flowmingo.ai/mcp
Advanced → OAuth Client ID / Secret: (leave blank — Flowmingo uses Dynamic Client Registration)
팀 / 기업: 소유자가 조직 설정 → 커넥터 → 사용자 지정에서 한 번 추가합니다. 멤버는 연결을 클릭합니다.
대신 Claude 데스크톱에 정적 키가 필요한가요? 모든 클라이언트 (mcp-remote) 탭을 사용하세요.
처음 연결 시 브라우저에서 Flowmingo 동의 페이지가 열립니다. API 키를 붙여넣고 승인하세요. 나중에 연결을 해제하려면 설정 → 통합 → API 키에서 해당 API 키를 삭제하세요.
ChatGPT & OpenAI Codex CLI
둘 다 OpenAI입니다. ChatGPT는 사용자 지정 커넥터에 Developer Mode를 사용합니다(OAuth 전용). Codex는 CLI에서 기본적으로 연결됩니다.
ChatGPT (웹)
- chatgpt.com에서 (Plus / Pro / Business / Enterprise / Edu — 모바일 아님), Settings → Apps → Advanced를 열고 Developer mode를 켭니다.
- Apps → Create → 이름을
Flowmingo로 지정하고, 아래 URL을 붙여넣고, 전송 방식은 Streamable HTTP, 인증은 OAuth를 선택합니다. - 초안을 열고, 도구를 켜고, Refresh를 클릭합니다.
- 채팅에서 + 메뉴를 통해 첨부합니다.
Connector URL: https://mcp.flowmingo.ai/mcp
Transport: Streamable HTTP
Auth: OAuth (leave any static OAuth client ID / secret blank — Flowmingo uses Dynamic Client Registration)
ChatGPT의 Developer Mode는 OAuth 전용으로 연결됩니다 — 정적 x-api-key / 사용자 지정 API 키 헤더를 허용하지 않습니다. 일반 및 심층 리서치 커넥터는 search와 fetch만 사용합니다(둘 다 보유). 쓰기 도구(초대 / 이동 / 거절)는 Developer Mode가 필요합니다. ChatGPT가 도구를 실행하기 전에 표시하는 프롬프트는 ChatGPT의 자체 프롬프트이며 Flowmingo의 승인이 아닙니다: 초대, 거절, 그리고 후보자에게 이메일을 보내는 단계로의 이동은 항상 Flowmingo 링크에서 사람의 승인을 기다립니다.
OpenAI Codex CLI
브리지가 필요 없습니다 — Codex는 Streamable HTTP를 기본적으로 지원합니다.
# ~/.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
작동 확인 — 물어보세요: "내 개설 채용 공고 목록을 보여줘."
Gemini CLI 및 Code Assist
Gemini CLI (및 Gemini Code Assist 에이전트 모드)는 ~/.gemini/settings.json을 통해 원격 MCP 서버에 액세스합니다. 소비자 Gemini 앱은 사용자 지정 MCP 커넥터를 추가할 수 없습니다 — 이 경로는 CLI / Code Assist 전용입니다.
단계: 1) ~/.gemini/settings.json의 mcpServers 아래에 서버 추가, 2) FLOWMINGO_API_KEY=fl_... 내보내기, 3) gemini를 실행하고 /mcp를 입력하여 도구가 나열되는지 확인합니다.
{
"mcpServers": {
"flowmingo": {
"httpUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${FLOWMINGO_API_KEY}" },
"timeout": 30000
}
}
}
httpUrl은 네이티브 스트리밍 HTTP를 선택합니다. ${FLOWMINGO_API_KEY} 플레이스홀더는 환경 변수에서 확장되므로 파일에 원시 키가 기록되지 않습니다. OAuth를 선호하시나요? Gemini CLI는 이를 네이티브로 지원합니다 — headers 블록을 생략하고 서버 항목에 "authProviderType": "dynamic_discovery"를 추가하세요. CLI는 401 챌린지를 감지하고, OAuth 메타데이터를 검색하며, 자체적으로 동적 클라이언트 등록을 수행합니다 (설정할 클라이언트 ID 없음).
작동하는지 확인하세요 —
gemini에서 질문: "내 열린 채용 공고 목록을 보여줘."
기타 클라이언트 — Windsurf · Zed · Cline · Continue · Antigravity
아래 각 클라이언트는 동일한 서버와 작동합니다. 대부분 OAuth와 정적 헤더를 모두 지원합니다. 코드 조각은 환경 변수를 통한 정적 키를 사용합니다. headers를 제거하면 지원되는 클라이언트에서 OAuth를 실행할 수 있습니다. 아래에서 언급된 클라이언트별 키 이름 함정에 주의하세요.
Google Antigravity
https://mcp.flowmingo.ai/mcp을 원격 MCP 서버로 추가하고 인증을 선택하세요. Flowmingo 페이지가 열리고 전체 API 키를 요청합니다(위의 Authentication 섹션에서 전체 키 모양 참조). 각 Antigravity 화면(IDE, CLI)은 별도로 로그인합니다. Antigravity의 mcp_config.json에서 주소는 serverUrl에 입력하고, 정적 키는 headers 블록에 Authorization로, Bearer 및 전체 키와 함께 넣습니다. Google의 Antigravity MCP 예제처럼 말이죠. 모든 Antigravity 버전을 테스트할 수는 없었으므로 메뉴가 이와 다르면 Google 가이드에 최신 단계가 있습니다.
Windsurf (Cascade)
~/.codeium/windsurf/mcp_config.json — Windsurf은 serverUrl 또는 url을 허용하며 OAuth를 지원합니다(트리거하려면 headers 생략).
{ "mcpServers": { "flowmingo": {
"serverUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Zed
~/.config/zed/settings.json — 키는 context_servers 입니다. 네이티브 OAuth는 headers을 생략하세요. 환경에 FLOWMINGO_API_KEY=fl_...을 설정하여 원시 키를 붙여넣지 마세요.
{ "context_servers": { "flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Cline
MCP 서버 → 구성 — type: "streamableHttp" (카멜표기)로 설정하거나, 그렇지 않으면 죽은 SSE로 기본 설정됩니다.
{ "mcpServers": { "flowmingo": {
"type": "streamableHttp",
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" },
"disabled": false, "autoApprove": []
} } }
Continue.dev
~/.continue/config.yaml — mcp-remote 브리지를 통해 연결하세요. 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 }}"]
작동 확인 — 이렇게 물어보세요: "내 진행 중인 채용 공고 목록을 보여줘."
모든 클라이언트 (mcp-remote)
stdio 전용 클라이언트(또는 기본 원격 전송이 없는 향후 클라이언트)의 경우 mcp-remote stdio 명령으로 Flowmingo에 브리지하세요. --transport http-only가 필요합니다 — 서버에는 SSE가 없습니다.
단계: 1) Node ≥ 18 확인, 2) 클라이언트에서 stdio 명령으로 브리지를 실행, 3) 첫 OAuth 실행 시 브라우저가 열리면 키를 붙여넣으세요.
# 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" }
}
}
}
복구: 인증이 멈추면 rm -rf ~/.mcp-auth를 실행하고 다시 시도하세요. fl_YOUR_KEY를 전체 키로 교체하세요(위 인증 섹션의 전체 키 모양 참조). JSON args[]에서 헤더 콜론 뒤에 공백을 넣지 마세요(npx 이스케이프 문제).
작동 확인 — 물어보세요: "내 진행 중인 채용 공고를 나열해 줘."