MindThread는 Claude, Cursor 등 MCP 클라이언트에서 Threads 게시물을 작성·예약·게시하고, 답글 초안을 검토하며 계정 통계를 확인할 수 있게 하는 서비스다. 제작자는 Meta의 공식 Threads API를 사용하며, 게시 전에 사용자 승인을 받도록 권한을 설정할 수 있다고 설명한다. MindThread MCP 저장소
이 서비스는 40개가 넘는 도구를 제공한다. 게시물 작성, 예약, 게시 외에도 계정별 브랜드 자료와 콘텐츠 규칙을 관리하고, 키워드를 찾는 클라우드 순찰 기능으로 답글 초안을 만들 수 있다. 클라우드 순찰 답글은 사용자가 승인하거나 거부할 수 있다. 통계 도구는 계정별 조회수·좋아요·답글·팔로워와 순찰 답글의 결과를 보여준다.
각 API 키의 권한은 기능별로 allow, ask, deny 중 하나로 설정한다. ask로 지정한 작업은 사용자가 mindthread.tw에서 확인할 때까지 실행되지 않으며, 에이전트는 사용자에게 전달할 승인 링크를 받는다.
설정과 사용
먼저 mindthread.tw에 가입하고 Threads 계정을 연결한 뒤, Settings → API keys에서 키를 만든다. 처음에는 mt_test_… 테스트 키를 사용할 수 있다. 테스트 키는 실제 데이터를 읽지만 쓰기 작업은 모의 실행하므로 Threads에 게시되지 않는다. 실제 게시를 시작할 준비가 되면 mt_live_… 라이브 키로 바꾼다.
원문은 모든 요금제에 API 접근이 포함된다고 안내한다. 2026년 10월 기준 무료 요금제는 라이브 키 하나당 하루 50회 호출을 제공하며, 테스트 키는 하루 500회인 샌드박스를 공유한다. 최신 제한은 mindthread.tw/developers에서 확인할 수 있다.
Claude Code에서 원격 서버에 API 키를 사용해 연결하는 명령은 다음과 같다.
claude mcp add --transport http mindthread https://mindthread.tw/api/mcp --header "Authorization: Bearer mt_live_your_key"
MindThread 계정으로 로그인하는 원격 연결도 가능하다. 이 방식은 API 키 대신 계정으로 인증하며, Claude Code에서 /mcp를 실행해 로그인한다.
claude mcp add --transport http mindthread https://mindthread.tw/api/mcp
로컬 stdio 방식은 다음과 같이 설정한다.
claude mcp add mindthread --env MINDTHREAD_API_KEY=mt_live_your_key -- npx -y mindthread-mcp
원격 연결은 설치 없이 https://mindthread.tw/api/mcp를 지정한다. 로컬 stdio 연결은 npx -y mindthread-mcp를 실행하며, 두 방식 모두 같은 서버로 메시지를 전달하므로 도구는 동일하다.
Claude Desktop에서는 Settings → Developer → Edit Config에서 claude_desktop_config.json을 수정한다.
{
"mcpServers": {
"mindthread": {
"command": "npx",
"args": ["-y", "mindthread-mcp"],
"env": { "MINDTHREAD_API_KEY": "mt_live_your_key" }
}
}
}
Windows에서 Claude가 npx를 찾지 못하면 명령과 인수를 다음처럼 지정한다.
"command": "cmd"
"args": ["/c", "npx", "-y", "mindthread-mcp"]
설정 파일을 수정하지 않고 연결하려면 Settings → Connectors → Add custom connector에서 URL https://mindthread.tw/api/mcp를 입력한 뒤 MindThread 계정으로 로그인한다. 이 방법은 사용자 요금제에서 사용자 지정 커넥터를 제공해야 사용할 수 있다.
Cursor는 모든 프로젝트에 적용할 때 ~/.cursor/mcp.json, 한 프로젝트에만 적용할 때 .cursor/mcp.json을 사용한다.
{
"mcpServers": {
"mindthread": {
"url": "https://mindthread.tw/api/mcp",
"headers": { "Authorization": "Bearer mt_live_your_key" }
}
}
}
Cursor에서 stdio 방식으로 설정하려면 "command": "npx", "args": ["-y", "mindthread-mcp"], "env": { "MINDTHREAD_API_KEY": "mt_live_your_key" }를 사용한다.
VS Code의 GitHub Copilot 에이전트 모드에서는 .vscode/mcp.json에 다음 설정을 넣는다. 키를 한 번 입력하도록 요청하고 안전하게 저장하는 구성이다.
{
"inputs": [
{ "type": "promptString", "id": "mindthread-key", "description": "MindThread API key", "password": true }
],
"servers": {
"mindthread": {
"type": "http",
"url": "https://mindthread.tw/api/mcp",
"headers": { "Authorization": "Bearer ${input:mindthread-key}" }
}
}
}
다른 MCP 클라이언트는 Streamable HTTP 주소 https://mindthread.tw/api/mcp와 Authorization: Bearer <key> 헤더를 사용한다. X-API-Key 헤더도 지원한다. stdio 방식은 npx 명령과 -y mindthread-mcp 인수, MINDTHREAD_API_KEY 환경 변수를 사용한다. 키가 없어도 initialize, tools/list, get_playbook, list_formulas를 호출해 기능을 둘러볼 수 있다.
Node.js 18.17 이상이 필요하며 런타임 의존성은 없다. 설정 변수 MINDTHREAD_API_KEY는 계정에 접근하는 도구에 필요하고 값은 mt_live_… 또는 mt_test_… 형식이다. MINDTHREAD_MCP_URL은 선택 사항이며, 서버 주소를 재정의한다. 기본값은 https://mindthread.tw/api/mcp다.
게시물 작성과 권한 관리
계정의 페르소나, 브랜드 자료, 콘텐츠 공식에 맞춰 게시물 초안 1~5개를 만들거나 2~10개 부분으로 이어지는 스레드를 작성할 수 있다. 게시물은 텍스트, 이미지 한 장, 이미지 2~10장의 캐러셀, 동영상 형식을 지원한다. 바로 게시하거나 정확한 시각에 예약할 수 있고, 계정의 자체 게시 시간대에 맞춰 자동 게시하는 대기열에 넣을 수도 있다.
콘텐츠 규칙은 프롬프트의 권고에 그치지 않고 서버에서 적용한다. 규칙에는 글자 수, 금지 문구, 해시태그 사용 금지, 제공한 사실 목록에 있는 숫자만 사용하기 등이 포함된다. enforce: "block"으로 설정하면 규칙을 어긴 게시물을 서버가 거부한다.
클라우드 순찰은 Threads에서 지정 키워드를 검색하고 답글 초안을 만든다. 사용자는 에이전트에 초안을 나열하게 한 뒤 각각 승인하거나 거부할 수 있다. 게시물을 예약한 뒤에는 list_schedules로 결과를 확인할 수 있다. 서비스 안내의 예시 요청은 계정을 나열하고, 사업을 시작한 이유에 관한 짧은 글을 작성해 보여준 다음 타이베이 시간으로 다음 날 오전 9시에 예약하는 것이다. 이 과정에서 에이전트는 list_accounts, generate_posts, publish와 publish_at을 사용한다.
예시 요청으로는 계정의 말투에 맞춘 게시물 3개 작성, 초안 1·3번을 대기열에 넣고 2번을 금요일 20시에 예약하기, 검토 대기 중인 답글을 하나씩 보여주기, 최근 7일과 그 이전 7일의 계정 성과 비교, 클라우드 순찰 키워드와 하루 답글 상한을 설정하고 모든 답글을 검토 대기 상태로 두기 등이 제시돼 있다.
키별 권한은 읽기, 초안 작성, 예약, 즉시 게시, 답글 전송, 클라우드 순찰 활성화, 계정 연결, 보호 규칙 완화, 웹훅 등으로 나뉜다. 각 권한을 Settings → API keys에서 allow, ask, deny로 설정한다. ask 권한이 필요한 작업을 요청하면 에이전트는 approval_required와 승인 링크를 받으며, 사용자가 mindthread.tw에서 확인한 뒤에만 작업이 실행된다.
보호 규칙 변경을 되돌리는 일은 웹사이트에서 사용자만 할 수 있다. 클라우드 순찰 활성화 권한은 Claude·ChatGPT 같은 OAuth 연결에는 부여되지 않으며, API 키에는 해당 권한을 명시적으로 설정해야 한다. disable_this_key는 현재 사용 중인 키를 영구적으로 비활성화한다. Settings에서 키와 연결을 취소할 수도 있다.
게시와 답글은 Meta의 공식 Threads API를 이용하며, MindThread는 Threads 비밀번호를 요구하지 않는다고 설명한다. stdio 모드에서는 키를 MINDTHREAD_API_KEY 환경 변수에서 읽어 mindthread.tw에만 전송한다. 키를 출력하지 않으며 로그에는 mt_live_…abcd처럼 표시한다.
제공 도구
저장소는 npm run tools-table로 라이브 서버에서 생성한 도구 목록을 공개한다. 서버가 도구 목록의 기준이며, 서버에 도구가 추가되면 패키지를 업데이트하지 않아도 이를 노출한다고 안내한다. 아래 설명은 저장소에 기재된 도구와 기능을 옮긴 것이다.
| 도구 | 이름·기능 | 종류 |
|---|---|---|
get_me | 현재 요금제, 연결의 신원과 권한, 남은 일일 호출 수 등을 반환한다. | 읽기 |
list_accounts | 연결된 Threads 계정과 다른 도구에 전달할 account_id를 나열한다. | 읽기 |
get_material | 브랜드 정체성, 판매 제품, 주장, 경험, FAQ, 출처가 있는 수치, 말투 등 계정 자료 요약을 반환한다. | 읽기 |
build_material | 브랜드 웹사이트의 HTTPS 페이지 최대 8개와 선택 사항인 실제 사례 메모 등을 바탕으로 계정 자료 요약을 만들거나 다시 만든다. | 쓰기 |
get_account_settings | 계정의 페르소나, schedule_times, review_before_publish, auto_reply_enabled, auto_thread, content_rules와 보호 설정을 반환한다. | 읽기 |
update_account_settings | 계정 설정을 변경한다. 페르소나는 최대 4,000자, schedule_times는 계정 시간대의 쉼표로 구분한 HH:MM 형식으로 최대 8개까지 지정할 수 있다. | 쓰기 |
list_guardrail_changes | 계정의 보호 규칙 변경 이력을 최신순으로 나열한다. 제한은 1~50개, 기본값은 20개이며 다음 페이지는 before로 지정한다. | 읽기 |
list_account_settings | 회원의 연결된 Threads 계정 전체와 일괄 설정 시트의 설정을 나열한다. 실행 모드, 자동 게시, 검토 설정 등이 포함된다. | 읽기 |
preview_account_settings | 일괄 설정 변경의 영향을 미리 보여주며 실제로 쓰지는 않는다. 계정·항목별 기존 값과 새 값, 경고 등을 반환한다. | 읽기 |
apply_account_settings | 최대 100개 계정의 설정 변경을 적용한다. 계정별로 별도 트랜잭션을 실행하고 행별 결과를 반환한다. | 쓰기 |
revert_account_settings_batch | 일괄 변경으로 바뀐 값을 변경 후 24시간 이내에 복원한다. | 쓰기 |
get_account_settings_batch | batch_id로 일괄 변경 한 건을 조회한다. 실행 시각과 출처(웹사이트·API·MCP), 건수, 되돌리기 가능 여부 등을 반환한다. | 읽기 |
generate_posts | 주제와 콘텐츠 공식(자동 또는 list_formulas의 ID), 계정 페르소나 및 자료를 사용해 게시물 초안 1~5개를 만든다. | 쓰기 |
publish | publish_now:true로 즉시 게시하거나, 시간대가 포함된 ISO 8601 형식의 publish_at에 게시한다. | 쓰기 |
schedule_text | 최대 500자의 기존 텍스트를 publish_at에 예약하거나 auto_optimize_time:true로 다음 최적 시간대에 예약한다. 두 방식은 상호 배타적이다. | 쓰기 |
list_schedules | 예약 게시물을 나열하며 선택적으로 account_id로 필터링한다. 상태, publish_at, 보류된 게시물의 held_reason 등을 반환한다. | 읽기 |
cancel_schedule | ID로 예약 게시물을 취소한다. | 쓰기 |
list_library | 계정의 라이브러리 항목을 상태별로 나열한다. 상태는 대기열·초안·게시됨·실패이며 최대 200개까지 요청할 수 있다. | 읽기 |
add_library | 텍스트와 선택적 공개 HTTPS 이미지가 포함된 항목을 최대 20개 추가한다. 기본 상태는 대기열이며 계정 게시 시간에 자동 게시된다. | 쓰기 |
delete_library_item | ID로 대기열·초안·보관 상태의 라이브러리 항목 하나를 영구 삭제한다. | 쓰기 |
approve_library_item | ID로 초안 하나를 게시 대기열로 옮긴다. | 쓰기 |
update_library_item | ID로 라이브러리 항목의 상태(보관·초안·대기열), 텍스트(콘텐츠 규칙 검사 적용), 대기열 내 위치 등을 바꾼다. | 쓰기 |
get_cloud_patrol | 계정의 클라우드 순찰 설정과 상태를 반환한다. 키워드, 일일 상한, 당일 전송 답글 수, review_before_reply, 마지막 검색 시각이 포함된다. | 읽기 |
set_cloud_patrol | 계정의 클라우드 순찰을 만들거나 수정한다. 키워드는 1~10개이며 #tag 항목은 주제 태그를 검색한다. 페르소나와 일일 상한(1~50) 등도 설정한다. | 쓰기 |
cloud_patrol_log | 최근 1~7일간 계정의 클라우드 순찰 답글을 나열한다. 대상 게시물과 답글 문구를 포함한다. | 읽기 |
cloud_patrol_stats | 1~14일 동안 클라우드 순찰 답글이 얻은 조회수와 좋아요, 상위 답글을 반환한다. | 읽기 |
list_pending_replies | 계정의 클라우드 순찰 답글 초안을 상태별로 나열한다. 기본값은 대기 중이며 전송됨·거부됨·만료됨도 조회할 수 있다. | 읽기 |
approve_pending_reply | 대기 중인 클라우드 순찰 답글 하나를 승인해 Threads에 즉시 전송한다. 같은 품질 기준을 통과하는 수정 문구를 선택적으로 지정할 수 있다. | 쓰기 |
reject_pending_reply | ID로 클라우드 순찰 답글 초안을 거부하며 메모를 선택적으로 추가한다. | 쓰기 |
list_events | 최근 7일간 회원의 이벤트를 최신순으로 나열한다. 최대 200개까지 요청할 수 있으며 post.published, post.failed, reply.sent, patrol.reply 등이 포함된다. | 읽기 |
analytics_insights | 한 계정의 기간별 조회수·좋아요·답글·팔로워를 반환한다. 기간은 7일 또는 30일이며 기본값은 30일이다. | 읽기 |
list_formulas | generate_posts에서 사용할 수 있는 콘텐츠 공식의 ID와 간단한 설명을 나열한다. | 읽기 |
get_playbook | 서버에서 계정을 운영하는 방법을 반환한다. 일일 절차, 확인 요청 작동 방식, 할당량 등이 포함된다. | 읽기 |
connect_account_link | 회원에게 새 Threads 계정을 연결할 OAuth 링크를 반환한다. 사용자가 브라우저에서 열어야 한다. | 쓰기 |
disable_this_key | 현재 호출에 사용된 키 또는 연결을 영구적으로 비활성화한다. | 쓰기 |
get_my_usage | 최근 1~30일간 현재 연결의 사용량과 호출 기록을 반환한다. days=1은 Asia/Taipei 기준 오늘 00:00 이후를 뜻하며 호출·단위·오류 요약 등을 포함한다. | 읽기 |
get_approval | 이 연결이 만든 apr_... 형식의 확인 요청 하나를 ID로 조회한다. 대기·승인·실행·실패·거부·만료 상태 등을 반환한다. | 읽기 |
bulk_archive_library | ID로 라이브러리 항목 최대 50개를 한 번에 보관한다. | 쓰기 |
bulk_delete_library | 대기열·초안·보관 항목 최대 50개를 한 번에 영구 삭제한다. | 쓰기 |
bulk_queue_library | 초안 최대 50개를 한 번에 게시 대기열로 옮긴다. 계정의 schedule_times에 따라 자동 게시된다. | 쓰기 |
제한과 문제 해결
MINDTHREAD_API_KEY is not set 오류가 발생하면 클라이언트 설정의 해당 서버 env 항목에 키를 넣고 클라이언트를 다시 시작한다. MindThread rejected the key 오류는 키가 잘못됐거나 취소·비활성화됐다는 뜻이므로 Settings → API keys에서 새 키를 만든다.
approval_required는 승인 절차가 작동 중이라는 의미다. 에이전트가 제공한 링크를 열어 승인하면 게시물이 전송된다. insufficient_scope는 해당 키의 권한이 deny로 설정됐다는 뜻이며, 오류의 fix 항목이 변경할 설정을 알려준다. rate_limit_exceeded는 일일 또는 분당 제한에 도달했다는 뜻으로, 오류에 제한이 초기화되는 시각이 표시된다.
로그는 stderr로 출력된다. Claude Desktop에서는 Settings → Developer → Open Logs Folder에서 확인할 수 있으며, stdout에는 MCP 메시지만 전달된다.
스크립트나 셸 명령을 선호하는 에이전트에는 mindthread-cli를 제공하며 npx mindthread-cli로 실행할 수 있다. REST API의 OpenAPI 3.1 명세는 mindthread.tw/api/v1/openapi.json, 문서는 mindthread.tw/developers, 에이전트 안내는 mindthread.tw/llms.txt에 있다. 저장소의 라이선스는 MIT이며 저작권 표기는 Ultra Lab이다.
댓글 (0)
로그인하면 이 기사에 내 생각을 남길 수 있어요