MCP và connectors: đưa dữ liệu đúng vào phiên làm việc

English title: MCP and Connectors: Bring the Right Data Into the Session

Cập nhật: 29/06/2026. Đây là bài 7 trong chuỗi Codex Power 10 - 10 bài hướng dẫn dùng các năng lực mạnh của Codex theo cách có kiểm soát.

Bạn sẽ hiểu vì sao tool có schema đáng tin hơn copy-paste, và cách thiết kế quyền truy cập để agent có dữ liệu mà không vượt biên.

Bảng Nhớ Nhanh

Dùng bài này khi: Codex cần dữ liệu hoặc công cụ bên ngoài cửa sổ chat theo cách có cấu trúc.

Không dùng bài này khi: một đoạn log nhỏ hoặc một link tĩnh đã đủ cho task.

Xong bài khi: MCP server có cấu hình rõ, quyền tối thiểu và Codex biết khi nào phải gọi tool trước khi suy luận.

Ghi nhớ: Bài thực hành này không cố làm bạn nhớ hết tính năng. Nó giúp bạn dựng một vòng làm việc có mục tiêu, có biên và có bằng chứng.

Trước Khi Bắt Đầu

• Biết nguồn dữ liệu nào thật sự cần cho task.
• Biết server là STDIO hay streamable HTTP.
• Xác định quyền đọc/ghi và biến môi trường cần thiết.

Cẩn trọng: Nếu môi trường hoặc quyền đang mơ hồ, hãy dừng một nhịp để kiểm tra. Agent chạy nhanh trong bối cảnh sai sẽ tạo ra diff rất thuyết phục nhưng khó dùng.

Ý Tưởng Trong 3 Phút

Một câu trả lời tốt thường cần dữ liệu ngoài cửa sổ chat: issue, tài liệu, spreadsheet, log triển khai, ticket, kho tri thức. Nếu bạn copy từng mẩu vào prompt, ngữ cảnh nhanh chóng rối. Connector biến nguồn đó thành công cụ có cấu trúc.

MCP giống ổ cắm chuẩn cho công cụ. Connector là dây nối tới một nguồn cụ thể. Agent không cần biết mọi thứ; nó cần biết gọi đúng công cụ, đúng tham số, đúng quyền.

• Công cụ tốt có schema rõ: đầu vào nào bắt buộc, đầu ra trả về dạng gì, lỗi được mô tả ra sao.
• Quyền truy cập nên theo nguyên tắc tối thiểu: chỉ nguồn cần cho tác vụ, chỉ hành động cần thiết.
• Nguồn động cần dấu thời gian. Với dữ liệu có thể thay đổi, Codex nên nói nó đã kiểm tra lúc nào.
• Không phải thứ gì cũng cần connector. Nếu tác vụ chỉ cần hai dòng log, đưa trực tiếp vào prompt có thể đơn giản hơn.

Công Thức 1: Chạy Quy Trình Chính

Khi dùng: Codex cần dữ liệu hoặc công cụ bên ngoài cửa sổ chat theo cách có cấu trúc.

1. Xác định nguồn dữ liệu nào lặp lại và có giá trị cao.
2. Ưu tiên công cụ chính thức hoặc connector đã được đội tin cậy.
3. Mô tả rõ quyền đọc/ghi, phạm vi dữ liệu và cách ghi log.
4. Trong prompt, yêu cầu Codex dùng tool trước khi suy luận nếu dữ liệu có thể thay đổi.

Công Thức 2: Đóng Cổng Kiểm Chứng

Một phiên tốt không cần lúc nào cũng dài. Điều cần giữ là nhịp: giao việc rõ, để Codex đọc đúng, cho nó thực hiện trong phạm vi nhỏ, rồi bắt nó tự chứng minh kết quả.

Prompt Mẫu

Goal: Dùng MCP để kiểm tra tài liệu mới nhất trước khi sửa code.
Context: Tên thư viện, file đang dùng API đó và lỗi hiện tại.
Constraints: Chỉ dùng nguồn docs chính thức hoặc MCP đã cấu hình.
Done-when: Trích nguồn đã gọi, nêu phiên bản/ngày kiểm tra nếu dữ liệu có thể đổi.

Ví Dụ Tối Thiểu: MCP server STDIO tối giản

[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp"]
startup_timeout_sec = 20
tool_timeout_sec = 60

Khi Có Lỗi

Nếu gặp một trong các lỗi trên, cách sửa thường không phải là viết prompt dài hơn. Cách sửa là thêm đúng mảnh còn thiếu: một đường dẫn ngữ cảnh, một ràng buộc phạm vi, hoặc một tiêu chí nghiệm thu.

Quy Trình Trong Đội

Đội nên có danh mục connector: nguồn nào dùng cho docs, nguồn nào dùng cho issue, nguồn nào chỉ đọc, nguồn nào cho phép ghi. Danh mục này quan trọng ngang tài liệu API.

Với đội mới bắt đầu, đừng đưa Codex vào khâu rủi ro nhất ngay. Hãy bắt đầu ở nơi có phản hồi nhanh: viết test, tạo bản nháp, rà link, chuẩn hóa tài liệu, tạo ảnh minh họa, hoặc chuẩn bị diff nhỏ để con người rà soát.

Bài Tập 30 Phút

1. Chọn một repo, bài viết hoặc màn hình thật để thực hành.
2. Viết một câu mục tiêu cho bài 7, tránh yêu cầu chung chung.
3. Liệt kê đúng ba nguồn context mà Codex nên đọc trước.
4. Ghi hai ràng buộc không được vượt.
5. Viết Done-when bằng bằng chứng có thể kiểm tra.
6. Chạy prompt trong Codex CLI hoặc Codex App.
7. Dừng sau plan đầu tiên và xem Codex có hiểu đúng không.
8. Cho Codex làm phần nhỏ nhất có thể.
9. Đóng gate: Nguồn, Quyền, Timeout, Bằng chứng.
10. Ghi lại một điều nên đưa vào prompt hoặc AGENTS.md cho lần sau.

10 Điều Cần Nhớ

1. MCP là ổ cắm chuẩn cho tool và context.
2. config.toml là nơi lưu cấu hình MCP.
3. STDIO server chạy như tiến trình local.
4. HTTP server cần URL và cơ chế xác thực rõ.
5. OAuth dùng codex mcp login khi server hỗ trợ.
6. Allow list tốt hơn mở toàn bộ tool.
7. Tool có schema giảm copy-paste thủ công.
8. Nguồn động cần dấu thời gian.
9. Quyền ghi ngoài hệ thống cần approval.
10. Không phải mọi nguồn đều đáng làm connector.

Nguồn tham khảo chính: OpenAI Codex documentation. Bài tiếp: Browser, Computer Use và imagegen: khi agent cần nhìn.