Throk MCP 설치 가이드: Claude·ChatGPT·Codex·Cursor에 Threads 데이터 도구 추가하기

Throk은 MCP(Model Context Protocol) 서버를 제공합니다. 설정을 마치면 Claude, ChatGPT, Codex, Cursor 같은 AI 어시스턴트에게 자연어로 데이터 조회를 요청할 수 있습니다. 예:

「減脂」의 최근 30일 대만 언급량 추이를 보여 주고, 좋아요 수가 가장 많은 게시물 5개를 찾아 도입부를 어떻게 썼는지 정리해 줘.

연결 정보

항목	값
URL	https://premium-api.throk.ai/mcp
전송 방식	Streamable HTTP
인증	Throk 계정으로 로그인(OAuth) 또는 헤더 Authorization: Bearer sk-throk-...(REST API와 같은 키 사용)

두 가지 연결 방법

• Throk 계정으로 로그인(권장): AI 도구가 브라우저를 열면 Throk에 로그인해 허용하고, 다시 AI 도구로 돌아오면 됩니다. API 키가 필요 없습니다. Google 계정이나 이메일 로그인 링크로 로그인할 수 있으며, 이메일을 쓸 때는 메일 속 링크를 같은 브라우저에서 열어 주세요.
• API 키 사용: 개발자 플랫폼의 API 키 페이지에서 키를 만들어 AI 도구의 설정에 넣습니다.

두 방법 모두 같은 계정의 API 크레딧을 사용합니다. 아래 크레딧을 참고하세요.

설치

개발자 플랫폼의 MCP 서버 페이지에도 AI 도구별 설정 예시가 있어 그대로 복사해 쓸 수 있습니다.

Claude Code

Throk 계정으로 로그인: 아래 명령어를 실행한 뒤 Claude Code에서 /mcp를 입력하고 throk을 선택해 로그인합니다.

claude mcp add --transport http throk https://premium-api.throk.ai/mcp

API 키 사용: 명령어에 --header를 추가합니다.

claude mcp add --transport http throk \
  https://premium-api.throk.ai/mcp \
  --header "Authorization: Bearer sk-throk-..."

Claude Desktop

Throk 계정으로 로그인: Throk을 커넥터로 추가합니다.

1. 설정 › 커넥터를 열고 사용자 지정 커넥터를 추가합니다.
2. 이름은 Throk, URL에는 https://premium-api.throk.ai/mcp를 입력합니다.
3. 연결을 누르고 브라우저에서 Throk에 로그인해 허용합니다.

API 키 사용: mcp-remote로 키를 전달하며, Node.js가 필요합니다. claude_desktop_config.json에 다음 설정을 추가한 뒤 Claude Desktop을 다시 시작하세요.

{
  "mcpServers": {
    "throk": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://premium-api.throk.ai/mcp",
        "--header", "Authorization:${THROK_AUTH}"
      ],
      "env": { "THROK_AUTH": "Bearer sk-throk-..." }
    }
  }
}

args는 그대로 복사하고, env의 sk-throk-...만 본인의 키로 바꾸세요.

Cursor

Throk 계정으로 로그인: ~/.cursor/mcp.json(또는 프로젝트 내 .cursor/mcp.json)에 URL만 적고, Cursor 설정의 MCP 페이지에서 로그인합니다.

{
  "mcpServers": {
    "throk": {
      "url": "https://premium-api.throk.ai/mcp"
    }
  }
}

API 키 사용: headers를 추가합니다.

{
  "mcpServers": {
    "throk": {
      "url": "https://premium-api.throk.ai/mcp",
      "headers": {
        "Authorization": "Bearer sk-throk-..."
      }
    }
  }
}

Codex·ChatGPT 데스크톱 앱

Codex 앱, Codex CLI, ChatGPT 데스크톱 앱은 같은 MCP 설정을 공유합니다.

Throk 계정으로 로그인:

• 앱: Plugins › Add › Create MCP App에서 Server URL에 https://premium-api.throk.ai/mcp를 입력하고 Authentication에서 OAuth를 선택합니다. 만든 뒤 Throk에 로그인해 허용합니다. 아이콘이 필요하면 Throk 아이콘을 내려받아 업로드할 수 있습니다.
• CLI: ~/.codex/config.toml에 다음 설정을 추가하고 codex mcp login throk을 실행합니다.

[mcp_servers.throk]
url = "https://premium-api.throk.ai/mcp"

API 키 사용: 앱에서는 Authentication을 Bearer token으로 바꾸고 키를 붙여 넣습니다. CLI에서는 config.toml에 키를 담은 환경 변수를 지정합니다.

[mcp_servers.throk]
url = "https://premium-api.throk.ai/mcp"
bearer_token_env_var = "THROK_API_KEY"

export THROK_API_KEY=sk-throk-...

ChatGPT

ChatGPT 웹에서는 개발자 모드로 추가하고(Plus, Pro, Business, Enterprise, Edu 요금제) Throk 계정으로 로그인합니다.

1. ChatGPT 설정에서 개발자 모드를 켜고 커넥터를 추가합니다.
2. 이름은 Throk, MCP 서버 URL에는 https://premium-api.throk.ai/mcp를 입력하고 인증 방식은 OAuth를 선택합니다.
3. 만든 뒤 Throk에 로그인해 허용하면 대화에서 사용할 수 있습니다.

크레딧

• API 키와 Throk 계정으로 로그인한 AI 도구는 같은 계정의 API 크레딧을 공유합니다. 도구별 요금은 아래 사용 가능한 도구를 참고하세요. AI 어시스턴트에게 get_balance를 호출해 달라고 하면 언제든 잔액을 확인할 수 있습니다.
• 계정에 API 요금제가 없어도 연결은 되지만, 도구를 호출하면 오류와 함께 개발자 플랫폼의 크레딧 구매 페이지 링크가 반환됩니다.
• Throk 웹 버전(app.throk.ai)의 크레딧은 API 크레딧과 별도로 계산되며, MCP에서는 사용할 수 없습니다.

연결 해제

• API 키로 연결한 도구: 개발자 플랫폼의 API 키 페이지에서 키를 삭제하면 됩니다.
• Throk 계정으로 로그인한 도구: API 키를 삭제해도 연결이 해제되지 않습니다. 개발자 플랫폼의 MCP 서버 페이지에서 해제하세요.

사용 가능한 도구

모든 도구는 읽기 전용입니다.

검색

도구	용도	크레딧
search_posts	키워드로 게시물 검색(최대 25건)	게시물당 1크레딧(상세 정보 포함 시 게시물당 2크레딧)
semantic_search_posts	최근 30일 게시물을 의미로 검색(최대 10건)	30크레딧
get_inspiration	고참여 엄선 게시물에서 영감 찾기(최대 10건)	30크레딧
get_hot_posts	인기 게시물(30–50건)	70크레딧부터, 1개 추가될 때마다 2크레딧 추가(조회수순 정렬 시 100크레딧부터)
get_keyword_trend	키워드 일별 언급량(최대 키워드 10개, 90일)	3크레딧 × 키워드 수 × 일수(참여 지표 포함 시 4크레딧)

get_inspiration은 language 매개변수로 게시물 언어를 선택할 수 있습니다(영어 en을 포함해 7개 모두 지원). 지정하지 않으면 중국어, 일본어, 한국어 게시물을 반환하며 영어는 포함되지 않습니다. 사용할 수 있는 값은 게시물 언어를 참고하세요.

계정

도구	용도	크레딧
get_user	계정 정보와 최근 게시물	1크레딧, 게시물 5개마다 1크레딧 추가
get_user_top_threads	계정에서 좋아요 수가 가장 많은 게시물	70크레딧부터
get_user_follower_history	계정의 일별 팔로워 수(최대 365일)	일수 ÷ 3(올림), 최소 1크레딧
get_user_interactions	교류 랭킹: 가장 자주 댓글을 주고받는 상대(최대 100개 계정, 90일)	계정 10개까지 30크레딧, 1개 추가될 때마다 2크레딧 추가. 교류가 없으면 무료

랭킹

도구	용도	크레딧
get_cool_replies	베스트 댓글 순위	70크레딧부터
get_post_like_growth	바이럴 게시물(좋아요가 가장 빠르게 늘어나는 게시물)	70크레딧부터
get_follower_growth	팔로워가 가장 빠르게 늘어나는 계정	70크레딧부터
get_follower_ladder	팔로워 수 사다리(구간별 기준값)	5크레딧
get_like_ladder	좋아요 수 사다리(최근 24시간)	5크레딧
get_power_hours	플랫폼 황금 시간대(최근 28일)	5크레딧

랭킹, 사다리, 황금 시간대 도구도 검색 도구와 마찬가지로 language 매개변수로 게시물 언어를 선택하며(기본값 zh), 언어별로 따로 계산합니다(get_follower_growth도 7개 모두 지원). 사용할 수 있는 값은 게시물 언어를 참고하세요.

실시간 데이터와 예측

도구	용도	크레딧
forecast_posts	게시 후 1–12시간 이내 게시물이 조회수 기준에 도달할지 예측	게시물당 10크레딧
get_live_posts	게시물의 현재 수치를 실시간으로 조회(게시 시점 제한 없음)	게시물당 3크레딧(조회수가 숨겨진 경우 1크레딧)
get_live_users	계정의 현재 팔로워 수와 정보를 실시간으로 조회	계정당 3크레딧

계정 잔액

도구	용도	크레딧
get_balance	남은 크레딧 조회	무료

REST API와의 차이

• 건수 상한이 더 작습니다. 응답을 간결하게 유지하기 위해서입니다. 예: search_posts는 최대 25건, semantic_search_posts는 최대 10건. 대량의 데이터가 필요하면 REST API를 사용하세요.
• 미디어 URL과 프로필 사진 URL은 기본적으로 포함되지 않습니다. 필요하면 이 매개변수를 지원하는 도구에 include_media=true를 추가하세요.
• 호출당 타임아웃은 60초입니다.
• 검색 규칙은 REST API와 완전히 같습니다. 검색 규칙을 참고하세요.

Throk MCP 기능 소개와 요금은 Throk MCP에서 확인하세요.