Dokumentasi Developer
MCP
Hubungkan Claude, Codex, dan klien MCP lainnya ke catatan Alt Anda.
Alt menyediakan server MCP (Model Context Protocol) yang dihosting. Klien yang mendukung OAuth dapat terhubung melalui login browser; API key tetap tersedia sebagai fallback. Keduanya menerapkan scope baca-saja dan batas workspace yang sama.
Mulai dari sini
Jalankan panduan interaktif di folder proyek. Panduan ini membantu menghubungkan MCP, memeriksa kunci API dan webhook, lalu menyerahkan implementasi ke agen pemrograman.
npx altalt --mcp-onlyHubungkan dengan konektor Claude
Alt terdaftar di direktori konektor Claude, sehingga umumnya Anda tidak perlu menyentuh endpoint di bawah. Di Claude, buka Customize → Connectors, cari Alt, lalu pilih Connect.
- Setujui akses di layar persetujuan milik Alt, dan pilih satu ruang kerja yang boleh dibaca konektor — catatan pribadi Anda, atau satu team space.
- Tidak ada yang perlu ditempel dan tidak perlu membuat API key. Claude mendaftar sendiri lewat OAuth.
- Memerlukan akun Alt dengan paket berbayar. Akun gratis tetap sampai ke layar persetujuan, tetapi menerima galat
plan_requiredsaat menyetujui. - Hanya-baca secara desain: menampilkan daftar dan mencari catatan serta membaca transkrip dan ringkasan, tidak pernah menulis. Dapat dicabut kapan saja di konsol akun.
1. Hubungkan dengan OAuth (disarankan)
Tambahkan endpoint tanpa header. Klien Anda menemukan server otorisasi Alt, mendaftarkan dirinya, lalu membuka layar persetujuan di browser.
- Alt mendukung Dynamic Client Registration dan PKCE, sehingga klien yang kompatibel mengatur OAuth secara otomatis.
- Tinjau scope baca-saja dan workspace yang diminta di browser sebelum menyetujui akses.
- Menghubungkan memerlukan akun Alt dengan paket berbayar. Akun gratis tetap sampai ke layar persetujuan, tetapi menerima galat
plan_requiredsaat menyetujui.
2. Hubungkan klien Anda
Gunakan konfigurasi yang hanya berisi URL untuk OAuth. OAuth client ID atau secret tidak diperlukan; gunakan API key hanya jika klien tidak dapat menyelesaikan OAuth.
https://mcp.altalt.io/mcpClaude / Claude Desktop / Cowork
Gunakan konektor khusus hanya untuk menjangkau lingkungan Alt lain: buka Customize → Connectors → Add custom connector, masukkan endpoint di atas, dan biarkan OAuth client ID serta secret kosong.
Claude Code
claude mcp add --transport http alt https://mcp.altalt.io/mcpSetelah menambahkan server, buka /mcp di Claude Code, pilih Alt, lalu selesaikan autentikasi di browser.
Codex CLI
codex mcp add alt --url https://mcp.altalt.io/mcp
codex mcp login alt# ~/.codex/config.toml
[mcp_servers.alt]
url = "https://mcp.altalt.io/mcp"Menambahkan server biasanya sekaligus menyelesaikan autentikasi di browser. Jika autentikasi tidak dimulai, jalankan codex mcp login alt.
Cursor
Tambahkan ke CursorInstalasi sekali klik dengan URL saja. Di pengaturan MCP Cursor, pilih Connect atau Needs authentication lalu setujui layar persetujuan di browser.
Klien lain dan fallback API key
Mulai dengan konfigurasi OAuth yang hanya berisi URL. Jika klien tidak mendukung MCP OAuth, gunakan konfigurasi Bearer API key.
{
"mcpServers": {
"alt": {
"url": "https://mcp.altalt.io/mcp"
}
}
}{
"mcpServers": {
"alt": {
"url": "https://mcp.altalt.io/mcp",
"headers": { "Authorization": "Bearer alt_live_..." }
}
}
}API key tetap didukung untuk otomatisasi dan klien lama. Buat key di konsol akun, berikan hanya scope yang diperlukan, jangan simpan di konfigurasi bersama, dan lihat Keamanan untuk pengelolaannya.
3. Tools
Tujuh tool baca-saja yang menerapkan scope yang sama dengan REST API.
list_notes— Daftar catatan yang dapat dibaca koneksi ini, dengan pagination kursor. Bawaannya pembaruan terlama lebih dulu; gunakanorder=newest_firstuntuk yang terbaru lebih dulu. Filter denganupdated_after, waktu akhir rekaman (ended_after/ended_before),channel_id, ataufolder_id(notes:read).get_note— Ambil metadata satu catatan: judul, status transkrip/ringkasan, stempel waktu (notes:read).get_note_transcript— Ambil transkrip lengkap sebagai segmen berwaktu dengan label pembicara (transcripts:read).get_note_summary— Ambil ringkasan AI sebagai Markdown (summaries:read).search_notes— Cari catatan yang judul, transkrip, atau ringkasannya memuat kata atau frasa. Hasil di transkrip menyertakan waktu dan pembicara. Transkrip dan ringkasan hanya dicari bila adatranscripts:read/summaries:read(notes:read).list_folders— Daftar folder yang dapat dibaca koneksi ini. Id folder dapat dipakai sebagaifolder_iddilist_notes(notes:read).get_account_info— Menampilkan akun Alt pemilik koneksi, apakah koneksi membaca catatan pribadi, satu channel, atau seluruh workspace, serta channel yang dapat dibaca dan izinnya. Berguna saat catatan yang diharapkan tidak muncul (notes:read).
Catatan muncul setelah rekaman berakhir atau ringkasan dibuat — catatan memo saja tidak diekspor. Sebelum konten siap, tools mengembalikan transcript_not_ready / summary_not_ready agar agen tahu untuk mencoba lagi nanti.