Claude
Claude Code 워크플로
조사, OSINT, 콘텐츠 모더레이션에 Claude Code를 사용하는 엔지니어는 MCP 서버를 설정에 추가하기만 하면 Claude가 대화형으로 검색을 진행하도록 할 수 있습니다.
FaceSearch MCP Server
AI 에이전트를 위한 네이티브 얼굴 검색
호스팅형 Model Context Protocol 서버가 Claude, Cursor, 그 외 MCP 호환 클라이언트에 타입이 지정된 얼굴 검색 도구 5가지를 제공합니다. Bearer 토큰 하나, 인프라는 제로.
수천 건의 검색
전 세계에서 이용 가능
256비트 암호화
높은 일치 정확도
호스팅형 Model Context Protocol 서버가 Claude, Cursor, 그 외 MCP 호환 클라이언트에 타입이 지정된 얼굴 검색 도구 5가지를 제공합니다. Bearer 토큰 하나, 인프라는 제로.
- 무엇으로 검색하나
- 얼굴이 담긴 사진 한 장. 텍스트 키워드 검색은 지원하지 않습니다.
- 무엇을 받게 되나
- 같은 얼굴이 등장하는 페이지를 순위대로 정리한 목록. 각 결과에 신뢰도 점수와 출처 링크가 붙습니다.
- 일치는 어떻게 판정되나
- 얼굴 인식입니다. 얼굴은 임베딩(숫자의 나열)으로 변환된 뒤 파일명이나 설명, 픽셀이 아니라 거리로 비교됩니다. 얼굴 인식은 어떻게 작동하나요?
- 검색 1회 비용
- 3 크레딧. 신규 계정은 무료 크레딧 3개로 시작하며 카드 등록이 필요 없습니다.
- 사진 보관 기간
- 검색이 끝난 뒤 24시간 이내에 업로드한 사진을 삭제합니다.
MCP 서버 동작 원리
MCP 클라이언트 설정에 한 번만 등록하면, 이후에는 필요할 때 에이전트에게 얼굴 검색을 맡길 수 있습니다.
API 키 발급
대시보드에 로그인해 search:read와 search:write 권한을 가진 키를 만들고 평문을 복사하세요. 동일한 키가 REST와 MCP 모두에서 동작합니다.
서버 등록
클라이언트 설정 파일에 MCP 서버 블록을 붙여 넣고 클라이언트를 다시 시작하세요. submit_face_search, get_search_status, list_searches, delete_search, get_credits 다섯 개의 도구가 자동으로 나타납니다.
에이전트에게 맡기기
에이전트에게 “이 사진이 온라인 어디에 있는지 찾아 줘”라고 말하면 나머지는 에이전트가 처리합니다. 제출, 폴링, 결과 제시, 낮은 신뢰도 결과 플래그, 안전하지 않은 요청의 거부까지.
MCP 서버 기능
최신 MCP 스펙을 기준으로 만들어졌고, AI 에이전트가 실제로 필요로 하는 가드레일을 갖췄습니다.
다섯 개의 타입 기반 도구
submit_face_search, get_search_status, list_searches, delete_search, get_credits ， 각 도구는 zod 입력 스키마, 명확한 설명, 그리고 Claude가 사용자에게 설명할 수 있도록 매핑된 오류를 갖추고 있습니다.
Bearer 토큰 인증
REST API와 동일한 API 키를 사용합니다. 키 하나로 두 면을 모두 사용할 수 있고, 해지는 한 번의 요청 안에 두 면으로 모두 전파되어 잃어버린 키는 대시보드에서 한 번만 해지하면 됩니다.
SSRF 방지 URL 입력
도구 호출에 imageUrl이 포함되면 서버는 호스트명을 해석하고, 사설 CIDR 대역을 거부하며, HTTP를 금지해 HTTPS만 허용하고, 리다이렉트를 비활성화한 뒤 10초 타임아웃과 10 MB 본문 상한을 적용합니다.
MCP 계층 멱등성
서버는 각 MCP 호출의 requestId에서 클라이언트 멱등 키를 파생합니다. 트랜스포트 수준의 재시도는 자동으로 중복이 제거되므로, 에이전트가 도구 호출을 재실행해도 크레딧이 중복 차감되지 않고 동일한 jobId를 얻습니다.
공유 레이트 리밋
MCP 도구 호출은 REST와 동일한 레이트 리밋 버킷을 공유합니다. 유출된 키로 두 면을 각각 가득 채울 수 없도록 상한이 공유되며, Redis 속도로 적용됩니다.
구조화된 도구 오류
프로토콜 오류를 그대로 던지는 대신, 실패 시마다 CallToolResult가 반환됩니다. isError: true, 사람이 읽을 수 있는 텍스트 블록(Claude가 사용자에게 설명할 수 있도록), 그리고 프로그래밍 방식 클라이언트를 위한 structuredContent 페이로드가 함께 전달됩니다.
MCP 서버가 빛나는 순간
AI 에이전트가 더 큰 워크플로의 일부로 얼굴 검색을 수행해야 할 때.
IDE
Cursor와 IDE 에이전트
Cursor 계열의 IDE 에이전트는 더 긴 파이프라인의 일부로 얼굴 검색을 넣을 수 있습니다. 페이지 스크래핑, 얼굴 추출, FaceSearch 호출, 결과 주석 달기까지 한 번의 실행으로.
커스텀
커스텀 MCP 호스트
MCP를 지원하는 호스트라면 어디든 연결할 수 있습니다. 음성 비서, Discord 봇, 자체 에이전트 프레임워크를 구축하고, 동일한 Bearer 인증 HTTP 엔드포인트로 FaceSearch를 붙이세요.
수천 명에게 신뢰받는
10MB
최대 업로드 크기
JPEG, PNG, WebP 이미지
24시간
이미지 보관 기간
업로드 이미지 자동 삭제
연중무휴
검색 가능 시간
언제든지 검색
3
검색당 크레딧
단순하고 투명한 가격
AI 빌더들의 이야기
FaceSearch를 에이전트 워크플로에 연결한 팀들의 피드백.
“MCP와 REST가 Bearer 인증을 공유하는 점이 결정적인 이유였습니다. 개발 중에는 curl로 테스트하고, 동일한 키로 Claude Code로 옮겨 가도 다시 연결할 필요가 없습니다.”
“imageUrl의 SSRF 방지 덕분에 둘째 날의 어리석은 실수로부터 살아남았습니다. 실수로 리다이렉트 URL을 넘겼는데, 내부 메타데이터 서비스에 닿기 전에 서버가 깔끔하게 거부해 주었습니다.”
“구조화된 오류 페이로드 덕분에 Claude가 분석가에게 레이트 리밋을 제대로 설명해 줄 수 있습니다. 예전에는 불투명한 프로토콜 오류뿐이었지만, 지금은 실행 가능한 정보와 함께 평범한 한국어로 설명해 줍니다.”
간단하고 투명한 가격
귀하의 요구에 맞는 플랜을 선택하세요. 숨겨진 수수료 없으며 언제든 취소 가능합니다.
가장 인기
PRO
$29/월
전문가 및 고급 사용자용
- 월 60 크레딧 (크레딧당 $0.48)
- 얼굴 검색
- 검색 기록
- 프로필을 PDF로 내보낼 수 있음
또는 크레딧 팩 구매
사용량 기반 결제
Starter
3크레딧
$6
$2.00/크레딧
20% 절약
Basic
30크레딧
$24
$0.80/크레딧
31% 절약
Standard
100크레딧
$69
$0.69/크레딧
34% 절약
Pro
300크레딧
$199
$0.66/크레딧
40% 절약
Enterprise
1000크레딧
$599
$0.60/크레딧
MCP Server FAQ
에이전트 빌더가 서버를 프로덕션에 올리기 전에 묻는 것들.
