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.

AI yang biasa dipakai

Claude Code

Codex

Cursor

MCP

Dua arah, baca dan tulis

Pohon goal Addness

🎯 100 pelanggan baru di Q1

Menyelesaikan materi proposal

Ideal, memo, komentar, hasil kerja

Dari AI mana pun kamu memakainya, tujuan yang terhubung sama: satu pohon goal. Progres dan konteks terkumpul di sini

Untuk pengguna baru: Pada langkah pertama “Hubungkan” di layar penyiapan yang terbuka setelah pendaftaran, Anda menghubungkan AI yang Anda pakai ke Addness (→ Beranda). 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

Yang bisa dilakukan	Contoh
Membaca dan menulis goal	Memeriksa pohon goal, membuat/memperbarui/menyelesaikan goal
ToDo	Menjawab “apa yang harus saya kerjakan hari ini?” dengan melihat to-do dan goal nyata Anda
Progres dan aktivitas	Memahami pergerakan tim, aktivitas anggota, dan goal yang mandek
Komentar dan notifikasi	Memposting komentar pada goal, memeriksa dan menangani notifikasi
Mendaftarkan sumber daya	Mengaitkan yang Anda buat ke goal sebagai sumber daya
Pencarian goal	Mencari goal organisasi
Pengetahuan	Mencari, membaca, membuat, dan memperbarui pengetahuan organisasi
Drive	Mencari resource, membuat folder, memindahkan, membuang ke sampah, dan memulihkan
Rekaman layar	Menampilkan daftar rekaman, membaca transkrip, mengaitkan ke goal, berbagi
File Transfer	Mengirim file besar, memeriksa riwayat pengiriman, menonaktifkan tautan
Daftar pelanggan (CRM)	Mengimpor pelanggan, memperbarui tahap, merapikan kontak, dan mencatat aktivitas
Analytics	Membuat definisi KPI dan dashboard, menyegarkan data setiap pagi
Perjalanan pelanggan	Membuat perjalanan, mendaftarkan langkah dan aksi, mencatat eksekusi harian
Basis data	Membuat tabel dan mengubah kolom, membaca dan menulis baris
Formulir	Membuat dan memublikasikan formulir, membaca jawaban, mengekspor ke CSV
Chat	Membaca dan menulis chat goal, grup, dan DM; membuat grup
Rapat dan notulen	Meminta bot notulen bergabung ke rapat, menampilkan daftar dan membaca notulen
Mind map	Membuat peta; menambah, mengedit, dan memindahkan cabang (node)
Template dan rutinitas	Membuat goal dari template, menjadwalkan dan mengubah rutinitas
Anggota dan bagan organisasi	Menugaskan anggota, mengatur atasan, menerbitkan tautan undangan
Widget	Menempatkan widget yang tersedia di Beranda dan halaman detail goal
Network	Mencari orang dan organisasi, melihat profil, postingan, dan lowongan, membalas postingan
Tantangan	Melaporkan bahwa langkah-langkah tantangan sudah selesai

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

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

claude mcp login addness

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

2. 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"
    }
  }
}

2. 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: Addness it

Alih-alih meminta dengan kata-kata, Anda juga bisa menyerahkannya dari Addness it di kanan baris goal (pada lebar ponsel pun, ada tepat di kiri ”…” baris).

• 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,” “Buka di Codex,” “Buka di ChatGPT,” atau “Buka di Grok Bot,” 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 Beranda.

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 90 hari setelah dihubungkan. Minta AI “Login ulang ke Addness”, lalu tekan “Izinkan” di browser
• Muncul error batas saat menghubungkan yang baru: Satu orang bisa punya hingga 50 koneksi (Selain koneksi AI, koneksi seperti aplikasi desktop juga dihitung dalam 50 yang sama). Setelah mencapai 50, koneksi baru ditolak (koneksi yang sedang tersambung tetap bisa dipakai). Namun, saat Anda login di aplikasi desktop, dari koneksi yang dibuat otomatis oleh aplikasi desktop dan sejenisnya, satu koneksi yang paling lama tidak dipakai diputus otomatis, lalu koneksi baru dibuat (koneksi yang dibuat dari aplikasi AI tidak diputus). Koneksi lama berakhir 90 hari setelah dibuat, dan setelah itu Anda bisa menghubungkan yang baru lagi
• Layar “Izinkan” menampilkan “Koneksi AI dinonaktifkan di organisasi ini. Mari hubungi administrator.”: Admin organisasi telah mematikan koneksi AI. Minta admin untuk menyalakan “Anggota dapat menghubungkan AI sendiri” di Pengaturan organisasi › Akses keluar (→ Pengaturan organisasi). Setelah menyala, minta AI “Login ulang ke Addness”
• 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

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.

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

Addness it 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, tekan Addness it di baris goal “Beri tugas ke AI Anda dari ponsel” di komputer, 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 Addness it di baris “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: Hubungi kami lewat “Pertanyaan tentang Addness (formulir dukungan)” di beranda bantuan. Salin pesan error persis seperti yang muncul, dan jika Anda punya tangkapan layar dari layar tempat proses berhenti, tempelkan tautan berbaginya di formulir

Apakah artikel ini membantu?

YaTidak

← SebelumnyaPasang aplikasi AI dan hubungkan ke AddnessSelanjutnya →Lihat cara pakai lewat video

Mulai

• Pasang aplikasi AI dan hubungkan ke Addness
• Lihat cara pakai lewat video