Integrasi MCP

Jika Anda menghubungkan AI seperti Claude Code, Codex, ChatGPT, Cursor, atau Claude Desktop ke Addness (integrasi MCP), AI dapat membaca dan menulis goal, ToDo, komentar, dan lainnya di Addness.

Untuk pengguna baru: Di halaman goal orang yang baru membuat organisasi dan orang yang bergabung ke organisasi lewat undangan, ada "Siapkan Addness". Pada baris "1. Hubungkan AI Anda ke Addness" di dalamnya, tekan "Minta bantuan AI" → "Buka di Claude Code" (atau "Buka di Codex"), dan AI akan melanjutkan secara berurutan mulai dari koneksi ke Addness (→ halaman Goal). Langkah-langkah mulai dari memasang aplikasi AI ada di Pasang aplikasi AI dan hubungkan ke Addness. Artikel ini hanya menjelaskan bagian integrasi MCP.

Kirim permintaan ke AI

Cukup kirim permintaan ini ke AI yang Anda gunakan.

Tolong konfigurasikan Addness MCP（https://vt.api.addness.com/mcp）.

AI melanjutkan bagian yang bisa dikerjakannya dan hanya memandu Anda di tempat yang membutuhkan tindakan Anda. Khusus persetujuan sign-in di browser, lakukan sendiri saat AI memandu Anda ke sana.

Apa yang bisa dilakukan AI

AI mana pun yang Anda hubungkan, AI itu membaca dan menulis pohon goal yang sama di organisasi yang sama.

Jika berhenti di tengah jalan: langkah per tool

Jika penyiapan berhenti pada izin atau autentikasi, tunjukkan langkah-langkah berikut kepada AI, atau lanjutkan sendiri.

ChatGPT (plugin resmi)

Ketik “@Addness” di ChatGPT atau pilih Addness dari daftar aplikasi. Tekan “Hubungkan”, masuk ke Addness, lalu tekan “Izinkan”. Tersedia di paket Free. Perubahan memerlukan konfirmasi. Yang bisa dihubungkan hanya akun Addness yang sudah ada (Anda tidak bisa mendaftar baru dari ChatGPT).

Claude Code (terminal)

1. Tambahkan Addness MCP (dengan --scope user, agar bisa dipakai dari proyek mana pun)

claude mcp add --transport http --scope user addness https://vt.api.addness.com/mcp

1. Sign in ke Addness (saat browser terbuka, setujui dengan akun Addness Anda)

claude mcp login addness

1. Periksa koneksi (selesai jika addness muncul di daftar; Anda juga bisa memeriksanya dari /mcp di dalam Claude Code)

claude mcp list

Codex (CLI)

Anda bisa memakainya cukup dengan sign in ke Addness di browser. Membuat API key tidak diperlukan (Codex versi lama tidak mendukung OAuth, jadi perbarui ke versi terbaru sebelum menjalankannya).

1. Tambahkan Addness MCP (browser terbuka otomatis, jadi setujui dengan akun Addness Anda. Pengaturan disimpan ke ~/.codex/config.toml)

codex mcp add addness --url https://vt.api.addness.com/mcp

1. Periksa koneksi (selesai jika Auth bernilai OAuth. Jika sign-in tidak dimulai, jalankan codex mcp login addness)

codex mcp list

Cursor

1. Buka ~/.cursor/mcp.json dan tambahkan pengaturan berikut (jika Anda punya server lain, tambahkan hanya entri addness)

{
  "mcpServers": {
    "addness": {
      "url": "https://vt.api.addness.com/mcp"
    }
  }
}

1. Di Settings → Tools & MCP pada Cursor, tekan Connect untuk addness dan setujui dengan akun Addness Anda di browser

Claude Desktop

Tambahkan remote MCP bukan lewat file konfigurasi, melainkan sebagai custom connector.

1. Buka Customize → Connectors dan pilih + → Add custom connector
2. Atur nama menjadi Addness dan URL menjadi https://vt.api.addness.com/mcp lalu simpan (pada Team / Enterprise, diperlukan konfigurasi organisasi oleh Owner)
3. Tekan Connect untuk Addness dan setujui di browser (Anda bisa mengaktifkannya per percakapan dari Connectors)

Klien lain yang kompatibel dengan MCP

Klien MCP apa pun yang mendukung Streamable HTTP dan OAuth bisa terhubung.

1. Atur nama server menjadi addness dan transport menjadi Streamable HTTP
2. Tentukan https://vt.api.addness.com/mcp sebagai target koneksi
3. Sign in ke Addness dari tombol autentikasi klien; selesai setelah daftar tool berhasil diambil

Periksa apakah sudah terhubung

Minta AI: "Tampilkan daftar organisasi saya di Addness". Jika AI menjawab dengan nama organisasi tempat Anda bergabung, berarti sudah terhubung. Anda juga bisa meminta "Tampilkan ToDo saya di Addness" dan memeriksa apakah ToDo Anda ditampilkan.

Jika Anda tergabung di lebih dari satu organisasi, sebelum mulai bekerja, minta AI: "Ganti organisasi Addness ke <nama organisasi>". AI akan mengganti organisasi yang dioperasikannya (switch_organization). Jika sudah terhubung ke organisasi itu, tidak ada yang berubah. Organisasi yang sudah diganti juga tetap dipakai di percakapan berikutnya dengan AI yang sama.

Jika AI menjawab bahwa tidak ada tool Addness, atau bahwa autentikasi diperlukan, lihat Jika tidak bisa terhubung.

Untuk menyerahkannya dari layar: "Minta bantuan AI"

Alih-alih meminta dengan kata-kata, Anda juga bisa menyerahkannya dari ✦ ("Minta bantuan AI") di kanan baris goal (pada lebar ponsel, "…" baris → "Minta bantuan AI").

• Lanjutkan: AI membaca konteks goal itu dan langsung melanjutkannya
• Bertukar pikiran: AI menata bersama Anda sambil bercakap dan mengusulkan goal anak. Hanya yang Anda setujui yang dibuat
• Bertanya: Tulis apa yang ingin Anda ketahui lalu kirim, dan AI membaca goal lalu menjawab. Goal tidak diubah

Tekan "Buka di Claude Code," "Buka di Codex," atau "Buka di ChatGPT," dan AI terbuka dengan instruksi yang menyertakan URL goal dan cara melanjutkannya. Dengan "Salin instruksi," Anda bisa menempelkannya ke AI lain seperti Cursor dan menggunakannya. Jika Anda menentukan "Tempat instruksi dikirim" di "AI" pada pengaturan pribadi, AI terbuka dengan satu klik tanpa perlu memilih setiap kali. Untuk penjelasan rinci tentang apa yang terjadi, lihat halaman Goal.

Perbedaan dengan API integrasi eksternal

Integrasi MCP membuat AI Anda membaca dan menulis di Addness atas nama akun Anda yang sedang masuk. Jika sistem Anda hanya perlu membaca anggota dan to-do hari ini organisasi Anda, gunakan API integrasi eksternal (hanya baca) yang dipanggil dengan kunci yang terikat pada organisasi. Kunci integrasi eksternal tidak dapat dipakai di MCP. API ini hanya tersedia untuk organisasi yang diaktifkan oleh Addness.

Jika tidak bisa terhubung

Berikut kendala yang sering terjadi dan cara mengatasinya. Cara memasang aplikasi AI dan menghubungkannya ada di Pasang aplikasi AI dan hubungkan ke Addness.

Tool Addness tidak bisa dipakai

• Sudah dihubungkan, tetapi AI bilang tidak ada tool Addness: Di komputer, di Claude Code atau Codex, Tepat setelah dihubungkan, tool belum terlihat sampai aplikasi AI dibuka ulang. Tutup aplikasi, buka lagi, pilih percakapan yang sama, lalu kirim "lanjutkan". Menutup jendela saja belum menutup aplikasinya. Di Mac, tutup dengan Command + Q. Di Windows, tutup dengan Alt + F4, dan jika ikonnya masih ada di kanan bawah layar, klik kanan ikon itu lalu pilih "Keluar". Di terminal, tekan Ctrl + C dua kali untuk keluar, lalu kembali ke percakapan yang sama dengan claude --resume (untuk Codex, codex resume)
• Setelah dibuka ulang, AI tetap bilang tidak ada: Claude Code terkadang baru memuat tool Addness saat akan memakainya. Katakan kepada AI: "Cari tool Addness lalu gunakan"
• AI meminta izin setiap kali memakai tool, lalu berhenti: Minta AI: "Atur agar tool Addness bisa dipakai tanpa konfirmasi setiap kali". Di Claude Code, mcp__addness akan masuk ke daftar izin di file pengaturan (~/.claude/settings.json)
• Anda melepas tool Addness untuk mengosongkan konteks: Selama dilepas, AI tidak bisa membaca goal maupun to-do Anda di Addness. Saat bekerja dengan Addness, biarkan tetap terhubung. Jika sudah dilepas, minta AI "Aktifkan kembali tool Addness", lalu buka ulang aplikasinya
• Addness tidak muncul di Claude atau ChatGPT di browser: Hubungkan Addness melalui plugin resmi di ChatGPT atau konektor kustom di Claude versi browser. Lihat Gunakan Addness hanya di ponsel.

Login tidak berlanjut, atau koneksi terputus

• Layar login tidak terbuka: Minta AI: "Mulai login ke Addness dan tampilkan URL-nya". Tempel URL yang ditampilkan ke browser, buka, lalu tekan "Izinkan". Jika layar "Izinkan" tidak muncul atau browser lain yang terbuka, lihat "Jika tidak berhasil" di Pasang aplikasi AI dan hubungkan ke Addness
• Sudah menekan "Izinkan", tetapi muncul error: Jika layar login dibiarkan terbuka cukup lama, muncul error seperti "Kode otorisasi tidak dapat dibuat". Minta AI memulai login lagi, lalu segera tekan "Izinkan" di layar yang terbuka
• Dulu bisa dipakai, tetapi sekarang harus login lagi atau terus diminta login: Koneksi ke Addness berakhir setelah 90 hari. Koneksi terputus lebih cepat dari 90 hari dalam kasus berikut. Jika Anda menghubungkan ulang dari aplikasi AI yang sama, koneksi sebelumnya dari aplikasi itu terputus. Satu orang bisa punya hingga 20 koneksi; jika lebih, koneksi yang paling lama tidak dipakai terputus lebih dulu (jika Anda memakai banyak komputer atau AI, koneksi lama bisa terputus karena ini). Minta AI "Login ulang ke Addness", lalu tekan "Izinkan" di browser
• Akun kantor dan akun pribadi tertukar: AI terhubung ke akun yang tertulis "Masuk sebagai …" di layar "Hubungkan ke Addness MCP". Sebelum menekan "Izinkan", periksa alamat emailnya. Jika Anda terhubung dengan akun yang salah, login ulang ke Addness di browser dengan akun yang benar, lalu minta AI "Login ulang ke Addness"

Terhubung ke organisasi lain

• AI bilang target tidak ditemukan, atau membaca goal dari organisasi lain: Organisasi yang terhubung ke AI adalah organisasi yang sedang Anda pilih di Addness di browser saat menekan "Izinkan". Jika Anda tergabung di lebih dari satu organisasi, minta AI "Ganti organisasi Addness ke <nama organisasi>". Saat memberikan URL goal pun, ganti dulu ke organisasi tempat goal itu berada, baru minta

Berhenti di Windows

• Proses menghubungkan dengan Codex berhenti di tengah jalan, atau permintaan dari ponsel berhenti: Memasang aplikasi Codex saja terkadang belum membuat perintah codex bisa dipakai di komputer. Di Windows, pernah ada kasus yang penyebabnya ini. Minta AI: "Periksa apakah perintah codex bisa dipakai, dan pasang jika belum bisa". Jika Codex tidak terbuka saat Anda menekan "Buka di Codex", tekan "Salin instruksi", tempelkan ke Codex, lalu kirim
• Di Codex untuk Windows, login ke Addness tidak selesai: Perbarui Codex ke versi terbaru, lalu login lagi. Jika tetap tidak selesai, Anda juga bisa menghubungkannya dengan Claude Code

<a id="mobile-only"></a>

Gunakan Addness hanya di ponsel

• Aplikasi ChatGPT: Ketik “@Addness” di ChatGPT atau pilih Addness dari daftar aplikasi. Tekan “Hubungkan”, masuk ke Addness, lalu tekan “Izinkan”.
• Aplikasi Claude: Di Safari, buka claude.ai → Sesuaikan → Konektor → ＋Tambah → Tambahkan konektor kustom → Nama Addness dan URL https://vt.api.addness.com/mcp → Hubungkan dan izinkan. Aktifkan Addness di aplikasi Claude, tempel instruksi, lalu kirim.
• Lanjutkan di komputer: Ikuti Permintaan dari ponsel tidak sampai untuk mengirim pekerjaan ke AI di komputer Anda.

<a id="phone-pc-relay"></a>

Tidak bisa memberi tugas dari ponsel

“Permintaan dari ponsel tidak sampai” menjelaskan cara mengirim pekerjaan ke AI di komputer. Untuk menggunakan ponsel saja, lihat “Gunakan Addness hanya di ponsel”.

"Minta bantuan AI" di aplikasi Addness di ponsel mengirim permintaan ke Claude Code atau Codex di komputer. Aplikasi desktop Addness (→ Versi web dan aplikasi desktop) harus terpasang di komputer dan tetap terbuka dalam keadaan masuk dengan akun Addness yang sama, dan komputer harus dalam keadaan menyala. Organisasi yang terbuka di ponsel dan di aplikasi desktop juga harus sama. Untuk persiapan ini, minta AI di komputer mengerjakan goal "Beri tugas ke AI Anda dari ponsel", dan AI akan menjalankannya. Di komputer Windows kantor, aplikasi desktop terkadang tidak bisa dijalankan.

• Muncul "AI di komputer Anda belum terhubung": Persiapan di komputer belum selesai. Buka Addness di komputer, tekan "Minta bantuan AI" (✦) pada "Beri tugas ke AI Anda dari ponsel", lalu jalankan sampai selesai
• "Akan dimulai saat PC menyala" tetap tampil dan tidak ada yang berjalan: Komputer sedang dalam mode tidur, atau aplikasi desktop tertutup. Bangunkan komputer dan buka aplikasinya, maka permintaan akan mulai berjalan. Setelah 24 jam, permintaan dibatalkan
• Muncul "Codex tidak ditemukan di PC": Perintah codex belum terpasang di komputer. Minta AI di komputer "Pasang perintah codex", lalu setelah terpasang, buka ulang aplikasi desktop
• Anda memakai Codex yang ada di dalam aplikasi ChatGPT di Mac: Aplikasi desktop tidak bisa menemukan Codex yang ada di dalam aplikasi ChatGPT. Minta AI di komputer "Pasang perintah codex", lalu setelah terpasang, buka ulang aplikasi desktop (aplikasi desktop hanya mencari Codex di .local/bin pada folder home Anda dan di tempat terminal mencari perintah)
• Muncul "Pilih folder kerja di Addness pada PC" atau "Belum ada folder kerja yang dipilih di Addness pada PC": Buka "リモート操作" (Kontrol jarak jauh) di pengaturan aplikasi desktop di komputer, lalu pilih folder tempat AI bekerja di "作業フォルダ" (Folder kerja) paling atas. Sebelum dipilih, permintaan tidak sampai ke Claude Code maupun Codex
• Muncul "Perbarui Addness di PC": Aplikasi desktop di komputer masih versi lama. Perbarui ke versi terbaru, lalu kirim lagi
• Muncul "“Terima dari ponsel” untuk Codex nonaktif di Addness pada PC": Buka "リモート操作" (Kontrol jarak jauh) di pengaturan aplikasi desktop di komputer, lalu aktifkan "スマホから受け付ける" (Terima dari ponsel) di bagian "Codex" (pilih "作業フォルダ" (Folder kerja) terlebih dulu)
• Tidak sampai ke Claude Code: Pastikan aplikasi Claude di ponsel sudah masuk dengan akun Claude yang sama dengan di komputer

Tetap tidak bisa terhubung

• Tidak terhubung dengan langkah mana pun: Antivirus atau jaringan kantor terkadang memblokir komunikasi dengan Addness. Pernah ada kasus yang berhasil terhubung setelah vt.api.addness.com dikecualikan dari pemindaian di pengaturan antivirus. Jika memakai komputer kantor, tanyakan kepada petugas IT
• Sudah mencoba semua ini tetapi tetap tidak maju: Lampirkan tangkapan layar dari layar tempat proses berhenti, lalu hubungi kami lewat "Pertanyaan tentang Addness" di beranda bantuan