インストール + MCP クライアントへの登録¶

3 ステップ。ステップ 3 でクライアントを選びます。

1. バイナリをインストール¶

uv tool install twikit-mcp

なぜ uv tool install:twikit-mcp を独立環境(依存衝突なし)で PATH 上に配置、以降の起動は瞬時、アップグレードは uv tool upgrade twikit-mcp の一行で完結。

uv がない場合:1 行でインストール(macOS / Linux は curl 一発)。pipx / pip でも OK — 詳細は README "Choose your install" を参照。

2. X の cookies を配置¶

ブラウザで x.com にログイン → DevTools(F12)→ Application → Cookies → https://x.com。ct0 と auth_token をコピー。

mkdir -p ~/.config/twitter-mcp
cat > ~/.config/twitter-mcp/cookies.json <<'EOF'
{"ct0": "...", "auth_token": "..."}
EOF
chmod 600 ~/.config/twitter-mcp/cookies.json

3. クライアントへの登録¶

JSON の形(mcpServers ブロック)はどのクライアントでも同じ、設定ファイルの場所だけが違います。/home/YOU は自分のホームに置き換えてください。

Claude Code¶

CLI 一発、JSON を編集不要:

claude mcp add twitter -s user \
  -e "TWITTER_COOKIES=$HOME/.config/twitter-mcp/cookies.json" \
  -- twikit-mcp

Claude Desktop¶

OS	設定ファイル
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`
Linux	`~/.config/Claude/claude_desktop_config.json`

ファイルがなければ作成、以下を追加:

{
  "mcpServers": {
    "twitter": {
      "command": "twikit-mcp",
      "env": {
        "TWITTER_COOKIES": "/home/YOU/.config/twitter-mcp/cookies.json"
      }
    }
  }
}

Claude Desktop を再起動。

Cursor¶

~/.cursor/mcp.json(グローバル)または .cursor/mcp.json(プロジェクト単位)を編集:

{
  "mcpServers": {
    "twitter": {
      "command": "twikit-mcp",
      "env": {
        "TWITTER_COOKIES": "/home/YOU/.config/twitter-mcp/cookies.json"
      }
    }
  }
}

Cursor は自動リロードするので再起動不要。

Windsurf¶

~/.codeium/windsurf/mcp_config.json を編集:

{
  "mcpServers": {
    "twitter": {
      "command": "twikit-mcp",
      "env": {
        "TWITTER_COOKIES": "/home/YOU/.config/twitter-mcp/cookies.json"
      }
    }
  }
}

Windsurf を再起動。

Cline(VS Code 拡張)¶

Cline パネル → ⚙️ → MCP Servers → Edit MCP Settings を開く。保存すると自動リロード。

{
  "mcpServers": {
    "twitter": {
      "command": "twikit-mcp",
      "env": {
        "TWITTER_COOKIES": "/home/YOU/.config/twitter-mcp/cookies.json"
      }
    }
  }
}

opencode¶

~/.config/opencode/config.json を編集:

{
  "mcpServers": {
    "twitter": {
      "command": "twikit-mcp",
      "env": {
        "TWITTER_COOKIES": "/home/YOU/.config/twitter-mcp/cookies.json"
      }
    }
  }
}

その他の MCP クライアント¶

twikit-mcp は標準的な stdio MCP サーバーです。クライアントの設定ファイルがどんな形でも、JSON の形は同じ:

{
  "mcpServers": {
    "twitter": {
      "command": "twikit-mcp",
      "env": {
        "TWITTER_COOKIES": "/home/YOU/.config/twitter-mcp/cookies.json"
      }
    }
  }
}

クライアントによっては mcpServers ではなく mcp.servers を使ったり、別のトップレベル key の中にネストすることもあります — クライアントのドキュメントを確認してください。command と env フィールドはどこでも共通です。

動作確認¶

クライアントで質問してみる:

AI 関連のツイートを検索して

エージェントが search_tweets を呼び結果を返せば OK。権限エラーが出たら cookies.json のパスが間違っているはず — 上の JSON の TWITTER_COOKIES を再確認。

アップグレード¶

uv tool upgrade twikit-mcp

完了 — 次回クライアント起動時に新しいバイナリが使われます。