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.

Dành cho người mới: Trên trang mục tiêu của người vừa tạo tổ chức mới và người tham gia tổ chức qua lời mời, có sẵn "Thiết lập Addness." Ở dòng "1. Kết nối AI của bạn với Addness" bên trong đó, nhấn "Nhờ AI thực hiện" → "Mở bằng Claude Code" (hoặc "Mở bằng Codex"), AI sẽ lần lượt tiến hành, bắt đầu từ việc kết nối với Addness (→ Trang mục tiêu). 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

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

1. Đă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

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

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

1. 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 "Nhờ AI thực hiện"

Thay vì nhờ bằng lời, bạn cũng có thể chuyển từ ✦ ("Nhờ AI thực hiện") ở bên phải dòng mục tiêu (ở độ rộng điện thoại là "…" của dòng → "Nhờ AI thực hiện").

• 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 Code," "Mở bằng Codex" hoặc "Mở bằng ChatGPT," 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 mục tiêu.

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 nối bị ngắt sớm hơn 90 ngày trong các trường hợp sau. Nếu kết nối lại từ cùng một ứng dụng AI, kết nối trước đó của ứng dụng đó sẽ bị ngắt. Mỗi người có tối đa 20 kết nối; nếu vượt quá, kết nối lâu nhất không được dùng sẽ bị ngắt trước (người dùng nhiều máy tính hoặc nhiều AI có thể bị ngắt kết nối cũ vì lý do này). Hãy nhờ AI "Đăng nhập lại Addness" rồi nhấn "Cho phép" trên trình duyệt
• 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

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

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.

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

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

"Nhờ AI thực hiện" 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 giao mục tiêu "Giao việc cho AI từ điện thoại" cho AI 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 "Nhờ AI thực hiện" (✦) ở "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 đính kèm ảnh chụp màn hình nơi bị dừng và liên hệ với chúng tôi qua "Câu hỏi về Addness" trên trang chủ trợ giúp