Hooklayer MCP

AI 에이전트를 위한 바이럴 콘텐츠 인텔리전스. Hooklayer MCP 서버를 Claude Desktop, Cursor, n8n 또는 모든 HTTP MCP 클라이언트에 연결하면 에이전트가 TikTok, Instagram, YouTube의 숏폼 콘텐츠를 위한 12가지 도구를 사용할 수 있습니다: 크리에이터 분석, 키워드 동영상 검색, 바이럴 템플릿 및 떠오르는 트렌드 발견, 훅 점수 산정 및 재작성, 바이럴 동영상 리믹스, 크리에이터 음성 매칭, 초안의 바이럴 가능성 예측, 브랜드 브리프를 촬영 준비 완료된 크리에이티브 청사진으로 전환, 그리고 저장된 워치와 과거 스냅샷을 통한 크리에이터 장기 모니터링까지 지원합니다.

12 tools · structured JSON · non-destructive creator monitoring · no external social-platform edits or deletes

v1.1.0 (2026-05-14): 근거 계층(evidence layer)이 출시되었습니다. 모든 점수에는 인용된 근거가 포함된 signals[], would_fail_because 반사실(counterfactual), 그리고 quality 상태 필드가 포함됩니다. predict_virality는 독립적인 적대적 검증(adversarial check)을 실행합니다. analyze_account.recommended_chain 단계는 이제 confidence, cost, action_class(권위 분류 체계), expected_output을 노출합니다. 전체 출시 내용은 CHANGELOG.md를 참조하세요.

🚀 빠른 설치

Claude Desktop

Claude Desktop은 원격 HTTP MCP 서버를 기본 지원하지 않으므로 mcp-remote 브리지가 필요합니다. 두 가지 설치 방법이 있습니다:

옵션 1 — 사용자 지정 커넥터 (가장 쉬움, 설정 파일 편집 불필요)

Claude 웹/데스크톱 UI에서: 설정 → 커넥터 → 사용자 지정 커넥터 추가 → 이 URL 붙여넣기:

https://hooklayer.dev/api/mcp

Claude.ai가 OAuth 과정을 안내합니다 (수동 키 입력 불필요). 완료입니다.

옵션 2 — 직접 설정 (power user를 위한 hl_live_ 키 인증 방식)

claude_desktop_config.json을 편집하세요:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "hooklayer": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@0.1.38",
        "https://hooklayer.dev/api/mcp",
        "--header",
        "Authorization:Bearer hl_live_..."
      ]
    }
  }
}

무료 hl_live_ 키는 https://hooklayer.dev/auth/signup 에서 받으세요 — 평생 크레딧 100개, 카드 불필요.

Claude Desktop을 다시 시작하세요. 12개의 Hooklayer 도구가 🔌 커넥터 목록에 나타납니다.

Cursor

~/.cursor/mcp.json:

{
  "mcpServers": {
    "hooklayer": {
      "url": "https://hooklayer.dev/api/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer hl_live_..."
      }
    }
  }
}

n8n

워크플로우에서 MCP Client 노드를 추가하고 원격 HTTP MCP 서버로 구성하세요:

• URL: https://hooklayer.dev/api/mcp

• 전송 방식: HTTP

• 헤더: Authorization: Bearer hl_live_...

12개 도구 모두 노드의 "Tool" 드롭다운에 나타납니다.

OAuth 2.1 + PKCE (Claude.ai 커넥터 및 사용자 지정 앱용)

Hooklayer는 완전한 OAuth 2.1 호환 — 디스커버리, Dynamic Client Registration, PKCE, 리프레시 토큰 로테이션을 지원합니다. API 키보다 OAuth를 선호하는 MCP 클라이언트는 별도 설정 없이 바로 작동합니다.

디스커버리 엔드포인트 (인증 불필요, 기계 판독 가능):

# Authorization server metadata (RFC 8414)
curl https://hooklayer.dev/.well-known/oauth-authorization-server

# Protected resource metadata (RFC 9728)
curl https://hooklayer.dev/.well-known/oauth-protected-resource

Dynamic Client Registration (수동 가입 양식 없이 클라이언트 생성):

curl -X POST https://hooklayer.dev/oauth/register \
  -H "Content-Type: application/json" \
  -d '{
    "client_name": "Your MCP client",
    "redirect_uris": ["https://yourapp.com/oauth/callback"]
  }'
# Returns: client_id, client_secret (for confidential clients)

인증 없이 tools/call을 호출하면 401과 함께 리소스 메타데이터를 가리키는 WWW-Authenticate 헤더가 반환됩니다 — Claude.ai, Cursor 및 기타 MCP 클라이언트는 이를 사용하여 OAuth 흐름을 자동으로 발견합니다.

기타 클라이언트

모든 HTTP MCP 클라이언트. 프로토콜은 2024-11-05(최대 호환성) 또는 2025-06-18(Streamable HTTP + structuredContent)을 협상합니다.

# Quick test — initialize handshake works without auth:
curl -X POST https://hooklayer.dev/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize"}'

Related MCP server: 自媒体文案助手 MCP Server

🧠 12가지 도구

전체 스키마 + curl 예시: https://hooklayer.dev/docs

💡 추천 후속 조치

analyze_account는 recommended_chain 필드를 반환합니다: 관련 도구, 예시 파라미터, 각 도구가 다음에 유용할 수 있는 이유를 나열한 일반 데이터입니다. 이는 참고용일 뿐이며 — 에이전트와 사용자가 실행 여부를 결정합니다:

{
  "viral_dna_score": 87,
  "steal_map": [...],
  "recommended_chain": [
    {
      "tool": "match_voice",
      "params": {
        "draft": "<<<USER_DRAFT>>>",
        "reference_samples": ["https://tiktok.com/...", "...", "..."]
      },
      "reason": "High-signal voice DNA — consistent across top 5 videos"
    },
    {
      "tool": "trend_pulse",
      "params": { "niche": "challenge_videos" },
      "reason": "Verify their formula maps to current trends"
    },
    {
      "tool": "viral_remix",
      "params": { "source_url": "https://tiktok.com/..." },
      "reason": "Their #2 video has the highest copyable structure"
    }
  ]
}

이 항목들은 지침이 아닌 정보성 데이터입니다. 각 도구는 여전히 명시적 호출이 필요하며 — 에이전트/사용자 동의 없이 자동으로 실행되는 것은 없습니다.

📦 예시

• examples/typescript-example.ts — MCP SDK를 통한 TypeScript 사용법

• examples/python-example.py — anthropic-mcp 클라이언트를 통한 Python 사용법

• examples/curl-test.sh — 모든 엔드포인트에 대한 원시 curl 테스트

💵 가격

• 무료 — 가입 시 평생 크레딧 100개, 카드 불필요

• Starter — 월 $49, 크레딧 5,000개, 분당 60회 요청

• Pro — 월 $149, 크레딧 25,000개, 분당 300회 요청, 브랜드 음성 메모리

• Agency — 월 $499, 크레딧 150,000개, 분당 1,000회 요청, 화이트라벨, 10석

• 종량제 — $25에 크레딧 5,000개, 만료 없음

전체 가격: https://hooklayer.dev/pricing

🛠 아키텍처

호스팅형 MCP 서버 (stdio 설치 불필요):

Your agent (Claude/Cursor/n8n)
        │
        │  JSON-RPC 2.0 over HTTP
        ▼
https://hooklayer.dev/api/mcp
        │
        ├── initialize / ping / tools/list  (no auth)
        └── tools/call                       (Bearer hl_live_*)
                │
                └── Routes internally to /v1/* REST endpoints
                    100K+ analyzed viral videos
                    ScrapeCreators + Whisper + Sonnet pipeline

호스팅 서버의 소스 코드는 hooklayer.dev에 있습니다 (비공개 소스 — 분석 파이프라인이 핵심 경쟁력). 이 저장소에는 공개 클라이언트 문서, 예시, 설정 스니펫이 포함되어 있습니다.

📚 링크

• 설치 페이지: https://hooklayer.dev/mcp

• 전체 문서: https://hooklayer.dev/docs

• 플레이그라운드 (가입 불필요): https://hooklayer.dev/playground

• 가격: https://hooklayer.dev/pricing

• OAuth 메타데이터: /.well-known/oauth-authorization-server

• 이슈 + 버그 신고: GitHub Issues

🔒 보안

Hooklayer는 12개 도구 모두에 명시적 MCP 안전 주석을 사용합니다. 대부분의 도구는 Hooklayer 크레딧을 차감하고 서비스 사용을 기록할 수 있는 리서치 및 분석 도구입니다. list_watches는 읽기 전용입니다. 크리에이터 모니터링은 비파괴적 영속성을 추가합니다: watch_account는 크리에이터 워치와 기준 스냅샷을 저장하고, get_changes는 변경 사항을 확인하면서 과거 스냅샷을 저장합니다. 모든 도구는 destructiveHint: false로 표시되어 있습니다. Hooklayer에는 사용자 데이터를 삭제하거나 외부 소셜 플랫폼의 데이터를 편집/삭제하는 MCP 도구가 없습니다.

인증: tools/call은 Bearer 토큰(hl_live_* API 키 또는 OAuth 2.1 액세스 토큰)이 필요합니다. 공개 메서드(initialize, ping, tools/list)는 인증 없이 작동하므로 MCP 클라이언트가 인증 전에 핸드셰이크와 도구 발견을 할 수 있습니다.

recommended_chain은 참고용입니다. analyze_account 응답에는 사전 채워진 파라미터가 포함된 추천 후속 도구가 포함됩니다. 이는 데이터일 뿐이며 — 에이전트와 사용자가 실행 여부를 결정합니다. 어떤 도구 호출도 서버 측에서 추가 도구 호출을 트리거하지 않습니다.

데이터 처리: Hooklayer는 전송한 입력(핸들, 훅, 스크립트, URL)을 처리하여 분석 결과를 반환합니다. 크리에이터 모니터링은 사용자가 시간 경과에 따른 변경 사항을 비교할 수 있도록 저장된 워치 메타데이터와 과거 스냅샷을 저장합니다. Hooklayer는 또한 인증, 결제, 크레딧 및 운영 텔레메트리에 필요한 서비스 사용 기록을 저장합니다.

보안 이슈 신고: GitHub Issues 또는 이메일 security@hooklayer.dev.

📄 라이선스

MIT — LICENSE 참조.

이 저장소의 MCP 클라이언트 예시와 설정 스니펫은 MIT입니다. hooklayer.dev의 호스팅형 Hooklayer 서비스는 위에 나열된 가격 등급을 가진 상용 제품입니다.