Penyepaduan MCP

Sambungkan AI seperti Claude Code, Codex, ChatGPT, Cursor dan Claude Desktop kepada Addness (integrasi MCP), dan AI boleh membaca serta menulis matlamat, ToDo, komen dan lain-lain dalam Addness.

Untuk kali pertama: Halaman matlamat orang yang baru mencipta organisasi dan orang yang menyertai organisasi melalui jemputan mengandungi "Sediakan Addness." Pada baris "1. Sambungkan AI anda ke Addness" di dalamnya, tekan "Minta AI" → "Buka dalam Claude Code" (atau "Buka dalam Codex"), dan AI meneruskan satu demi satu, bermula dengan menyambung ke Addness (→ halaman Matlamat). Langkah bermula dari memasang aplikasi AI terdapat dalam Pasang aplikasi AI dan sambungkan kepada Addness. Artikel ini hanya menerangkan bahagian integrasi MCP.

Hantar teks permintaan kepada AI

Cukup hantar permintaan ini kepada AI yang anda guna.

Sila sediakan Addness MCP (https://vt.api.addness.com/mcp).

AI meneruskan di tempat yang boleh dan membimbing anda hanya di tempat yang memerlukan tindakan anda. Hanya kelulusan log masuk pada pelayar sahaja, sila lakukan sendiri apabila AI membimbing anda ke situ.

Apa yang AI mampu lakukan

Dari AI mana pun anda menyambung, ia membaca dan menulis pokok matlamat yang sama dalam organisasi yang sama.

Jika ia berhenti separuh jalan: langkah mengikut alat

Jika penyediaan berhenti pada kebenaran atau pengesahan, tunjukkan langkah di bawah kepada AI, atau teruskan sendiri.

ChatGPT (pemalam rasmi)

Taip “@Addness” dalam ChatGPT atau pilih Addness daripada senarai aplikasi. Tekan “Sambung”, log masuk ke Addness dan tekan “Benarkan”. Tersedia pada pelan Free. Perubahan memerlukan pengesahan. Hanya akaun Addness sedia ada boleh disambungkan (anda tidak boleh mendaftar akaun baharu dari skrin ChatGPT).

Claude Code (terminal)

1. Tambah Addness MCP (dengan --scope user, supaya ia boleh diguna daripada mana-mana projek)

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

1. Log masuk ke Addness (apabila pelayar terbuka, luluskan dengan akaun Addness anda)

claude mcp login addness

1. Semak sambungan (selesai jika addness muncul dalam senarai; anda juga boleh menyemak daripada /mcp di dalam Claude Code)

claude mcp list

Codex (CLI)

Anda boleh menggunakannya hanya dengan log masuk ke Addness pada pelayar. Mencipta kunci API tidak diperlukan (Codex lama tidak menyokong OAuth, jadi kemas kini kepada versi terkini sebelum menjalankannya).

1. Tambah Addness MCP (pelayar terbuka secara automatik, jadi luluskan dengan akaun Addness anda. Tetapan disimpan ke ~/.codex/config.toml)

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

1. Semak sambungan (selesai jika Auth ialah OAuth. Jika log masuk tidak bermula, jalankan codex mcp login addness)

codex mcp list

Cursor

1. Buka ~/.cursor/mcp.json dan tambah tetapan berikut (jika anda mempunyai pelayan lain, tambah hanya entri addness)

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

1. Dalam Settings → Tools & MCP Cursor, tekan Connect untuk addness dan luluskan dengan akaun Addness anda pada pelayar

Claude Desktop

Tambah MCP jauh bukan melalui fail konfigurasi tetapi sebagai penyambung tersuai.

1. Buka Customize → Connectors dan pilih + → Add custom connector
2. Tetapkan nama kepada Addness dan URL kepada https://vt.api.addness.com/mcp dan simpan (pada Team / Enterprise, konfigurasi organisasi oleh Owner diperlukan)
3. Tekan Connect untuk Addness dan luluskan pada pelayar (anda boleh mengaktifkannya bagi setiap perbualan daripada Connectors)

Klien serasi MCP yang lain

Mana-mana klien MCP yang menyokong Streamable HTTP dan OAuth boleh bersambung.

1. Tetapkan nama pelayan kepada addness dan pengangkutan kepada Streamable HTTP
2. Nyatakan https://vt.api.addness.com/mcp sebagai sasaran sambungan
3. Log masuk ke Addness daripada butang pengesahan klien; selesai sebaik sahaja senarai alat diperoleh

Semak sama ada sudah bersambung

Minta AI: "Tunjukkan senarai organisasi saya dalam Addness". Jika AI menjawab dengan nama organisasi yang anda sertai, ia sudah bersambung. Anda juga boleh meminta "Tunjukkan ToDo saya dalam Addness" dan semak sama ada ToDo anda dipaparkan.

Jika anda menyertai lebih daripada satu organisasi, sebelum mula bekerja, minta AI: "Tukar organisasi Addness kepada <nama organisasi>". AI akan menukar organisasi yang dikendalikannya (switch_organization). Jika ia sudah bersambung ke organisasi itu, tiada apa yang berubah. Organisasi yang ditukar juga dibawa ke perbualan seterusnya dengan AI yang sama.

Jika AI menjawab bahawa tiada alat Addness, atau pengesahan diperlukan, lihat Jika tidak dapat bersambung.

Untuk menyerahkannya dari skrin: "Minta AI"

Daripada meminta dengan perkataan, anda juga boleh menyerahkannya daripada ✦ ("Minta AI") di sebelah kanan baris matlamat (pada lebar mudah alih, "…" baris → "Minta AI").

• Teruskan: AI membaca konteks matlamat itu dan terus meneruskannya
• Sumbang saran: AI menyusun perkara sambil bercakap dengan anda dan mencadangkan matlamat anak. Hanya yang anda luluskan akan dicipta
• Tanya: Tulis apa yang anda mahu tanya dan hantar, dan AI membaca matlamat itu lalu menjawab. Matlamat tidak diubah

Tekan "Buka dalam Claude Code," "Buka dalam Codex" atau "Buka dalam ChatGPT," dan AI terbuka dengan arahan yang merangkumi URL matlamat dan cara meneruskan. Dengan "Salin arahan," anda boleh menampalnya ke AI lain seperti Cursor dan menggunakannya. Tetapkan "Tempat arahan dihantar" dalam bahagian "AI" tetapan peribadi, dan anda boleh membukanya dengan satu klik tanpa memilih setiap kali. Untuk penerangan terperinci tentang apa yang berlaku, lihat halaman Matlamat.

Perbezaan dengan API integrasi luaran

Penyepaduan MCP membolehkan AI anda membaca dan menulis dalam Addness atas nama akaun anda yang log masuk. Jika sistem anda hanya perlu membaca ahli dan tugasan hari ini organisasi anda, gunakan API integrasi luaran (baca sahaja) yang dipanggil dengan kunci yang terikat pada organisasi. Kunci integrasi luaran tidak boleh digunakan dengan MCP. API ini hanya tersedia untuk organisasi yang didayakan oleh Addness.

Jika tidak dapat bersambung

Berikut ialah masalah yang biasa berlaku dan cara membetulkannya. Cara memasang aplikasi AI dan menyambungkannya ada dalam Pasang aplikasi AI dan sambungkan kepada Addness.

Alat Addness tidak dapat digunakan

• Sudah disambungkan, tetapi AI berkata tiada alat Addness: Pada komputer, dalam Claude Code atau Codex, Sejurus selepas menyambung, alat tidak kelihatan sehingga aplikasi AI dibuka semula. Tutup aplikasi, buka semula, pilih perbualan yang sama dan hantar "teruskan". Menutup tetingkap sahaja belum menutup aplikasinya. Pada Mac, tutup dengan Command + Q. Pada Windows, tutup dengan Alt + F4, dan jika ikonnya masih ada di penjuru kanan bawah skrin, klik kanan ikon itu dan pilih "Keluar". Dalam terminal, tekan Ctrl + C dua kali untuk keluar, kemudian kembali ke perbualan yang sama dengan claude --resume (untuk Codex, codex resume)
• Masih berkata tiada selepas dibuka semula: Claude Code kadangkala hanya memuatkan alat Addness apabila hendak menggunakannya. Beritahu AI: "Cari alat Addness dan gunakannya"
• AI meminta kebenaran setiap kali menggunakan alat, lalu berhenti: Minta AI: "Tetapkan supaya alat Addness boleh digunakan tanpa bertanya setiap kali". Dalam Claude Code, mcp__addness akan dimasukkan ke dalam senarai kebenaran dalam fail tetapan (~/.claude/settings.json)
• Anda telah mengeluarkan alat Addness untuk mengosongkan konteks: Selagi alat itu dikeluarkan, AI tidak dapat membaca matlamat atau to-do Addness anda. Apabila bekerja dengan Addness, biarkan ia bersambung. Jika anda telah mengeluarkannya, minta AI "Aktifkan semula alat Addness" dan buka semula aplikasi
• Addness tidak muncul dalam Claude atau ChatGPT dalam pelayar: Sambungkan Addness melalui pemalam rasmi dalam ChatGPT atau penyambung tersuai dalam Claude versi pelayar. Lihat Guna Addness pada telefon sahaja.

Log masuk tidak berjalan, atau sambungan terputus

• Skrin log masuk tidak dibuka: Minta AI: "Mulakan log masuk Addness dan paparkan URL". Tampal URL yang dipaparkan ke dalam pelayar, bukanya, dan tekan "Benarkan". Jika skrin "Benarkan" tidak muncul atau pelayar lain yang dibuka, lihat "Jika tidak berjaya" dalam Pasang aplikasi AI dan sambungkan kepada Addness
• Sudah menekan "Benarkan", tetapi ralat berlaku: Jika skrin log masuk dibiarkan terbuka agak lama, ralat seperti "Kod kebenaran tidak dapat dijana" akan muncul. Minta AI memulakan log masuk sekali lagi, dan segera tekan "Benarkan" pada skrin yang dibuka
• Dahulu boleh digunakan, tetapi kini perlu log masuk, atau diminta log masuk berkali-kali: Sambungan ke Addness tamat selepas 90 hari. Sambungan terputus lebih awal daripada 90 hari dalam keadaan berikut. Jika anda menyambung semula dari aplikasi AI yang sama, sambungan sebelumnya bagi aplikasi itu terputus. Seorang pengguna boleh mempunyai sehingga 20 sambungan; jika melebihi had itu, sambungan yang paling lama tidak digunakan terputus dahulu (jika anda menggunakan banyak komputer atau AI, sambungan lama mungkin terputus kerana ini). Minta AI "Log masuk semula ke Addness" dan tekan "Benarkan" dalam pelayar
• Tersilap antara akaun syarikat dan akaun peribadi: AI bersambung ke akaun yang ditunjukkan sebagai "Log masuk sebagai …" pada skrin "Sambungkan kepada Addness MCP". Sebelum menekan "Benarkan", semak alamat e-mel. Jika anda tersambung dengan akaun yang salah, log masuk semula ke Addness dalam pelayar dengan akaun yang betul, kemudian minta AI "Log masuk semula ke Addness"

Bersambung ke organisasi lain

• AI berkata sasaran tidak dijumpai, atau membaca matlamat daripada organisasi lain: Organisasi yang disambungkan oleh AI ialah organisasi yang anda pilih dalam Addness di pelayar semasa menekan "Benarkan". Jika anda menyertai lebih daripada satu organisasi, minta AI "Tukar organisasi Addness kepada <nama organisasi>". Apabila memberikan URL matlamat juga, tukar dahulu ke organisasi tempat matlamat itu berada, kemudian barulah minta

Terhenti pada Windows

• Terhenti semasa menyambung dengan Codex, atau permintaan dari telefon terhenti: Memasang aplikasi Codex sahaja kadangkala tidak menjadikan arahan codex boleh digunakan pada komputer. Pada Windows, pernah ada kes yang puncanya ialah perkara ini. Minta AI: "Semak sama ada arahan codex boleh digunakan, dan pasangkannya jika tidak". Jika Codex tidak dibuka walaupun anda menekan "Buka dalam Codex", tekan "Salin arahan", tampalkannya ke Codex dan hantar
• Log masuk ke Addness tidak selesai dalam Codex untuk Windows: Kemas kini Codex ke versi terkini dan log masuk sekali lagi. Jika masih tidak selesai, anda juga boleh menyambung dengan Claude Code

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

Guna Addness pada telefon sahaja

• Aplikasi ChatGPT: Taip “@Addness” dalam ChatGPT atau pilih Addness daripada senarai aplikasi. Tekan “Sambung”, log masuk ke Addness dan tekan “Benarkan”.
• Aplikasi Claude: Dalam Safari, buka claude.ai → Sesuaikan → Penyambung → ＋Tambah → Tambah penyambung tersuai → Nama Addness dan URL https://vt.api.addness.com/mcp → Sambung dan benarkan. Hidupkan Addness dalam aplikasi Claude, tampal arahan dan hantar.
• Teruskan pada komputer: Ikut Permintaan daripada telefon tidak sampai untuk menghantar kerja kepada AI pada komputer anda.

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

Tidak dapat memberi tugasan dari telefon

“Permintaan daripada telefon tidak sampai” menerangkan cara menghantar kerja kepada AI pada komputer. Untuk menggunakan telefon sahaja, lihat “Guna Addness pada telefon sahaja”.

"Minta AI" dalam aplikasi Addness pada telefon menghantar permintaan kepada Claude Code atau Codex pada komputer. Aplikasi desktop Addness (→ Versi web dan aplikasi desktop) perlu dipasang pada komputer dan kekal dibuka dalam keadaan log masuk dengan akaun Addness yang sama, dan komputer perlu dalam keadaan hidup. Organisasi yang dibuka pada telefon dan dalam aplikasi desktop juga perlu sama. Untuk persediaan ini, minta AI pada komputer menjalankan matlamat "Beri tugasan kepada AI anda dari telefon", dan AI akan meneruskannya. Pada komputer Windows syarikat, aplikasi desktop kadangkala tidak dapat dijalankan.

• "AI pada komputer anda belum disambungkan" muncul: Persediaan pada komputer belum selesai. Buka Addness pada komputer, tekan "Minta AI" (✦) pada "Beri tugasan kepada AI anda dari telefon" dan teruskan hingga selesai
• "Akan bermula apabila PC dihidupkan" terus dipaparkan dan tiada apa berlaku: Komputer berada dalam mod tidur, atau aplikasi desktop ditutup. Bangunkan komputer dan buka aplikasi, dan permintaan akan bermula. Selepas 24 jam, permintaan dibatalkan
• "Codex tidak dijumpai pada PC" muncul: Arahan codex belum dipasang pada komputer. Minta AI pada komputer "Pasang arahan codex", dan selepas dipasang, buka semula aplikasi desktop
• Anda menggunakan Codex yang ada di dalam aplikasi ChatGPT pada Mac: Aplikasi desktop tidak dapat menjumpai Codex yang ada di dalam aplikasi ChatGPT. Minta AI pada komputer "Pasang arahan codex", dan selepas dipasang, buka semula aplikasi desktop (aplikasi desktop hanya mencari Codex dalam .local/bin di folder rumah anda dan di tempat terminal mencari arahan)
• "Pilih folder kerja dalam Addness pada PC" atau "Tiada folder kerja dipilih dalam Addness pada PC" muncul: Buka "リモート操作" (Kawalan jauh) dalam tetapan aplikasi desktop pada komputer, dan pilih folder tempat AI bekerja dalam "作業フォルダ" (Folder kerja) di bahagian atas. Selagi belum dipilih, permintaan tidak sampai kepada Claude Code mahupun Codex
• "Kemas kini Addness pada PC" muncul: Aplikasi desktop pada komputer ialah versi lama. Kemas kini kepada versi terkini, kemudian hantar semula
• "“Terima dari telefon” untuk Codex dimatikan dalam Addness pada PC" muncul: Buka "リモート操作" (Kawalan jauh) dalam tetapan aplikasi desktop pada komputer dan hidupkan "スマホから受け付ける" (Terima dari telefon) dalam bahagian "Codex" (pilih "作業フォルダ" (Folder kerja) dahulu)
• Tidak sampai ke Claude Code: Semak sama ada aplikasi Claude pada telefon sudah log masuk dengan akaun Claude yang sama seperti pada komputer

Masih tidak dapat bersambung

• Tidak dapat bersambung dengan apa jua langkah: Perisian antivirus atau rangkaian syarikat mungkin menyekat komunikasi dengan Addness. Pernah ada kes yang berjaya bersambung selepas vt.api.addness.com dikecualikan daripada imbasan dalam tetapan perisian itu. Jika menggunakan komputer syarikat, rujuk kepada pegawai IT
• Masih tidak bergerak walaupun sudah mencuba semua ini: Lampirkan tangkapan skrin bagi skrin tempat proses terhenti, dan hubungi kami melalui "Pertanyaan tentang Addness" di laman utama bantuan