$ 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 — 초안 생성, 발행
연결 방법
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/mcpApp-only Bearer (읽기 전용):
claude mcp add --transport http xapi https://api.x.com/mcp --header "Authorization: Bearer YOUR_APP_ONLY_BEARER_TOKEN"알아두면 좋은 점
- 요금 — MCP 서버와
xurl브리지는 무료이나, X API는 개발자 계정과 Pay-per-use 플랜 가입이 필요. 쓰기 작업(북마크, Article)은 사용량 한도에 포함 - 인증 — 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가 호스팅하는 서비스