MODEL CONTEXT PROTOCOL

由 AI 智能体直接调用的
MCP 服务器。

只需在 Claude Desktop · Claude Code · 其他 MCP 兼容客户端中登记单个端点，Hiplay OpenAPI 的全部 14 种工具就会自动暴露。

MCP 服务器端点

https://api.hiplay.kr/mcp

Transport: HTTP (JSON-RPC 2.0)Protocol: 2024-11-05Auth: Bearer14 tools

快速开始 (3 步)

1. 签发 API Key

在控制台的 API Keys 页面签发新密钥。签发的密钥(oai_...)仅显示一次。

2. 在 MCP 客户端中登记

参考下方各客户端指南，登记端点和密钥。

3. 立即调用

AI 智能体会自动识别工具列表，并在需要时直接调用工具。

各客户端设置

Claude Code (CLI)

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 服务器界面中输入以上信息。

暴露的工具 (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"}}
  }'

立即登记吧

注册后签发密钥 → 登记 MCP 客户端 → AI 智能体即可使用全部 14 种工具。

签发 API Key 查看完整文档

由 AI 智能体直接调用的MCP 服务器。