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_...)は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"}}
  }'

今すぐ登録しましょう

会員登録後キー発行 → MCPクライアント登録 → AIエージェントがすぐ14種類のツールを利用。

API Key発行全ドキュメントを見る

AIエージェントが直接呼び出すMCPサーバー。