# Throk MCP 설정: Claude, Cursor에서 Threads 데이터 조회하기

Throk은 [MCP(Model Context Protocol)](https://modelcontextprotocol.io) 서버를 제공합니다. 설정을 마치면 AI 어시스턴트에게 자연어로 데이터 조회를 요청할 수 있습니다. 예:

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

## 연결 정보

| 항목 | 값 |
| --- | --- |
| URL | `https://premium-api.throk.ai/mcp` |
| 전송 방식 | Streamable HTTP |
| 인증 | 헤더 `Authorization: Bearer sk-throk-...`(REST API와 같은 키 사용) |

## 설치

개발자 플랫폼의 [**MCP 서버**](https://developer.throk.ai/dashboard/mcp) 페이지에도 AI 도구별 설정 예시가 있어 그대로 복사해 쓸 수 있습니다.

### Claude Code

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

### Claude Desktop

설정 파일의 `mcpServers`에 다음을 추가합니다.

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

### Cursor

`.cursor/mcp.json`에 같은 설정을 추가합니다.

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

## 사용 가능한 도구

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

### 검색

| 도구 | 용도 | 크레딧 |
| --- | --- | --- |
| `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_user` | 계정 정보와 최근 게시물 | 1크레딧, 게시물 5개마다 1크레딧 추가 |
| `get_user_top_threads` | 계정에서 좋아요 수가 가장 많은 게시물 | 70크레딧부터 |
| `get_user_follower_history` | 계정의 일별 팔로워 수(최대 365일) | 일수 ÷ 3(올림), 최소 1크레딧 |

### 랭킹

| 도구 | 용도 | 크레딧 |
| --- | --- | --- |
| `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크레딧 |

### 실시간 데이터와 예측

| 도구 | 용도 | 크레딧 |
| --- | --- | --- |
| `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와 완전히 같습니다. [검색 규칙](/ko/api/guides/search-rules/)을 참고하세요.