claudekit / tools / x-api
[ MCP · Communication ]

X

X(구 Twitter)가 호스팅하는 공식 MCP 서버. Claude Code에서 게시물과 사용자를 검색하고, 북마크, 트렌드, 뉴스를 다루며 Article 초안을 작성합니다.

xdevplatform/xurl ·published ·updated
$ claude mcp add xapi --env CLIENT_ID=YOUR_X_APP_CLIENT_ID --env CLIENT_SECRET=YOUR_X_APP_CLIENT_SECRET -- npx -y @xdevplatform/xurl mcp https://api.x.com/mcp copy

X(구 Twitter)가 호스팅하는 공식 MCP 서버. 오픈소스 xurl 브리지(xdevplatform/xurl)로 연결합니다.

왜 필요한가?

X에서 게시물을 검색하거나 사용자 타임라인을 분석하려면 X 개발자 포털이나 API를 직접 다뤄야 했습니다. X MCP를 연결하면 Claude Code에서 게시물과 사용자 검색, 북마크, 트렌드, Article 작성을 대화로 처리할 수 있습니다.

무엇을 할 수 있나

X 공식 문서가 안내하는 대표 작업입니다.

  • 게시물 검색 — “지난 한 주 ‘Claude Code’ 관련 게시물을 전체 아카이브에서 찾아 요약해줘” (full-archive search)
  • 사용자 분석 — “@username의 최근 타임라인을 보고 주요 주제를 정리해줘” (user lookup, timeline)
  • 북마크 관리 — “이 게시물을 ‘AI’ 폴더에 북마크해줘” (bookmarks, folders)
  • 트렌드, 뉴스 — “지금 트렌딩 중인 토픽과 관련 뉴스를 보여줘” (trends by WOEID, news)
  • Article 작성 — “이 내용을 X Article 초안으로 작성해줘” (draft Articles)

근거: docs.x.com/tools/mcp.

핵심 기능

  • 게시물 — 게시물 조회, 좋아요/리포스트/인용한 사용자 확인, 최근 카운트
  • 검색 — 전체 아카이브 게시물 검색, 사용자 검색, 뉴스 검색
  • 사용자 — 현재 사용자 확인, ID/핸들 조회, 게시물/타임라인/멘션 읽기
  • 북마크 — 목록, 추가, 삭제, 폴더 관리
  • 뉴스, 트렌드 — 스토리 조회, 위치(WOEID)별 트렌드
  • Article — 초안 생성, 발행

요금

MCP 서버와 xurl 브리지 자체는 무료지만, 도구 호출은 모두 X API를 거칩니다. X API에는 무료 티어가 없으므로 사용한 만큼 요금이 발생합니다. 개발자 포털에서 크레딧을 미리 구매해 두면 호출할 때마다 차감되며, 약정이나 최소 결제액은 없습니다.

구분과금 기준단가
게시물 읽기응답에 반환된 건당$0.005
사용자 읽기응답에 반환된 건당$0.010
좋아요, 뮤트, 차단 읽기응답에 반환된 건당$0.001
내 계정 데이터 읽기(Owned Reads)응답에 반환된 건당$0.001
게시물 작성요청당$0.015
URL이 포함된 게시물 작성요청당$0.200

읽기는 요청 횟수가 아니라 응답에 반환된 건수만큼 과금됩니다. “지난 한 주 ‘Claude Code’ 관련 게시물을 찾아줘”에 100건이 돌아오면 $0.5입니다. 검색 범위를 넓게 잡으면 한 번의 대화로도 비용이 빠르게 늘어날 수 있으므로, 개발자 콘솔에서 지출 한도를 걸어 두는 것이 안전합니다.

근거: docs.x.com/x-api/getting-started/pricing.

연결 방법

X 개발자 포털에서 앱을 만들고, 해당 앱을 Pay-per-use 패키지와 Production 환경으로 설정해야 MCP 서버가 동작합니다.

OAuth 2.0 (읽기, 쓰기):

claude mcp add xapi --env CLIENT_ID=YOUR_X_APP_CLIENT_ID --env CLIENT_SECRET=YOUR_X_APP_CLIENT_SECRET -- npx -y @xdevplatform/xurl mcp https://api.x.com/mcp

App-only Bearer (읽기 전용):

claude mcp add --transport http xapi https://api.x.com/mcp --header "Authorization: Bearer YOUR_APP_ONLY_BEARER_TOKEN"

알아두면 좋은 점

  • 사용량 한도 — 쓰기 작업(북마크, Article 발행)은 읽기보다 rate limit(일정 시간 안에 허용되는 호출 횟수)이 엄격해 429 응답이 날 수 있으므로 재시도 간격을 두는 것이 좋습니다. Pay-per-use는 월 200만 건의 게시물 읽기 상한이 있고, 그 이상은 Enterprise 플랜이 필요합니다
  • 인증 — OAuth 2.0 PKCE(자동 토큰 갱신)는 X 앱의 CLIENT_ID, CLIENT_SECRET 필요. 읽기 전용은 App-only Bearer 토큰 사용. 원격 환경은 xurl auth oauth2 --headless
  • 첫 실행 — OAuth 첫 로그인 시 브라우저가 필요하므로 클라이언트 설정에 startup_timeout_sec를 300 이상으로 권장
  • 설치 명령 출처 — 공식 문서는 Claude Desktop의 claude_desktop_config.json 기준 JSON을 제공하며, 위 명령은 이를 Claude Code(claude mcp add) 형식으로 옮긴 것
  • 라이선스 — xurl 브리지는 MIT. MCP 서버는 X가 호스팅하는 서비스
§ 7

자주 묻는 질문

자주 묻는 질문
§ 7.1
X MCP는 무엇인가요?
X(구 Twitter)가 호스팅하는 공식 MCP 서버(`https://api.x.com/mcp`)입니다. Claude Code에서 게시물과 사용자를 검색하고, 북마크, 트렌드, 뉴스를 다루며 Article 초안을 작성할 수 있습니다.
§ 7.2
어떤 환경에서 동작하나요?
Claude Code, Claude Desktop, Cursor, VS Code 등 MCP 호환 도구에서 동작합니다. OAuth 2.0 연결은 `xurl` 로컬 브리지(`@xdevplatform/xurl`)를 통해 처리됩니다.
§ 7.3
어떻게 설치하나요?
OAuth 2.0 방식은 X 앱의 `CLIENT_ID`와 `CLIENT_SECRET`을 `xurl mcp` 브리지에 전달합니다. 읽기 전용이라면 App-only Bearer 토큰을 `Authorization` 헤더로 전달해 `https://api.x.com/mcp`에 직접 연결할 수 있습니다.
§ 7.4
무료로 사용할 수 있나요?
MCP 서버와 `xurl` 브리지는 무료지만, X API에는 무료 티어가 없어 사용한 만큼 요금이 발생합니다. 읽기는 응답에 반환된 건수당(게시물 $0.005, 사용자 $0.010), 쓰기는 요청당(게시물 작성 $0.015) 과금되며, 개발자 포털에서 크레딧을 미리 구매해 차감하는 방식입니다.
§ 7.5
X API 계정 없이도 쓸 수 있나요?
쓸 수 없습니다. 도구 호출이 모두 X API를 거치므로, X 개발자 포털에서 앱을 만들고 Pay-per-use 패키지와 Production 환경으로 설정해야 동작합니다.
§ 7.6
어떤 작업을 할 수 있나요?
전체 아카이브 게시물 검색, 사용자 조회와 타임라인 분석, 북마크 추가와 폴더 관리, 트렌드와 뉴스 조회, Article 초안 작성과 발행이 가능합니다.