Kết nối MCP

Kết nối các AI như Claude Code, Codex, ChatGPT, Cursor, Claude Desktop với Addness (tích hợp MCP), AI sẽ đọc và ghi được mục tiêu, ToDo, bình luận và nhiều thứ khác trong Addness.

AI thường dùng

Claude Code

Codex

Cursor

MCP

Cả hai chiều đọc và ghi

Cây mục tiêu của Addness

🎯 100 khách hàng mới trong Q1

Hoàn thiện tài liệu đề xuất

Lý tưởng・ghi chú・bình luận・sản phẩm bàn giao

Dùng từ AI nào đi nữa thì nơi kết nối tới vẫn là cùng một cây mục tiêu. Tiến độ và bối cảnh đều tích lũy ở đây

Dành cho người mới: Ở bước đầu tiên “Kết nối” của màn hình thiết lập mở ra sau khi đăng ký, bạn kết nối AI mình dùng với Addness (→ Trang chủ). Các bước từ cách cài ứng dụng AI có trong Cài ứng dụng AI và kết nối với Addness. Bài viết này chỉ giải thích phần tích hợp MCP.

Gửi câu yêu cầu cho AI

Chỉ cần gửi câu yêu cầu này cho AI bạn dùng.

Vui lòng thiết lập Addness MCP (https://vt.api.addness.com/mcp).

AI tiến hành ở những chỗ nó làm được và chỉ hướng dẫn bạn ở những chỗ cần thao tác của bạn. Chỉ phần chấp thuận đăng nhập trên trình duyệt, hãy tự làm khi AI hướng dẫn tới đó.

Những gì AI trở nên làm được

Việc làm được	Ví dụ
Đọc và ghi mục tiêu	Kiểm tra cây mục tiêu, tạo/cập nhật/hoàn thành mục tiêu
ToDo	Trả lời “hôm nay làm gì?” bằng cách xem việc cần làm và mục tiêu thực tế của bạn
Tiến độ và hoạt động	Nắm chuyển động của đội, hoạt động của thành viên, và các mục tiêu đang đình trệ
Bình luận và thông báo	Đăng bình luận lên mục tiêu, kiểm tra và xử lý thông báo
Đăng ký tài nguyên	Gắn những gì bạn tạo vào mục tiêu dưới dạng tài nguyên
Tìm mục tiêu	Tìm các mục tiêu của tổ chức
Kiến thức	Tìm, đọc, tạo và cập nhật kiến thức của tổ chức
Drive	Tìm tài nguyên, tạo thư mục, di chuyển, thùng rác và khôi phục
Ghi màn hình	Liệt kê bản ghi, đọc bản chuyển văn bản, gắn vào mục tiêu, chia sẻ
Gửi tệp	Gửi tệp lớn, kiểm tra lịch sử gửi, vô hiệu hóa liên kết
Danh sách khách hàng (CRM)	Nhập khách hàng, cập nhật giai đoạn, sắp xếp liên hệ, và ghi hoạt động
Phân tích	Tạo định nghĩa KPI và bảng điều khiển, cập nhật dữ liệu mỗi sáng
Hành trình khách hàng	Tạo hành trình, đăng ký các bước và hành động, ghi lại việc thực hiện hằng ngày
Cơ sở dữ liệu	Tạo bảng và đổi cột, đọc và ghi dòng
Biểu mẫu	Tạo và xuất bản biểu mẫu, đọc câu trả lời, xuất ra CSV
Chat	Đọc và viết trong chat mục tiêu, nhóm và DM; tạo nhóm
Cuộc họp và biên bản	Nhờ bot biên bản họp vào cuộc họp; liệt kê và đọc biên bản
Sơ đồ tư duy	Tạo sơ đồ; thêm, chỉnh sửa và di chuyển nhánh (nút)
Mẫu và routine	Tạo mục tiêu từ mẫu; đặt lịch và thay đổi routine
Thành viên và sơ đồ tổ chức	Phân công thành viên, đặt người quản lý, tạo liên kết mời
Widget	Đặt các widget có sẵn lên Trang chủ và trang chi tiết mục tiêu
Network	Tìm người và tổ chức, xem hồ sơ, bài đăng và tin tuyển dụng, trả lời bài đăng
Thử thách	Báo cáo đã hoàn thành các bước của thử thách

Dù kết nối từ AI nào, AI cũng đọc và ghi cùng một cây mục tiêu của cùng một tổ chức.

Nếu bị dừng giữa chừng: các bước theo từng công cụ

Nếu thiết lập bị dừng ở phần quyền hoặc xác thực, hãy cho AI xem các bước dưới đây, hoặc tự tiếp tục.

ChatGPT (plugin chính thức)

Nhập “@Addness” trong ChatGPT hoặc chọn Addness từ danh sách ứng dụng. Nhấn “Kết nối”, đăng nhập Addness rồi nhấn “Cho phép”. Có thể dùng với gói Free. Các thao tác ghi dữ liệu cần được xác nhận. Chỉ kết nối được tài khoản Addness đã có sẵn (không thể đăng ký mới từ màn hình ChatGPT).

Claude Code (terminal)

1. Thêm Addness MCP (với --scope user, để dùng được từ bất kỳ dự án nào)

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

2. Đăng nhập vào Addness (khi trình duyệt mở, chấp thuận bằng tài khoản Addness)

claude mcp login addness

3. Kiểm tra kết nối (xong nếu addness hiện trong danh sách; bạn cũng có thể kiểm tra từ /mcp bên trong Claude Code)

claude mcp list

Codex (CLI)

Bạn dùng được chỉ bằng cách đăng nhập vào Addness trên trình duyệt. Không cần tạo khóa API (Codex cũ không hỗ trợ OAuth, nên hãy cập nhật lên bản mới nhất trước khi chạy).

1. Thêm Addness MCP (trình duyệt tự mở, nên hãy chấp thuận bằng tài khoản Addness. Thiết lập được lưu vào ~/.codex/config.toml)

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

2. Kiểm tra kết nối (xong nếu Auth là OAuth. Nếu đăng nhập không bắt đầu, chạy codex mcp login addness)

codex mcp list

Cursor

1. Mở ~/.cursor/mcp.json và thêm thiết lập sau (nếu bạn có các máy chủ khác, chỉ thêm mục addness)

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

2. Trong Settings → Tools & MCP của Cursor, nhấn Connect cho addness và chấp thuận bằng tài khoản Addness trên trình duyệt

Claude Desktop

Thêm một MCP từ xa không phải qua tệp cấu hình mà dưới dạng một connector tùy chỉnh.

1. Mở Customize → Connectors và chọn + → Add custom connector
2. Đặt tên là Addness và URL là https://vt.api.addness.com/mcp rồi lưu (với Team / Enterprise, cần Owner cấu hình cho tổ chức)
3. Nhấn Connect cho Addness và chấp thuận trên trình duyệt (bạn có thể bật theo từng cuộc trò chuyện từ Connectors)

Các client tương thích MCP khác

Bất kỳ client MCP nào hỗ trợ Streamable HTTP và OAuth đều kết nối được.

1. Đặt tên máy chủ là addness và transport là Streamable HTTP
2. Chỉ định https://vt.api.addness.com/mcp làm nơi kết nối
3. Đăng nhập vào Addness từ nút xác thực của client; xong khi lấy được danh sách công cụ

Kiểm tra xem đã kết nối chưa

Hãy nhờ AI: “Cho tôi xem danh sách tổ chức của tôi trên Addness.” Nếu AI trả về tên các tổ chức bạn đang tham gia thì đã kết nối. Bạn cũng có thể nhờ “Cho tôi xem ToDo của tôi trên Addness” và kiểm tra xem AI có trả về ToDo của bạn không.

Nếu bạn thuộc nhiều tổ chức, trước khi bắt đầu làm việc hãy nhờ AI: “Chuyển tổ chức Addness sang 〈tên tổ chức〉.” AI sẽ chuyển sang tổ chức mà nó thao tác (switch_organization). Nếu đã kết nối với tổ chức đó rồi thì mọi thứ giữ nguyên. Tổ chức đã chuyển sang sẽ được giữ cho cả những cuộc trò chuyện tiếp theo với cùng AI đó.

Nếu AI trả lời là “không có công cụ Addness” hoặc “cần xác thực”, hãy xem Khi không kết nối được.

Muốn chuyển từ màn hình thì dùng Addness it

Thay vì nhờ bằng lời, bạn cũng có thể chuyển từ Addness it ở bên phải dòng mục tiêu (ở độ rộng điện thoại cũng nằm ngay bên trái ”…” của dòng).

• Triển khai: AI đọc ngữ cảnh của mục tiêu đó và tiến hành luôn
• Brainstorm: AI vừa trò chuyện với bạn vừa sắp xếp, rồi đề xuất các mục tiêu con. Chỉ những mục bạn đồng ý mới được tạo
• Hỏi: Viết điều bạn muốn hỏi rồi gửi, AI sẽ đọc mục tiêu và trả lời. Mục tiêu không bị thay đổi

Nhấn “Mở bằng Claude,” “Mở bằng Codex,” “Mở bằng ChatGPT” hoặc “Mở bằng Grok Bot,” và AI mở ra với một câu chỉ dẫn có kèm URL của mục tiêu và cách tiến hành. Với “Sao chép chỉ dẫn,” bạn có thể dán vào một AI khác như Cursor để dùng. Nếu chọn sẵn “Nơi nhận chỉ dẫn” trong mục “AI” của Cài đặt cá nhân, bạn có thể mở chỉ với một cú nhấp mà không phải chọn mỗi lần. Về phần giải thích chi tiết chuyện gì xảy ra, xem Trang chủ.

Khác biệt với API tích hợp bên ngoài

Kết nối MCP cho phép AI đọc và ghi Addness dưới tên tài khoản bạn đang đăng nhập. Nếu hệ thống của bạn chỉ cần đọc thành viên và việc cần làm hôm nay của tổ chức, hãy dùng API tích hợp bên ngoài (chỉ đọc), được gọi bằng khóa gắn cố định với tổ chức. Khóa tích hợp bên ngoài không dùng được với MCP. API này chỉ dùng được ở các tổ chức đã được Addness mở.

Khi không kết nối được

Đây là những trục trặc thường gặp và cách khắc phục. Cách cài ứng dụng AI và kết nối có trong Cài ứng dụng AI và kết nối với Addness.

Không dùng được công cụ Addness

• Đã kết nối nhưng AI nói “không có công cụ Addness”: Trên máy tính, trong Claude Code hoặc Codex, Ngay sau khi kết nối, công cụ chưa hiện ra cho đến khi bạn mở lại ứng dụng AI. Hãy thoát ứng dụng, mở lại, chọn đúng cuộc trò chuyện đó và gửi “tiếp tục”. Chỉ đóng cửa sổ thì ứng dụng chưa thoát. Trên Mac, nhấn Command + Q để thoát. Trên Windows, đóng bằng Alt + F4, và nếu biểu tượng vẫn còn ở góc dưới bên phải màn hình, hãy nhấp chuột phải vào đó và chọn “Thoát”. Trong terminal, nhấn Ctrl + C hai lần để thoát, rồi quay lại đúng cuộc trò chuyện đó bằng claude --resume (với Codex là codex resume)
• Mở lại rồi mà AI vẫn nói “không có”: Claude Code có thể chưa tải công cụ Addness cho đến khi cần dùng. Hãy nói với AI: “Tìm công cụ Addness và dùng nó”
• Mỗi lần dùng công cụ đều bị hỏi xin phép và dừng lại: Hãy nhờ AI: “Thiết lập để bạn dùng công cụ Addness mà không cần hỏi tôi mỗi lần.” Trong Claude Code, mcp__addness sẽ được thêm vào danh sách cho phép trong tệp cài đặt (~/.claude/settings.json)
• Đã gỡ công cụ Addness ra để giải phóng ngữ cảnh: Trong thời gian gỡ ra, AI không đọc được mục tiêu hay ToDo trên Addness. Khi làm việc với Addness, hãy giữ kết nối. Nếu đã gỡ ra, hãy nhờ AI “Bật lại công cụ Addness” rồi mở lại ứng dụng
• Addness không xuất hiện trong Claude hoặc ChatGPT trên trình duyệt: Kết nối Addness qua plugin chính thức trong ChatGPT hoặc qua trình kết nối tùy chỉnh trong Claude trên trình duyệt. Xem Chỉ dùng Addness trên điện thoại.

Đăng nhập không tiếp tục được, kết nối bị ngắt

• Màn hình đăng nhập không mở: Hãy nhờ AI: “Bắt đầu đăng nhập Addness và hiển thị URL.” Dán URL hiện ra vào trình duyệt để mở, rồi nhấn “Cho phép”. Nếu không thấy màn hình “Cho phép” hoặc một trình duyệt khác được mở, hãy xem “Khi không suôn sẻ” trong Cài ứng dụng AI và kết nối với Addness
• Đã nhấn “Cho phép” nhưng bị lỗi: Nếu để màn hình đăng nhập mở một lúc lâu, sẽ có lỗi như “Không thể tạo mã cấp quyền.” Hãy nhờ AI bắt đầu đăng nhập lại, và nhấn “Cho phép” ngay trên màn hình vừa mở
• Trước đây dùng được, giờ lại cần đăng nhập, hoặc bị yêu cầu đăng nhập nhiều lần: Kết nối với Addness sẽ hết hạn sau 90 ngày kể từ lúc kết nối. Hãy nhờ AI “Đăng nhập lại Addness” rồi nhấn “Cho phép” trên trình duyệt
• Khi kết nối mới thì báo lỗi vượt giới hạn: Mỗi người có tối đa 50 kết nối (Ngoài các kết nối của AI, các kết nối như ứng dụng máy tính cũng được tính vào cùng 50 kết nối đó.). Khi đạt 50, kết nối mới sẽ bị từ chối (các kết nối hiện có vẫn dùng bình thường). Tuy nhiên, khi đăng nhập trong ứng dụng máy tính, trong số các kết nối do ứng dụng máy tính và tương tự tự động tạo, kết nối lâu nhất chưa được dùng sẽ tự động bị ngắt và kết nối mới được tạo (các kết nối thực hiện từ ứng dụng AI không bị ngắt). Kết nối cũ hết hạn sau 90 ngày kể từ lúc kết nối, và khi đó bạn có thể kết nối mới trở lại
• Màn hình “Cho phép” hiện “Tổ chức này đã tắt kết nối AI. Hãy trao đổi với quản trị viên.”: Quản trị viên tổ chức đã tắt kết nối AI. Hãy nhờ quản trị viên bật “Thành viên có thể kết nối AI riêng” trong Cài đặt tổ chức › Truy cập bên ngoài (→ Cài đặt tổ chức). Khi đã bật, hãy nhờ AI “Đăng nhập lại Addness”
• Nhầm tài khoản công ty và tài khoản cá nhân: AI kết nối với tài khoản hiện ở dòng “Đang đăng nhập với tư cách …” trên màn hình “Kết nối với Addness MCP”. Hãy kiểm tra địa chỉ email trước khi nhấn “Cho phép”. Nếu đã kết nối nhầm tài khoản, hãy đăng nhập lại Addness trên trình duyệt bằng tài khoản đúng, rồi nhờ AI “Đăng nhập lại Addness”

Đang kết nối với tổ chức khác

• AI nói “không tìm thấy đối tượng”, hoặc đang đọc mục tiêu của tổ chức khác: Tổ chức mà AI kết nối là tổ chức bạn đang chọn trên Addness trong trình duyệt lúc nhấn “Cho phép”. Nếu bạn thuộc nhiều tổ chức, hãy nhờ AI: “Chuyển tổ chức Addness sang 〈tên tổ chức〉.” Khi đưa URL của một mục tiêu, cũng hãy chuyển sang tổ chức có mục tiêu đó trước rồi mới nhờ

Bị dừng trên Windows

• Bị dừng giữa lúc kết nối bằng Codex, hoặc yêu cầu gửi từ điện thoại bị dừng: Chỉ cài ứng dụng Codex thì máy tính có thể vẫn chưa dùng được lệnh codex. Trên Windows, đã có trường hợp nguyên nhân là điều này. Hãy nhờ AI: “Kiểm tra xem lệnh codex có dùng được không, nếu không thì cài đặt nó.” Nếu nhấn “Mở bằng Codex” mà Codex không mở, hãy nhấn “Sao chép chỉ dẫn”, dán vào Codex rồi gửi
• Codex trên Windows không hoàn tất đăng nhập Addness: Hãy cập nhật Codex lên phiên bản mới nhất rồi đăng nhập lại. Nếu vẫn không xong, bạn cũng có thể kết nối bằng Claude Code

Chỉ dùng Addness trên điện thoại

• Ứng dụng ChatGPT: Nhập “@Addness” trong ChatGPT hoặc chọn Addness từ danh sách ứng dụng. Nhấn “Kết nối”, đăng nhập Addness rồi nhấn “Cho phép”.
• Ứng dụng Claude: Trong Safari, mở claude.ai → Tùy chỉnh → Trình kết nối → ＋Thêm → Thêm trình kết nối tùy chỉnh → Tên Addness và URL https://vt.api.addness.com/mcp → Kết nối và cho phép. Bật Addness trong ứng dụng Claude, dán hướng dẫn rồi gửi.
• Tiếp tục trên máy tính: Làm theo Yêu cầu từ điện thoại không đến nơi để gửi công việc đến AI trên máy tính của bạn.

Không giao việc được từ điện thoại

“Yêu cầu từ điện thoại không đến nơi” mô tả cách gửi công việc đến AI trên máy tính. Nếu chỉ dùng điện thoại, hãy xem “Chỉ dùng Addness trên điện thoại”.

Addness it trong ứng dụng Addness trên điện thoại sẽ gửi yêu cầu đến Claude Code hoặc Codex trên máy tính. Máy tính cần cài ứng dụng desktop Addness (→ Phiên bản web và ứng dụng máy tính), đăng nhập bằng cùng tài khoản Addness và để ứng dụng mở, đồng thời máy tính phải đang thức. Tổ chức đang mở trên điện thoại cũng phải giống với tổ chức trong ứng dụng desktop. Để chuẩn bị, hãy nhấn Addness it ở hàng mục tiêu “Giao việc cho AI từ điện thoại” trên máy tính, AI sẽ tiến hành. Trên máy tính Windows của công ty, có thể không chạy được ứng dụng desktop.

• Hiện “AI trên máy tính của bạn chưa được kết nối”: Máy tính chưa được chuẩn bị xong. Hãy mở Addness trên máy tính, nhấn Addness it ở hàng “Giao việc cho AI từ điện thoại” và làm tiếp
• Hiện “Sẽ chạy khi PC thức” mà không chạy: Máy tính đang ngủ, hoặc ứng dụng desktop đang đóng. Đánh thức máy tính và mở ứng dụng thì yêu cầu sẽ bắt đầu chạy. Sau 24 giờ, yêu cầu sẽ bị hủy
• Hiện “Không tìm thấy Codex trên PC”: Máy tính chưa cài lệnh codex. Hãy nhờ AI trên máy tính “Cài lệnh codex”, rồi mở lại ứng dụng desktop
• Bạn dùng Codex có sẵn trong ứng dụng ChatGPT trên Mac: Ứng dụng desktop không tìm thấy Codex bên trong ứng dụng ChatGPT. Hãy nhờ AI trên máy tính “Cài lệnh codex”, rồi mở lại ứng dụng desktop (ứng dụng desktop chỉ tìm Codex trong .local/bin ở thư mục home và ở những nơi terminal tìm lệnh)
• Hiện “Hãy chọn thư mục làm việc trong Addness trên PC” hoặc “Chưa chọn thư mục làm việc trong Addness trên PC”: Mở “リモート操作” (Điều khiển từ xa) trong cài đặt của ứng dụng desktop trên máy tính, rồi chọn thư mục để AI làm việc ở “作業フォルダ” (Thư mục làm việc) trên cùng. Chưa chọn thì yêu cầu không đến được cả Claude Code lẫn Codex
• Hiện “Hãy cập nhật Addness trên PC”: Ứng dụng desktop trên máy tính là phiên bản cũ. Hãy cập nhật lên phiên bản mới nhất rồi gửi lại
• Hiện ““Nhận từ điện thoại” của Codex đang tắt trong Addness trên PC”: Mở “リモート操作” (Điều khiển từ xa) trong cài đặt của ứng dụng desktop trên máy tính và bật “スマホから受け付ける” (Nhận từ điện thoại) ở mục “Codex” (chọn “作業フォルダ” (Thư mục làm việc) trước)
• Yêu cầu không đến được Claude Code: Hãy kiểm tra xem ứng dụng Claude trên điện thoại đã đăng nhập bằng cùng tài khoản Claude với máy tính chưa

Vẫn không kết nối được

• Làm theo bước nào cũng không kết nối được: Phần mềm diệt virus hoặc mạng công ty có thể đang chặn kết nối tới Addness. Đã có trường hợp kết nối được sau khi loại vt.api.addness.com khỏi phạm vi quét trong phần cài đặt của phần mềm. Nếu là máy tính công ty, hãy hỏi bộ phận IT
• Thử hết các cách ở đây mà vẫn không tiến triển: Hãy liên hệ với chúng tôi qua “Câu hỏi về Addness (biểu mẫu hỗ trợ)” trên trang chủ trợ giúp. Chép nguyên văn thông báo lỗi và, nếu có ảnh chụp màn hình nơi bị dừng, hãy dán liên kết chia sẻ của ảnh vào biểu mẫu

Bài viết này có hữu ích không?

CóKhông

← TrướcCài ứng dụng AI và kết nối với AddnessTiếp →Xem cách dùng qua video

Bắt đầu

• Cài ứng dụng AI và kết nối với Addness
• Xem cách dùng qua video