Kết nối Claude Code với Confluence để hỏi đáp toàn bộ tài liệu dự án
Đặt vấn đề
Tài liệu dự án thường rải rác trên hàng chục đến hàng trăm trang Confluence — mỗi lần cần thông tin phải mở từng trang, đoán từ khóa tìm kiếm, khá tốn thời gian. Claude Code kết nối Confluence qua MCP: đăng nhập Atlassian một lần, sau đó hỏi bằng tiếng Việt ngay trong Claude Code — nó tự tìm, đọc nhiều trang cùng lúc và trả lời kèm link trang gốc. Lưu ý: Claude chỉ thấy đúng những trang tài khoản bạn được phép xem, không vượt quyền.
🚀 Thiết lập trong 3 bước
Mất khoảng 10-15 phút lần đầu, sau đó chỉ việc dùng.
- 1Kết nối Confluence (làm 1 lần)Trước tiên cần kết nối Claude với Confluence — làm đúng 1 lần. Xem hướng dẫn riêng: bài "Cách kết nối Claude Code với Confluence & Jira (Atlassian)" (có 2 cách: qua App hoặc qua CLI). Nếu bạn đã kết nối rồi (connector Atlassian hiện 'Disconnect') thì bỏ qua bước này.Mở hướng dẫn kết nối Confluence
- 2Kiểm tra đã kết nốiGõ: 'Liệt kê các space Confluence tôi có quyền xem'. Ra đúng danh sách space của bạn → sẵn sàng hỏi đáp tài liệu.
- 3Hỏi đáp tài liệu bằng 3 prompt (bên dưới)Từ đây mọi thứ chỉ là gõ prompt bình thường. Dán lần lượt 3 prompt: tổng hợp 1 chủ đề → trả lời câu hỏi xuyên trang → tìm điểm thiếu/mâu thuẫn. Luôn bấm link trang gốc Claude dẫn ra để kiểm chứng.
🔍 3 prompt — kèm chỗ AI hay sai cần bắt
AI sinh kết quả chỉ trong vài giây — việc của bạn là kiểm lại. Mỗi prompt kèm ví dụ kết quả và 🔍 Góc soi lỗi của Tester (chỗ AI hay sai, nên xem trước khi dùng). Bấm Copy → dán vào Claude Code / ChatGPT.
Gom nhanh mọi trang liên quan một chức năng/chủ đề thành 1 bản tóm tắt — thay vì mở từng trang.
Tìm trong Confluence (space [TÊN SPACE], hoặc toàn bộ tôi có quyền xem) các trang liên quan đến [CHỦ ĐỀ/CHỨC NĂNG, vd: quy trình thanh toán]. Tổng hợp thành bản tóm tắt gồm: mô tả chức năng, các quy tắc nghiệp vụ chính, các bên liên quan. Với mỗi ý, dẫn link trang Confluence gốc. Chỉ dựa trên nội dung tài liệu, không suy đoán thêm.
Claude dựa vào search của Confluence — nếu tài liệu dùng từ khóa khác cách bạn hỏi, nó có thể sót trang. Hỏi lại bằng vài từ đồng nghĩa hoặc chỉ rõ tên space/trang. Luôn bấm link nó dẫn để chắc trang đó tồn tại và đúng nội dung — đôi khi AI gộp ý từ nhiều trang lại.
Hỏi 1 câu, AI gom câu trả lời từ nhiều trang tài liệu rải rác — không phải tự dò từng trang.
Dựa trên tài liệu trong Confluence, trả lời câu hỏi: [CÂU HỎI, vd: khi đơn hàng bị hủy thì hoàn tiền theo quy trình nào?]. Tổng hợp từ tất cả trang liên quan, nêu rõ trang nào nói gì (kèm link). Nếu các trang nói khác nhau về cùng một điểm, chỉ ra sự khác biệt đó.
Đây là chỗ AI dễ 'tự tin gộp' thông tin từ trang cũ + trang mới thành một câu trả lời nghe hợp lý nhưng sai. Confluence hay để trang cũ không xóa. Hỏi thêm 'trang nào cập nhật gần nhất?' và ưu tiên trang mới. Câu trả lời chỉ đáng tin sau khi bạn mở đúng trang gốc.
Phát hiện tài liệu mơ hồ, thiếu, hoặc các trang mâu thuẫn nhau — trước khi vào sprint test.
Với góc nhìn QA, rà các trang Confluence về [CHỨC NĂNG] và chỉ ra: (1) thông tin MƠ HỒ/thiếu định lượng; (2) các trang MÂU THUẪN nhau; (3) trường hợp/biên chưa được mô tả. Mỗi điểm dẫn link trang liên quan + đề xuất câu hỏi cụ thể để hỏi BA. Không bịa — nếu không chắc thì ghi 'cần xác nhận'.
AI có thể báo 'thiếu' trong khi thông tin nằm ở trang/space khác mà nó chưa search tới. Thêm câu 'nếu thông tin có ở trang khác, hãy chỉ ra thay vì coi là thiếu'. Coi kết quả là 'checklist nghi vấn để rà', KHÔNG phải kết luận — verify trước khi gửi BA (giống bài đọc requirement từ file).
📌 Tóm lại
Confluence là nơi lưu trữ tài liệu dự án, nhưng khối lượng lớn cũng khiến việc tra cứu khó khăn. Kết nối Claude Code cho phép bạn đặt câu hỏi cho toàn bộ kho tài liệu thay vì dò từng trang — rất phù hợp khi mới tham gia dự án hoặc cần tổng hợp thông tin gấp. Lưu ý: tài liệu có thể đã lỗi thời và AI dựa vào tìm kiếm nên có thể bỏ sót — hãy luôn mở liên kết trang gốc để kiểm chứng, ưu tiên trang cập nhật mới nhất, và xác nhận chính sách bảo mật của công ty trước khi kết nối với tài liệu thật.