Hubungkan lewat MCP

Anthra mendukung Model Context Protocol melalui Streamable HTTP di /api/mcp. Ada dua cara untuk terhubung:

OAuth — untuk Claude.ai, ChatGPT, dan klien lain yang menambahkan server lewat URL. Tempel https://anthra.com/api/mcp, masuk ke Anthra, lalu setujui permintaannya. Tidak ada kunci yang perlu disalin.
Kunci API — untuk file konfigurasi Cursor, Claude Code, Claude Desktop, dan skrip. Kirim salah satu token akses pribadi Anda sebagai header Bearer.

Endpoint

URL:    https://anthra.com/api/mcp
Method: POST (JSON-RPC)
Auth:   OAuth 2.1 (discovered automatically), or
        Authorization: Bearer ant_live_…
Protocol revision: 2025-06-18

Hubungkan dengan OAuth (Claude.ai, ChatGPT)

Di Claude.ai: Settings → Connectors → Add custom connector. Di ChatGPT: aktifkan mode pengembang, lalu tambahkan konektor di Settings → Connectors. Gunakan URL ini:

https://anthra.com/api/mcp

Klien membuka halaman Anthra yang menyebutkan nama aplikasi dan mencantumkan apa saja yang dimintanya. Masuk jika perlu, periksa izinnya, lalu pilih Izinkan. Apa pun yang dihasilkan aplikasi itu dibebankan ke kredit Anda, persis seperti di studio.

Jika klien tidak meminta izin tertentu, klien mendapat books:read, books:write, generation:run, dan account:read. Penerbitan (publish:write) dan analitik pembaca harus diminta secara khusus oleh klien. Token akses berlaku satu jam dan diperbarui otomatis hingga 30 hari tanpa aktivitas. Untuk memutus akses aplikasi, buka Akun → Kunci API lalu pilih Putuskan di bagian Aplikasi terhubung.

Untuk pengembang klien: penemuan dimulai dari header WWW-Authenticate pada respons 401, yang menunjuk ke /.well-known/oauth-protected-resource (juga tersedia di /.well-known/oauth-protected-resource/api/mcp). Metadata server otorisasi ada di /.well-known/oauth-authorization-server. Anthra mendukung pendaftaran klien dinamis, grant authorization-code dengan PKCE (hanya S256), refresh token yang berotasi, pencabutan token, dan parameter resource, yang harus bernilai https://anthra.com/api/mcp. URI pengalihan harus https, http di localhost / 127.0.0.1, atau skema privat aplikasi native (mis. cursor://…, vscode://…), dan dicocokkan persis.

Hubungkan dengan kunci API

Buat kunci di Akun → Kunci API dengan cakupan yang Anda inginkan, lalu tambahkan ke klien Anda seperti di bawah ini.

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) atau file yang setara di OS Anda:

{
  "mcpServers": {
    "anthra": {
      "url": "https://anthra.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ant_live_…"
      }
    }
  }
}

Mulai ulang Claude Desktop. Anda akan melihat anthra muncul di daftar alat dengan entri seperti create_book, generate_outline, write_chapter, dan publish_book.

Claude Code

claude mcp add --transport http anthra \
  https://anthra.com/api/mcp \
  --header "Authorization: Bearer ant_live_…"

Cursor

Di pengaturan Cursor → Tools & Integrations → Add MCP Server:

{
  "mcpServers": {
    "anthra": {
      "url": "https://anthra.com/api/mcp",
      "headers": { "Authorization": "Bearer ant_live_…" }
    }
  }
}

Yang bisa dilakukan model

Server MCP Anthra setara penuh dengan agen menulis di dalam aplikasi Anthra — perangkat yang sama, tersedia lewat MCP. Model akan:

Menampilkan, membaca, membuat, memperbarui, dan menghapus buku, bab, dan kolaborator (books:read, books:write).
Menjalankan permukaan perencanaan — pernyataan tema, janji kepada pembaca, penulis pembanding, beat sheet, penguncian POV / kala, tokoh dengan keinginan / ketakutan / kebohongan, konflik antartokoh, wawancara premis, usulan premis, penilai kerangka, varian kerangka, deteksi genre, riset era, referensi suasana, snapshot kerangka.
Mengelola pedoman penulis — tokoh, kerangka plot, kerangka tema, panduan gaya, pembangunan dunia, glosarium, sinopsis, lore, bible latar, riset era. Membaca, menulis, membuat draf otomatis, dan mengembalikan lewat revisi.
Membuat kerangka, menulis bab, menulis ulang dengan arahan, menjalankan pemeriksaan kesinambungan / klise / pengulangan / pergeseran gaya / keterbacaan lisan / sensitivitas, dan menyintesis narasi (generation:run).
Menjalankan rangkaian lengkap analisis prosa — kata penyaring, kepadatan kata keterangan, keseimbangan indra, kata benda konkret, POV yang tergelincir, konsistensi kala, ritme kalimat, tag dialog, bahasa tubuh, klise semantik, telegrafi, dan pengulangan — lalu menerapkan perbaikannya (variasi irama, penulisan ulang show-don't-tell, peningkatan kata kerja).
Mengumpulkan panel spesialis / kritik — memanggil spesialis tertentu, menjalankan diskusi meja bundar kritik, memverifikasi klaim secara skeptis, menyintesis sebagai Pemimpin Redaksi, menjalankan turnamen draf, dokter alur jangka panjang, pencarian pakar genre, dan pembacaan oleh pembaca pemula.
Mengumpulkan masukan pembaca — panel pembaca uji, peta busur emosi, dan penilaian hook / akhir cerita yang membaca buku seperti pembaca pertama kali.
Merawat pembangunan dunia & kesinambungan — aturan dunia, pemeriksaan linimasa / geografi / cuaca / waktu tempuh, konsistensi satuan, istilah & kalender rekaan, buku catatan foreshadowing, pelacak objek & lokasi, pemeriksaan konsistensi adegan, dan diff kesinambungan.
Mempertajam penggarapan tokoh — daftar keinginan / ketakutan / kebohongan dan matriks konflik, ditambah sidik jari dialog, konsistensi suara per tokoh, dan pelacakan busur tokoh.
Melakukan penyuntingan persona & struktur — suntingan lacak perubahan dengan persona editor bawaan atau tersimpan, varian kalimat, pembalikan kala / POV, transplantasi suara, pemangkasan per persen, perluasan, kerangka terbalik, kartu adegan, dan sinopsis — masing-masing masuk sebagai saran yang bisa ditinjau untuk Anda terima atau tolak.
Menilai dengan kartu skor & contoh evaluasi, dan memilah kotak ide (tangkap / atur / status).
Berkolaborasi — mengelola kolaborator, membagikan tugas bab, dan membaca umpan aktivitas untuk buku dengan banyak penulis.
Sampul & produksi — memilih warna sampul, membuat gambar sampul / sampul belakang / punggung / bab, menyusun bentangan sampul melingkar siap cetak, merender naskah ke EPUB / DOCX / PDF, mengekspor ke Markdown, menarasikan semua bab sekaligus, dan menerjemahkan buku ke bahasa lain.
Restrukturisasi bab — menampilkan, mengedit, memecah, menggabungkan, mengurutkan ulang bab, dan mengembalikan ke revisi tersimpan mana pun.
Menampilkan katalog suara narasi (list_voices) untuk memilih suara sebelum memulai narasi.
Menerbitkan buku dan mengubah visibilitas (publish:write).
Membaca pemakaian akun, status tugas latar belakang, dan analitik pembaca (account:read, analytics:read).

Alat yang mengubah data atau memakai token dikunci di balik cakupannya — kunci atau aplikasi terhubung tanpa generation:run tetap bisa membiarkan model menampilkan dan membaca buku Anda, tetapi tidak mengizinkan pembuatan.

Persempit daftar alat

Seluruh permukaan berisi lebih dari 300 alat, dan banyak klien bekerja lebih baik dengan lebih sedikit alat. Tambahkan ?toolset= ke URL endpoint untuk menampilkan beberapa kategori saja, misalnya https://anthra.com/api/mcp?toolset=core,production,webhooks. Kategorinya adalah core, extended, production, parity, dan webhooks. core saja sudah cukup untuk menyusun buku secara manual. Kategori yang tidak dikenal diabaikan.

Cakupan yang disarankan untuk klien khusus chat

books:read
books:write
generation:run
publish:write

Tambahkan account:read dan analytics:read jika Anda ingin model mempertimbangkan pengeluaran atau perilaku pembaca.

Lihat referensi alat lengkap untuk setiap operasi, argumennya, dan cakupan yang dibutuhkan.