호스팅된 MCP 서버
1분이면 설정 완료
- 계정 설정에서 API 토큰을 복사해.
- 아래에서 사용하는 도구를 고르고 스니펫을 붙여넣은 다음, 토큰 자리표시자를 네 토큰으로 바꿔.
- AI 도구를 재시작하고 “이탈리아에서 Andrea라는 이름은 어떤 성별일 가능성이 높아?” 같은 걸 물어봐
터미널에서 이 명령 하나만 실행하면 돼 — 설정은 이걸로 끝이야.
claude mcp add --transport http --header "Authorization: Bearer YOUR_API_TOKEN" gender-api https://mcp.gender-api.com
현재 프로젝트만이 아니라 모든 프로젝트에서 Gender-API를 쓰려면 --scope user를 붙여.
Claude Desktop은 자동으로 다운로드되는 작은 npm 브리지를 통해 연결돼. 이걸 설정 파일에 추가해 — 직접 설치할 건 없어.
{
"mcpServers": {
"gender-api": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.gender-api.com",
"--header",
"Authorization:Bearer YOUR_API_TOKEN"
]
}
}
}
설정 파일 위치:
-
macOS
~/Library/Application Support/Claude/claude_desktop_config.json -
Windows
%APPDATA%\Claude\claude_desktop_config.json
Authorization:Bearer는 콜론 뒤에 공백 없이 써 — 브리지가 그 형태를 기대해.
모든 프로젝트에 적용하려면 ~/.cursor/mcp.json에, 특정 프로젝트에만 적용하려면 .cursor/mcp.json에 추가해.
{
"mcpServers": {
"gender-api": {
"url": "https://mcp.gender-api.com",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
프로젝트의 .vscode/mcp.json에 추가하거나, 어디서든 쓰려면 사용자 수준의 mcp.json에 추가해.
{
"servers": {
"gender-api": {
"type": "http",
"url": "https://mcp.gender-api.com",
"requestInit": {
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
}
VS Code는 mcpServers 대신 servers를 쓰고, 헤더는 requestInit 안에 넣어야 해. 같은 구조가 Visual Studio와 JetBrains IDE에서도 동작해.
원격 MCP를 지원하는 클라이언트라면 이 세 가지 값만 있으면 돼:
Endpoint: https://mcp.gender-api.com Transport: streamable-http Header: Authorization: Bearer YOUR_API_TOKEN
클라이언트가 로컬 MCP 서버만 지원한다면 Claude Desktop 탭에 있는 npx mcp-remote 브리지를 써 — stdio만 쓰는 클라이언트에서도 동작해.
AI 도구 내에서 Gender-API 직접 사용하기
당사의 MCP 서버를 사용하면 MCP 호환 AI 도구가 Gender-API를 직접 호출할 수 있습니다. 즉, 어시스턴트가 프롬프트 기반 지침 대신 구조화된 도구 호출을 통해 이름, 전체 이름, 이메일 유도 이름 및 출신 국가 데이터를 강화할 수 있음을 의미합니다.
설치할 것도, 호스팅할 것도 없어. 도구를 https://mcp.gender-api.com로 향하게 하고, API에서 이미 쓰고 있는 Gender-API 토큰으로 인증하면 돼.
고객이 활용할 수 있는 기능
- 실시간 Gender-API 데이터 사용: 귀하의 AI 도구는 요청 형식이나 응답을 임의로 생성하는 대신 실시간 Gender-API 결과를 쿼리할 수 있습니다.
- 기존 토큰 재사용: MCP 서버는 이미 API에서 사용 중인 것과 동일한 Gender-API bearer 토큰으로 작동합니다.
- MCP 호환 클라이언트 연결: Claude, Cursor 또는 호스팅된 MCP URL을 지원하는 귀하의 자체 MCP 호환 내부 도구 및 에이전트에서 사용할 수 있습니다.
- 간편한 결제 관리: 기존의 Gender-API 크레딧 사용 방식이 그대로 적용되므로, 새로운 결제 시스템을 배울 필요가 없습니다.
지원되는 도구
포함된 MCP 도구
- query_first_name – 이름을 통한 예상 성별 조회.
- query_full_name – 전체 이름을 통한 예상 성별 조회.
- query_email – 이메일 주소에서 이름을 추출하고 정보를 보강합니다.
- get_country_of_origin – 예상 출신 국가 확인.
- get_statistics – 남은 크레딧 및 계정 통계 확인.
호스팅된 전송
호스팅되는 Streamable HTTP 엔드포인트 https://mcp.gender-api.com를 사용하고, 기존 Gender-API 베어러 토큰으로 인증해.
실제 MCP 사용 사례
AI 코파일럿 내 리드 정보 보강
Claude, Cursor 또는 내부 영업 에이전트가 리드 목록을 검토하고, MCP를 통해 Gender-API를 호출하여, 고객에게 연락하기 전에 예상 이름, 성별 및 출신 국가 맥락을 추가하도록 하세요.
CRM 및 고객 지원 개인화
고객 지원 어시스턴트는 수신된 이메일 주소를 검사하고, `query_email`을 통해 유력한 이름을 추출하며, 상담사가 더 자연스럽고 개인화된 답장 초안을 작성할 수 있도록 지원합니다.
스프레드시트 정리 및 리서치 에이전트
MCP가 활성화된 데이터 정리 에이전트는 CSV 파일이나 스프레드시트를 검토하고, 이름 열을 표준화하며, 모든 워크플로우에 별도의 API 코드를 작성하지 않고도 Gender-API 결과를 사용하여 행 데이터를 보강할 수 있습니다.
마케팅 자동화 및 세분화
캠페인 구축 어시스턴트에서 MCP를 사용하여 인사말을 생성하고, 연락처 데이터를 보강하며, 개인화 워크플로우를 시작하기 전에 남은 크레딧을 확인하세요.
직접 MCP 클라이언트를 만들고 있어?
공식 MCP SDK로 연결하기
이미 만들어진 도구 대신 직접 에이전트를 작성한다면 Streamable HTTP 트랜스포트를 바로 연결해:
import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
const transport = new StreamableHTTPClientTransport(new URL('https://mcp.gender-api.com'), {
requestInit: {
headers: {
Authorization: 'Bearer YOUR_API_TOKEN',
},
},
});
자주 묻는 질문
이 기능은 제 일반 Gender-API 크레딧을 사용하나요?
네. MCP 서버는 기존 Gender-API 엔드포인트 상단의 얇은 통합 계층이므로, 일반 토큰 권한 및 크레딧 사용 방식이 그대로 적용됩니다.
제가 개인 내부 MCP 도구에서 사용할 수 있나요?
응. 도구가 호스팅형 MCP를 지원하면 https://mcp.gender-api.com에 연결하고 Gender-API 베어러 토큰을 보내면 돼.
뭔가 설치해야 해?
아니. MCP 서버는 우리가 호스팅하니까 내려받거나 계속 띄워둘 게 없어. 로컬 MCP 서버만 지원하는 클라이언트는 npx mcp-remote 브리지를 쓰는데, 처음 실행할 때 알아서 다운로드돼.
AI 도구에 Gender-API 도구가 안 보여. 어떻게 해?
설정을 수정한 뒤 도구를 재시작하고, 토큰 자리표시자를 실제 API 토큰으로 바꿨는지 다시 확인해. 연결이 거부되면 토큰이 유효하지 않거나 크레딧이 없는 거야 — 둘 다 인증 오류로 나타나.
궁금한 점이 있니?
