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

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.
OAuth saat ini hanya tersedia untuk administrator Alt. Jika koneksi OAuth Alt lama tidak lagi dapat diautentikasi setelah peningkatan ini, hapus dari klien lalu tambahkan kembali satu kali.

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

Buka Customize → Connectors → Add custom connector, masukkan endpoint di atas, biarkan OAuth client ID dan secret kosong, lalu pilih Connect.

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

Empat tool baca-saja yang mencerminkan REST API dan menerapkan scope yang sama.

list_notes — Daftar catatan yang terlihat oleh key, dengan pagination kursor dan filter updated_after (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).

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.