# Server MCP Twitter untuk Claude dan Cursor

Server MCP Twitter untuk Claude dan Cursor membantu agen membaca postingan publik X, utas, dan hasil pencarian dalam Markdown. Bayar per postingan.

Page: https://twitterviewer.app/id/twitter-mcp-server

Beri Claude, Cursor, dan Codex akses untuk membaca konten publik X. Satu server jarak jauh, lima alat hanya baca, hasil dalam Markdown. Masuk sekali melalui peramban atau gunakan kunci API.

TwitterViewer adalah layanan independen. Layanan ini bukan API resmi X dan tidak berafiliasi dengan X Corp. Layanan ini hanya membaca postingan publik: tidak dapat membuat postingan, menyukai, mengikuti, mengirim pesan, atau membaca akun privat.

## Connect

Server URL: https://twitterviewer.app/mcp (Streamable HTTP). Koneksi pertama membuka peramban agar Anda dapat masuk ke TwitterViewer. Tidak ada pengaturan tambahan.

### Claude Code

```
claude mcp add --transport http twitterviewer https://twitterviewer.app/mcp
```

With an API key:

```
claude mcp add --transport http twitterviewer https://twitterviewer.app/mcp \
  --header "Authorization: Bearer $TWITTERVIEWER_API_KEY"
```

### Cursor

```
{
  "mcpServers": {
    "twitterviewer": { "url": "https://twitterviewer.app/mcp" }
  }
}
```

With an API key:

```
{
  "mcpServers": {
    "twitterviewer": {
      "url": "https://twitterviewer.app/mcp",
      "headers": { "Authorization": "Bearer ${env:TWITTERVIEWER_API_KEY}" }
    }
  }
}
```

### Codex

```
[mcp_servers.twitterviewer]
url = "https://twitterviewer.app/mcp"
```

With an API key:

```
[mcp_servers.twitterviewer]
url = "https://twitterviewer.app/mcp"
bearer_token_env_var = "TWITTERVIEWER_API_KEY"
```

## Tools

| Tool | Arguments | What it does |
| --- | --- | --- |
| convert_x_url | url, scope, format, stats, max | Turns a post, thread or profile link into Markdown, Obsidian, text or JSON. |
| search_x_posts | query, max | Searches public posts (Pro and Business). |
| get_x_replies | url, max | Reads the replies under a post. |
| get_x_trends | region | Lists trends for a region. |
| get_credits | none | Shows the balance. |

Server MCP Twitter memberi asisten AI cara yang aman untuk membaca X. TwitterViewer menyediakan server jarak jauh di `https://twitterviewer.app/mcp`. Tambahkan ke Claude, Claude Code, Cursor, atau Codex, lalu asisten dapat mengubah tautan X menjadi Markdown, membaca balasan di bawah postingan, mencari postingan publik, dan memeriksa topik yang sedang tren tanpa Anda perlu menyalin dan menempelkan apa pun.

Server ini hanya dapat membaca. Server ini tidak dapat membuat postingan, membalas, menyukai, mengikuti akun, mengirim pesan, atau mengakses akun privat, dan merupakan layanan independen yang tidak berafiliasi dengan X Corp. Panduan ini menjelaskan apa itu server MCP untuk Twitter, cara menghubungkannya di setiap aplikasi, cara kerja proses masuk, fungsi kelima alatnya, perhitungan kredit, dan cara mengatasi masalah umum.

## Apa itu Server MCP Twitter?

MCP, singkatan dari Model Context Protocol, adalah standar terbuka yang memungkinkan aplikasi AI memanggil alat yang disediakan program lain. Server MCP untuk Twitter menyediakan alat untuk membaca X (Twitter) melalui standar tersebut. Alih-alih menempelkan utas ke percakapan, Anda meminta asisten membaca tautan, lalu asisten memanggil alat, menerima Markdown, dan mengolahnya.

Server ini berjalan dari jarak jauh. Tidak ada yang perlu diinstal dan tidak ada proses yang harus terus berjalan di komputer Anda: aplikasi Anda terhubung ke URL melalui Streamable HTTP. Layanannya sama dengan [API Twitter](https://twitterviewer.app/id/twitter-api), sehingga menggunakan kredit yang sama, yaitu satu kredit untuk setiap postingan yang dikembalikan, dan panggilan yang gagal tidak dikenai biaya.

Anda mungkin juga menemukannya dengan sebutan server MCP X atau MCP Twitter. Semuanya berarti hal yang sama: server alat yang memungkinkan agen membaca postingan publik. Perbedaan antarserver terletak pada kemampuannya. Server ini memang dirancang hanya untuk membaca konten publik.

## Apa yang bisa dilakukan server MCP untuk Twitter bagi agen Anda?

Setelah terhubung, agen dapat melakukan empat jenis pekerjaan dengan konten X:

- **Membaca tautan.** Berikan alamat postingan, utas, atau profil, lalu agen akan mengembalikan Markdown, catatan Obsidian, teks biasa, atau JSON.
- **Mencari.** Minta agen menemukan postingan publik dengan operator pencarian X, misalnya semua postingan dari sebuah akun yang mendapat setidaknya 100 suka. Pencarian tersedia dalam paket Pro dan Business.
- **Membaca balasan.** Tanyakan tanggapan orang di bawah sebuah postingan dan keberatan apa yang sering muncul.
- **Memeriksa tren.** Tampilkan topik yang sedang tren di suatu wilayah.

Karena hasilnya berupa Markdown, konten ini hemat token saat dimasukkan ke konteks model dan tetap mempertahankan struktur aslinya: urutan postingan dalam utas, tautan yang dibagikan penulis, serta referensi gambar. Agen menerima dokumen, sehingga tidak perlu mengekstrak halaman web lalu menebak isinya.

## Hubungkan server MCP untuk Twitter

URL servernya adalah `https://twitterviewer.app/mcp`. Pilih aplikasi Anda di bawah ini. Setiap contoh konfigurasi menggunakan proses masuk melalui browser, yang merupakan cara termudah.

### Claude Code

Jalankan satu perintah di terminal:

```bash
claude mcp add --transport http twitterviewer https://twitterviewer.app/mcp
```

Jalankan Claude Code, jalankan `/mcp` untuk melihat server, lalu ikuti tautan masuk saat pertama kali menggunakannya. Setelah itu, minta dengan bahasa biasa: "Baca https://x.com/username/status/1234567890123456789 sebagai Markdown."

### Claude

Di Claude versi web atau aplikasi desktop, buka pengaturan, masuk ke bagian konektor, pilih opsi untuk menambahkan konektor khusus, lalu tempelkan URL server. Claude membuka jendela browser agar Anda dapat masuk ke TwitterViewer. Setelah itu, alat-alatnya akan muncul dalam percakapan Anda.

### Cursor

Tambahkan server ke `mcp.json` Anda:

```json
{
  "mcpServers": {
    "twitterviewer": { "url": "https://twitterviewer.app/mcp" }
  }
}
```

Buka pengaturan MCP di Cursor, aktifkan server, lalu masuk saat diminta.

### Codex

Tambahkan server ke berkas konfigurasi Codex Anda:

```toml
[mcp_servers.twitterviewer]
url = "https://twitterviewer.app/mcp"
```

Mulai ulang Codex, lalu kelima alat akan ditampilkan.

## Masuk melalui browser atau gunakan kunci API

Ada dua cara untuk mengizinkan akses ke server MCP untuk Twitter, dan Anda dapat memilihnya untuk setiap aplikasi.

**Masuk melalui browser** adalah cara bawaan. Saat aplikasi pertama kali terhubung, browser akan terbuka agar Anda dapat masuk ke TwitterViewer dan menyetujui koneksinya. Tidak ada konfigurasi tambahan dan Anda tidak perlu menyalin kredensial rahasia.

**Kunci API** digunakan di lingkungan tanpa browser: server, tugas CI, dan beberapa editor. Buat kunci di halaman API, ekspor sebagai `TWITTERVIEWER_API_KEY`, lalu kirim sebagai token Bearer. Di Claude Code, tambahkan `--header "Authorization: Bearer $TWITTERVIEWER_API_KEY"` ke perintah. Di Cursor, tambahkan entri `headers` dengan nilai yang sama. Di Codex, tambahkan `bearer_token_env_var = "TWITTERVIEWER_API_KEY"` di bawah URL.

Apa pun caranya, biaya panggilan dibebankan ke akun yang digunakan untuk masuk. Jangan simpan kunci dalam berkas bersama atau repositori, dan hapus kunci di halaman API jika bocor. Setiap akun dapat memiliki setidaknya satu kunci: 1 untuk akun gratis, 2 untuk Plus, 5 untuk Pro, dan 20 untuk Business.

## Lima alat yang tersedia

Kelima alat hanya dapat membaca, dan ditampilkan kepada agen dengan nama berikut.

| Alat | Fungsi | Biaya |
| --- | --- | --- |
| `convert_x_url` | Mengubah tautan postingan, utas, atau profil menjadi Markdown, Obsidian, teks, atau JSON | 1 kredit per postingan |
| `search_x_posts` | Mencari postingan publik dengan operator pencarian X (Pro dan Business) | 1 kredit per postingan |
| `get_x_replies` | Membaca balasan publik di bawah postingan | 1 kredit per balasan |
| `get_x_trends` | Menampilkan topik yang sedang tren di suatu wilayah | 1 kredit per panggilan |
| `get_credits` | Menampilkan saldo Anda dan sumbernya | Gratis |

`convert_x_url` menerima tautan, cakupan (`post`, `thread`, atau `conversation`), format, dan, untuk profil, jumlah postingan yang akan dikembalikan. Inilah alat yang paling sering digunakan agen. `search_x_posts` menerima kueri dan jumlah maksimum postingan, serta memerlukan akun X yang terhubung karena X hanya menyediakan pencarian bagi pengguna yang sudah masuk. Daftar argumen lengkap tersedia di [Dokumentasi API](https://twitterviewer.app/docs/api).

## Apa yang bisa Anda minta kepada agen?

Server alat hanya berguna jika Anda tahu apa yang perlu diminta. Instruksi berikut dapat digunakan setelah server terhubung:

- "Baca utas ini dan berikan lima poin utamanya: https://x.com/username/status/1234567890123456789"
- "Cari postingan di X tentang peluncuran kami selama seminggu terakhir dan kelompokkan berdasarkan tema."
- "Apa balasan orang terhadap postingan ini? Tunjukkan keberatan yang sering muncul."
- "Ubah utas ini menjadi Markdown untuk Obsidian dan simpan sebagai catatan."
- "Apa yang sedang tren di Jepang saat ini?"
- "Berapa sisa kredit TwitterViewer saya?"

Agen dapat menggabungkan alat-alat tersebut. Dalam tugas riset, agen mungkin mencari postingan, mengonversi tiga utas paling relevan, membaca balasan di bawah salah satunya, lalu menulis ringkasan. Setiap langkah merupakan panggilan alat tersendiri dan biayanya dihitung berdasarkan jumlah postingan yang dikembalikan, sehingga Anda dapat melihat biayanya melalui `get_credits` setelahnya.

Jika Anda hanya perlu membaca satu utas sekali saja, halaman [X ke Markdown](https://twitterviewer.app/id/x-to-markdown) dapat melakukan hal yang sama di browser, dan [Pembaca utas Twitter](https://twitterviewer.app/id/twitter-thread-reader) menampilkan utas dalam satu halaman. Server MCP ditujukan bagi agen yang perlu melakukannya sendiri.

## Alur kerja yang menggunakan server MCP untuk Twitter

Menjawab pertanyaan satu per satu itu mudah. Manfaat server lebih terasa saat agen merangkai beberapa alat menjadi alur kerja sederhana. Ada tiga pola yang sering digunakan.

**Menyaring daftar bacaan.** Anda menempelkan sepuluh tautan X ke percakapan dan menanyakan mana yang layak dibaca. Agen memanggil `convert_x_url` untuk setiap tautan dengan `scope` diatur ke `thread` dan `stats` dinonaktifkan agar teks tetap ringkas, lalu mengurutkannya berdasarkan seberapa banyak informasi tambahan yang diberikan masing-masing. Sembilan dari sepuluh tautan mungkin hanya berisi satu postingan, sehingga biayanya sering kali mendekati sepuluh kredit.

**Riset topik.** Anda meminta agen mencari tahu pendapat orang tentang sebuah produk. Agen menggunakan `search_x_posts` dengan beberapa operator, mengonversi dua atau tiga utas terbaik, membaca balasan di bawah postingan yang paling banyak dibahas dengan `get_x_replies`, lalu menulis laporan singkat dengan tautan ke sumbernya. Biaya kreditnya sesuai jumlah postingan yang benar-benar dibaca, yang dapat dilihat melalui `get_credits` setelahnya.

**Menyimpan catatan.** Anda meminta sebuah utas dijadikan catatan Obsidian. Agen memanggil `convert_x_url` dengan format `obsidian`, yang menambahkan frontmatter berisi penulis, tanggal, dan tautan sumber, lalu menulis berkas ke vault Anda. Hasilnya sama dengan halaman [X ke Markdown](https://twitterviewer.app/id/x-to-markdown), tanpa perlu meninggalkan percakapan.

Dua kebiasaan membantu menjaga biaya alur kerja ini tetap rendah. Mintalah utas alih-alih profil kecuali Anda memang membutuhkan postingan terbaru, karena profil berisi 200 postingan menghabiskan 200 kredit. Minta juga agen berhenti dan bertanya sebelum mengonversi lebih dari beberapa utas panjang agar penggunaan saldo tetap dalam kendali Anda.

## Kredit dan batas penggunaan

Kredit bekerja sama seperti pada REST API. Satu kredit setara dengan satu postingan yang dikembalikan. Detail penulis gratis. Panggilan yang gagal, hasil kosong, atau PDF yang gagal dirender tidak dikenai biaya. Akun gratis mendapat 50 kredit satu kali, paket berbayar menambahkan 3.000, 8.000, atau 25.000 kredit per bulan, dan paket tambahan berisi 1.000, 6.000, serta 20.000 kredit masing-masing berharga $5, $20, dan $50 tanpa masa kedaluwarsa. Lihat pilihan paket di halaman [Harga](https://twitterviewer.app/id/pricing).

Jumlah panggilan dibatasi per akun per menit: 10 untuk akun gratis, 30 untuk Plus, 60 untuk Pro, dan 300 untuk Business. Jika agen menjalankan proses berulang, batas ini juga membantu melindungi saldo. Saat kredit habis, alat tidak menampilkan deretan detail kesalahan teknis: alat memberikan jawaban satu baris beserta tautan ke halaman harga, yang dapat diteruskan agen kepada Anda.

Data memiliki batasan yang sama dengan API. Hanya postingan publik yang tersedia, sehingga akun privat, postingan terlindungi, pesan langsung, postingan yang dihapus, dan akun yang ditangguhkan tidak memberikan hasil yang berguna. Konten disimpan sementara dalam cache, sekitar dua menit untuk sebuah postingan, sehingga perubahan yang sangat baru mungkin belum terlihat.

## Dirancang hanya untuk membaca

Banyak orang khawatir memberi agen akses ke akun media sosial, dan alasannya masuk akal: agen dengan izin menulis dapat membuat postingan tanpa sengaja. Server MCP untuk Twitter ini menghindari masalah tersebut. Tidak ada alat untuk membuat postingan, membalas, menyukai, memposting ulang, mengikuti, memblokir, atau mengirim pesan, dan server tidak pernah meminta kata sandi atau token X Anda. Hal terburuk yang dapat dilakukan agen yang salah memahami instruksi adalah menghabiskan kredit untuk membaca, dan itu pun dibatasi oleh batas laju serta saldo Anda.

Pencarian adalah satu-satunya fitur yang melibatkan akun X, karena X hanya menampilkan hasil pencarian kepada pengguna yang sudah masuk. Fitur ini menggunakan akun X yang Anda hubungkan sendiri pada paket Pro atau Business, hanya untuk permintaan yang dibuat Anda atau agen Anda, dan Anda dapat memutuskan koneksinya kapan saja.

## Server MCP untuk Twitter, API, CLI, atau penggantian domain: mana yang dipilih?

Keempat cara akses ini menggunakan satu saldo yang sama, jadi pilih berdasarkan tempat Anda bekerja.

- **Server MCP:** paling cocok saat asisten seperti Claude, Cursor, atau Codex perlu menentukan sendiri kapan harus membaca X. Tanpa kode dan tanpa menyalin-tempel.
- **REST API:** paling cocok untuk skrip, alur pemrosesan, dan aplikasi yang Anda tulis. Lihat halaman [API Twitter](https://twitterviewer.app/id/twitter-api).
- **Alat baris perintah:** `npx twitterviewer <link>` untuk konversi cepat di terminal atau skrip shell.
- **Penggantian domain:** ganti `x.com` dengan `twitterviewer.app` dalam tautan dan kirimkan kunci Anda; hasilnya berupa Markdown.

Agent Skill di `/.well-known/agent-skills/twitterviewer/SKILL.md` dapat mengajarkan agen memilih di antara cara-cara tersebut saat menemukan tautan X.

## Mengatasi masalah server MCP untuk Twitter

Jika server tidak dapat terhubung, periksa hal-hal berikut terlebih dahulu.

- **Aplikasi menyatakan tidak dapat menjangkau server.** Pastikan URL-nya persis `https://twitterviewer.app/mcp`. Aplikasi yang hanya mendukung server lokal memerlukan perantara; Claude Code, Claude, Cursor, dan Codex dapat terhubung langsung ke server jarak jauh.
- **Proses masuk melalui browser terus berulang.** Selesaikan proses masuk di profil browser yang sama dengan yang dibuka aplikasi, dan pastikan Anda masuk ke akun yang ingin dibebani biaya.
- **Alat memberi tahu bahwa kredit habis.** Periksa `get_credits`, lalu beli paket tambahan di halaman harga atau tunggu hingga jatah bulanan diisi ulang.
- **Pencarian ditolak.** Pencarian memerlukan Pro atau Business serta akun X yang terhubung. Hubungkan akun tersebut di halaman Akun X pada pengaturan Anda.
- **Tautan tidak memberikan hasil.** Postingan mungkin sudah dihapus atau dilindungi, atau akunnya ditangguhkan. Buka tautan di [Penampil Profil Twitter](https://twitterviewer.app/id/twitter-profile-viewer) untuk melihat konten yang tersedia secara publik.
- **Muncul pesan batas laju.** Tunggu sesuai jumlah detik yang disebutkan, atau beralih ke paket dengan batas per menit yang lebih tinggi.

## Pertanyaan umum tentang Server MCP Twitter

### Apa itu server MCP untuk Twitter?

Server MCP untuk Twitter adalah server yang memungkinkan asisten AI membaca X melalui Model Context Protocol. Versi TwitterViewer berjalan dari jarak jauh, hanya dapat membaca, dan mengembalikan Markdown, sehingga agen dapat membaca utas, mencari postingan, membaca balasan, serta memeriksa tren dari dalam Claude, Cursor, atau Codex.

### Apakah ini server MCP X resmi?

Tidak. Ini adalah layanan independen dan tidak berafiliasi dengan X Corp. Layanan ini hanya membaca postingan publik dan tidak dapat membuat postingan, menyukai, mengikuti akun, atau mengirim pesan.

### Bagaimana cara menambahkan server MCP untuk Twitter ke Claude Code?

Jalankan `claude mcp add --transport http twitterviewer https://twitterviewer.app/mcp`, lalu buka `/mcp` di dalam Claude Code dan masuk melalui browser saat pertama kali menggunakannya. Setelah itu, minta asisten membaca tautan X.

### Apakah bisa digunakan dengan Cursor dan Codex?

Ya. Di Cursor, tambahkan URL di bawah `mcpServers` dalam `mcp.json`. Di Codex, tambahkan blok `[mcp_servers.twitterviewer]` yang berisi URL tersebut. Keduanya dapat menggunakan proses masuk melalui browser atau kunci API sebagai token Bearer.

### Apakah saya memerlukan kunci API?

Tidak. Anda dapat masuk melalui browser tanpa kunci. Kunci berguna di lingkungan tanpa browser, seperti server dan CI, dan Anda dapat membuatnya di halaman API.

### Apa saja yang bisa dilakukan alat-alatnya?

Ada lima alat: `convert_x_url`, `search_x_posts`, `get_x_replies`, `get_x_trends`, dan `get_credits`. Semuanya hanya dapat membaca. Alat-alat ini mengonversi tautan, mencari postingan publik, membaca balasan, menampilkan tren, dan menunjukkan saldo Anda.

### Berapa biaya penggunaannya?

Layanan ini menggunakan kredit yang sama dengan API: satu kredit per postingan yang dikembalikan, sedangkan detail penulis dan panggilan yang gagal gratis. Akun gratis mendapat 50 kredit satu kali, dan paket berbayar menambahkan 3.000, 8.000, atau 25.000 kredit per bulan. Paket kredit tambahan berharga $5, $20, dan $50 tanpa masa kedaluwarsa.

### Bisakah agen membuat postingan atau memberi suka untuk saya?

Tidak. Server ini tidak memiliki alat yang dapat menulis ke X. Server tidak dapat membuat postingan, membalas, menyukai, memposting ulang, mengikuti akun, atau mengirim pesan, dan tidak pernah meminta kata sandi X Anda.

### Mengapa pencarian memerlukan Pro atau Business?

X hanya menampilkan hasil pencarian kepada pengguna yang sudah masuk, sehingga pencarian memerlukan akun X. Fitur ini tersedia dalam paket Pro dan Business dan menggunakan akun yang Anda hubungkan sendiri.

### Bisakah saya menggunakan server MCP untuk Twitter untuk akun privat?

Tidak. Hanya konten publik yang tersedia. Akun privat, postingan terlindungi, pesan langsung, dan postingan yang dihapus tidak dikembalikan.