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
npx altalt --mcp-only

Hubungkan 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_required saat 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.
Lihat di direktori konektor

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_required saat 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.

MCP URL
https://mcp.altalt.io/mcp

Claude / 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

shell
claude mcp add --transport http alt https://mcp.altalt.io/mcp

Setelah menambahkan server, buka /mcp di Claude Code, pilih Alt, lalu selesaikan autentikasi di browser.

Codex CLI

shell
codex mcp add alt --url https://mcp.altalt.io/mcp
codex mcp login alt
config.toml
# ~/.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 Cursor

Instalasi 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.

OAuth
{
  "mcpServers": {
    "alt": {
      "url": "https://mcp.altalt.io/mcp"
    }
  }
}
API key
{
  "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; gunakan order=newest_first untuk yang terbaru lebih dulu. Filter dengan updated_after, waktu akhir rekaman (ended_after / ended_before), channel_id, atau folder_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 ada transcripts:read / summaries:read (notes:read).
  • list_folders — Daftar folder yang dapat dibaca koneksi ini. Id folder dapat dipakai sebagai folder_id di list_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.