Cara menggunakan server MCP Postoria

Server MCP Postoria memungkinkan alat AI yang kompatibel dengan MCP membuat dan mengelola postingan di Postoria melalui Postoria Public API.

Anda dapat terhubung ke Postoria dengan dua cara:

  1. Server MCP npm lokal — berjalan di komputer Anda dan menggunakan kunci Postoria Public API Anda.
  2. Endpoint MCP yang dihosting Postoria — berjalan di infrastruktur Postoria pada https://mcp.postoria.io/mcp dan mendukung login OAuth atau autentikasi kunci Public API, bergantung pada dukungan klien MCP Anda.

Server MCP dapat membantu alat AI menampilkan daftar ruang kerja, menemukan akun sosial dan antrean, mengimpor atau mengunggah media, menerbitkan postingan, menjadwalkan postingan, menambahkan postingan ke antrean, menampilkan postingan yang sudah ada, memeriksa status postingan, dan menghapus postingan di Postoria.

Dukungan MCP bergantung pada alat AI yang Anda gunakan. Alat yang kompatibel dengan MCP dapat mencakup Claude Desktop, Cursor, Claude Code, dan aplikasi kustom ChatGPT jika koneksi MCP kustom tersedia.

Sebelum memulai

Berikut hal-hal utama yang perlu Anda ketahui sebelum menggunakan server MCP Postoria:

  • Akses server MCP tersedia pada paket Pro dan Agency.
  • Server MCP menggunakan Postoria Public API di balik layar.
  • Server MCP npm lokal memerlukan kunci Postoria Public API.
  • Endpoint MCP yang dihosting Postoria dapat menggunakan login OAuth ketika klien MCP mendukung penemuan OAuth.
  • Endpoint MCP yang dihosting Postoria juga dapat menerima kunci Postoria Public API sebagai token bearer.
  • Kunci Public API berlaku di tingkat akun, bukan di tingkat ruang kerja.
  • Penggunaan lokal dapat mengunggah file lokal dari komputer Anda ketika klien MCP mendukung akses file.
  • Endpoint MCP yang dihosting Postoria tidak mengharuskan Anda memasang paket npm secara lokal.

Anda juga dapat membaca artikel bantuan Postoria Public API untuk pengaturan kunci API dan perilaku API.

Memilih penggunaan lokal atau yang dihosting

Pilih metode koneksi yang sesuai dengan klien MCP Anda.

Server MCP npm lokal

Gunakan server MCP npm lokal ketika klien Anda yang kompatibel dengan MCP dapat menjalankan perintah lokal.

Konfigurasi ini umum untuk alat desktop dan IDE seperti Claude Desktop, Cursor, dan Claude Code.

Dalam mode lokal:

  • Server MCP berjalan di komputer Anda melalui paket npm.
  • Kunci Postoria Public API Anda disediakan melalui konfigurasi lokal klien MCP.
  • Unggahan file lokal dapat berjalan ketika klien MCP mengizinkan server MCP mengakses jalur file lokal.

Paket npm-nya adalah:

@postoria/mcp-server

Perintah lokalnya adalah:

npx -y @postoria/mcp-server

Endpoint MCP yang dihosting Postoria

Gunakan endpoint MCP yang dihosting Postoria ketika klien Anda yang kompatibel dengan MCP dapat terhubung ke server MCP yang dihosting.

Dalam mode yang dihosting:

  • Anda tidak perlu memasang paket npm secara lokal.
  • Klien MCP terhubung ke https://mcp.postoria.io/mcp.
  • Klien yang mendukung OAuth dapat memandu Anda untuk masuk ke Postoria.
  • Klien yang mendukung token bearer dapat menggunakan kunci Postoria Public API.

Endpoint MCP yang dihosting Postoria adalah:

https://mcp.postoria.io/mcp

Membuat kunci Public API

Buat kunci Public API untuk server MCP npm lokal atau untuk koneksi ke endpoint MCP yang dihosting dengan autentikasi token bearer.

Alur login OAuth untuk endpoint MCP yang dihosting Postoria tidak menggunakan kunci Public API.

Untuk membuat kunci Public API:

  1. Buka Postoria.
  2. Buka Pengaturan.
  3. Temukan bagian Public API, server MCP, dan integrasi n8n.
  4. Klik Buat kunci API.
  5. Salin kunci dan simpan dengan aman.

Postoria hanya menampilkan kunci API lengkap sekali. Setelah menutup dialog, Anda hanya akan melihat awalan kunci tersebut.

Jika Anda kehilangan kunci, cabut kunci tersebut dan buat yang baru.

Konfigurasi klien MCP lokal

Konfigurasi yang tepat bergantung pada klien MCP Anda.

Untuk klien yang mendukung konfigurasi server MCP bergaya JSON, gunakan paket dengan kunci API Postoria dalam variabel lingkungan.

Contoh:

{
  "mcpServers": {
    "postoria": {
      "command": "npx",
      "args": ["-y", "@postoria/mcp-server"],
      "env": {
        "POSTORIA_API_KEY": "pst_live_your_postoria_api_key_here"
      }
    }
  }
}

Setelah menyimpan konfigurasi, mulai ulang atau muat ulang klien MCP Anda, lalu minta klien tersebut menggunakan Postoria.

Endpoint MCP yang dihosting Postoria

Untuk koneksi MCP yang dihosting, gunakan endpoint ini:

https://mcp.postoria.io/mcp

Endpoint yang dihosting mendukung dua metode autentikasi. Metode yang Anda gunakan bergantung pada klien MCP Anda.

Login OAuth

Sebagian klien MCP mendukung penemuan OAuth untuk server MCP yang dihosting. Dalam hal ini, tambahkan endpoint MCP yang dihosting Postoria ke klien MCP dan masuk ke Postoria ketika diminta.

https://mcp.postoria.io/mcp

Token bearer kunci Public API

Sebagian klien MCP mendukung token bearer kustom. Dalam hal ini, gunakan kunci Postoria Public API Anda sebagai token bearer.

Authorization: Bearer pst_live_your_postoria_api_key_here

Jika klien meminta nilai token dan secara terpisah meminta skema header, masukkan hanya kunci API sebagai nilai token dan pilih Bearer sebagai skemanya.

Jangan tempelkan kata Bearer ke kolom token kecuali klien MCP secara eksplisit meminta nilai header lengkap.

Setelah terhubung, minta klien untuk memindai atau memuat alat yang tersedia.

Alat yang tersedia

Server MCP Postoria menyediakan alat untuk alur kerja penerbitan yang umum.

Alat ruang kerja dan akun

  • list_workspaces — menampilkan daftar ruang kerja Postoria yang tersedia.
  • list_social_accounts — menampilkan daftar akun sosial dalam ruang kerja.
  • list_queues — menampilkan daftar antrean dalam ruang kerja.

Alat-alat ini membantu klien AI menemukan ID ruang kerja, akun sosial, dan antrean yang diperlukan sebelum membuat postingan.

Alat media

  • import_media_from_url — mengimpor media dari URL publik.
  • create_media_upload — membuat URL unggahan media bertanda tangan.
  • complete_media_upload — menyelesaikan unggahan media setelah byte mentah file diunggah.
  • upload_media_from_file — mengunggah file lokal dari komputer yang menjalankan server MCP lokal.
  • get_media — memeriksa status dan detail media.

Alat postingan

  • publish_post_now — langsung menerbitkan postingan.
  • schedule_post — menjadwalkan postingan untuk waktu tertentu.
  • add_post_to_queue — menambahkan postingan ke antrean.
  • list_posts — menampilkan daftar postingan dalam ruang kerja dengan filter dan paginasi opsional.
  • get_post — memeriksa status dan detail postingan.
  • delete_post — menghapus postingan di Postoria. Ini tidak menghapus konten yang sudah diterbitkan dari jejaring sosial.

Opsi media

Alur kerja media yang tepat bergantung pada lokasi file media dan dukungan klien MCP Anda.

Mengimpor media dari URL publik

Gunakan ini ketika gambar atau video sudah tersedia melalui URL publik.

Ini berguna untuk media yang disimpan di situs web, CMS, pustaka aset, atau sumber publik lainnya.

Klien AI dapat memanggil import_media_from_url, lalu memanggil get_media untuk memeriksa apakah pemrosesan telah selesai.

Mengunggah media dengan URL unggahan bertanda tangan

Gunakan ini ketika klien dapat mengunggah byte mentah file ke URL unggahan bertanda tangan.

Alurnya adalah:

  1. Panggil create_media_upload.
  2. Unggah byte mentah file ke URL unggahan yang dikembalikan menggunakan PUT.
  3. Panggil complete_media_upload.
  4. Panggil get_media untuk memeriksa status media.

Panggil complete_media_upload hanya setelah byte mentah file benar-benar selesai diunggah.

Mengunggah file lokal

Gunakan ini dalam alur kerja MCP desktop lokal ketika Anda ingin mengunggah file berdasarkan jalur lokalnya.

Klien AI dapat memanggil upload_media_from_file dengan jalur file lokal. Server MCP lokal mengunggah file ke Postoria, menyelesaikan unggahan, dan mengembalikan status media.

Contoh alur kerja

Contoh prompt sebaiknya terdengar seperti permintaan penerbitan biasa, bukan petunjuk API. Klien MCP dapat menentukan alat Postoria mana yang perlu dipanggil di balik layar.

Menemukan ruang kerja

Minta kepada klien MCP Anda:

Tampilkan ruang kerja Postoria yang dapat saya akses.

Klien seharusnya menampilkan daftar ruang kerja yang tersedia agar Anda dapat memilih tempat bekerja.

Menemukan akun sosial

Minta kepada klien MCP Anda:

Tampilkan akun sosial yang terhubung ke ruang kerja ACME Studio.

Klien seharusnya menemukan ruang kerja yang sesuai terlebih dahulu, lalu menampilkan daftar akun sosial yang terhubung agar Anda dapat memilih tempat menerbitkan.

Menerbitkan postingan teks

Minta kepada klien MCP Anda:

Terbitkan ini ke halaman LinkedIn ACME Studio: Kami baru saja menerbitkan panduan perencanaan peluncuran untuk tim kecil. Panduan ini membahas cara menjaga aset kampanye, persetujuan, dan postingan terjadwal tetap teratur sebelum hari peluncuran.

Tinjau ruang kerja, akun, dan teks postingan yang dipilih sebelum mengonfirmasi tindakan.

Menjadwalkan postingan

Minta kepada klien MCP Anda:

Jadwalkan postingan Instagram untuk ACME Studio besok pukul 10.00 menggunakan gambar yang saya lampirkan. Keterangan: Daftar periksa peluncuran yang sederhana dapat menghemat waktu berjam-jam ketika tim Anda menyiapkan konten di berbagai saluran.

Klien seharusnya menyiapkan postingan terjadwal dan menampilkan akun, media, serta waktu terjadwal yang dipilih sebelum penerbitan dikonfirmasi.

Menambahkan postingan ke antrean

Minta kepada klien MCP Anda:

Tambahkan postingan gambar ini ke antrean Weekly Tips untuk ACME Studio menggunakan gambar yang saya lampirkan. Keterangan: Gunakan satu daftar periksa peluncuran yang dapat dipakai kembali untuk setiap kampanye agar tim Anda mengetahui apa yang telah disetujui, dijadwalkan, dan siap diterbitkan.

Klien seharusnya menemukan antrean, menyiapkan postingan dengan media yang dipilih, dan menambahkannya ke antrean penerbitan yang dipilih.

Menampilkan postingan yang sudah ada

Minta kepada klien MCP Anda:

Tampilkan postingan Instagram terjadwal di ruang kerja ACME Studio.

Klien dapat menggunakan list_posts dengan filter seperti ID akun, ID antrean, status postingan, jejaring sosial, rentang tanggal, batas hasil, dan kursor paginasi.

Keamanan dan konfirmasi

Klien AI dapat membantu menyiapkan tindakan penerbitan, tetapi Anda tetap perlu meninjau detail penting sebelum menerbitkan atau menjadwalkan.

Sebelum mengonfirmasi tindakan penerbitan, periksa:

  • Ruang kerja
  • Akun sosial
  • Antrean, jika digunakan
  • Keterangan
  • Media
  • Waktu terjadwal dan zona waktu ruang kerja
  • Apakah tindakan menerbitkan sekarang atau menjadwalkan untuk nanti

delete_post menghapus postingan yang sesuai di Postoria. Tindakan ini tidak menghapus konten yang sudah diterbitkan di jejaring sosial. Gunakan hanya ketika Anda yakin postingan Postoria tersebut perlu dihapus.

Kode sumber dan paket

Server MCP Postoria tersedia sebagai sumber terbuka di GitHub:

https://github.com/postoria-app/postoria-mcp-server

Paket npm tersedia di sini:

https://www.npmjs.com/package/@postoria/mcp-server