AI 에이전트가 직접 호출하는
MCP 서버.
Claude Desktop · Claude Code · 기타 MCP 호환 클라이언트에 단일 엔드포인트만 등록하면 Hiplay OpenAPI 14종 도구 전체가 자동으로 노출됩니다.
https://api.hiplay.kr/mcp시작하기 (3단계)
1. API Key 발급
콘솔의 API Keys 페이지에서 새 키를 발급받습니다. 발급된 시크릿(oai_...)은 1회만 노출됩니다.
2. MCP 클라이언트에 등록
아래 클라이언트별 가이드를 참고하여 엔드포인트와 키를 등록합니다.
3. 즉시 호출
AI 에이전트가 자동으로 도구 목록을 인식하고, 필요할 때 직접 도구를 호출합니다.
클라이언트별 설정
Claude Code (CLI)
터미널에서 한 줄로 등록:
claude mcp add hiplay-openapi --transport http \ https://api.hiplay.kr/mcp \ --header "Authorization: Bearer oai_xxxxxxxxxxxxx..."
Claude Desktop
~/.claude/claude_desktop_config.json (Windows: %APPDATA%\Claude\claude_desktop_config.json) 에 추가:
{
"mcpServers": {
"hiplay-openapi": {
"url": "https://api.hiplay.kr/mcp",
"headers": {
"Authorization": "Bearer oai_xxxxxxxxxxxxx..."
}
}
}
}설정 후 Claude Desktop 재시작 필요.
기타 MCP 클라이언트 (Cursor, OpenAI Codex 등)
대부분의 MCP 클라이언트는 동일한 패턴(URL + Authorization 헤더)을 지원합니다. 각 클라이언트의 MCP 서버 추가 UI 에 위 정보를 입력하세요.
노출되는 도구 (14종)
reverseen2koko2enhangulifygrammarkorcenrandom_numbershorten_urlcaptchacaptcha_verifyqr_codeillustweathergithub_userlyrics보안 / 운영 정책
키 분리 권장
MCP 용도로 별도 키를 발급하고, 노출 시 즉시 폐기 가능하도록 IP 화이트리스트를 함께 설정하세요.
동일 한도 적용
MCP 호출도 일반 REST 와 동일한 분/일/월 카운터에 합산됩니다. 사용량은 콘솔에서 실시간 확인 가능.
호출 로그 통합
MCP 도구 호출도 콘솔 로그에 표시되며, 엔드포인트는 v1 경로로 동일하게 기록됩니다.
점검 모드 자동 적용
관리자가 특정 엔드포인트를 점검 모드로 전환하면 MCP 호출도 동일하게 503 응답합니다.
JSON-RPC 직접 호출 (디버깅용)
MCP 클라이언트 없이 cURL 로 직접 검증할 수 있습니다.
# 도구 목록 조회 (인증 불필요)
curl -X POST https://api.hiplay.kr/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
# 도구 호출 (Bearer 필요)
curl -X POST https://api.hiplay.kr/mcp \
-H "Content-Type: application/json" \
-H "Authorization: Bearer oai_xxxxxxxx..." \
-d '{
"jsonrpc":"2.0","id":2,"method":"tools/call",
"params":{"name":"reverse","arguments":{"text":"hello"}}
}'