Cách sửa `MCP startup incomplete (failed: node_repl)` trong Codex CLI

TL;DR: Có hai đường sửa hợp lệ. Nếu bạn chỉ dùng terminal Codex, gỡ entry stale bằng codex mcp remove node_repl. Nếu bạn cần desktop/runtime liên quan, chạy codex app để cài hoặc mở Codex App rồi kiểm tra lại.

Bài trước giải thích vì sao lỗi này thường là lỗi cấu hình cục bộ. Bài này đi thẳng vào thao tác. Mục tiêu là đưa Codex startup về trạng thái sạch mà không chạm linh tinh vào repo.

Bước 1: xác nhận node_repl đang được đăng ký thế nào

Trước khi xóa hay cài lại gì, xem Codex đang hiểu node_repl ra sao:

codex mcp get node_repl
codex mcp list
codex doctor --summary

Bạn đang tìm ba tín hiệu:

• node_repl thật sự tồn tại trong danh sách MCP.
• command của nó đang trỏ tới một path không còn trên máy.
• codex doctor cũng báo không resolve được command đó.

Nếu ba tín hiệu này cùng xuất hiện, bạn không cần đào thêm vào repo nữa.

Đường A: bạn chỉ dùng Codex trong terminal

Đây là đường ngắn nhất nếu node_repl chỉ là tàn dư của một thiết lập cũ và bạn không cần phần app integration đó.

Chạy:

codex mcp remove node_repl
codex mcp list
codex doctor --ascii --summary

Nếu node_repl biến mất khỏi codex mcp list và codex doctor không còn báo failure cho server này, bạn gần như đã xong. Đóng phiên Codex cũ và mở lại.

Đây là lý do tôi ưu tiên codex mcp remove hơn sửa tay config: lệnh này nằm ngay trong bề mặt CLI quản lý MCP, nên ít rủi ro bỏ sót hơn.

Đường B: bạn muốn giữ desktop/app integration

Nếu bạn vẫn cần server đó, đừng gỡ vội. Hãy đưa runtime mà node_repl phụ thuộc vào trở lại:

codex app

Trên CLI đang có trong máy kiểm tra của bài viết này, codex app --help cho thấy lệnh này dùng để mở desktop app và sẽ gọi installer nếu app đang thiếu. Đây là dấu hiệu tốt: nếu config của bạn trỏ vào binary nằm trong Codex.app, việc cài hoặc khôi phục app là hướng sửa hợp lý.

Sau khi app được cài hoặc mở lại:

codex mcp get node_repl
codex doctor --ascii --summary

Nếu path cũ nay đã tồn tại và doctor hết lỗi, bạn giữ được cả terminal workflow lẫn integration đi kèm.

Cách chọn nhanh giữa đường A và đường B

Chọn codex mcp remove node_repl khi:

• bạn chỉ dùng Codex trong terminal;
• bạn không biết node_repl dùng để làm gì và không thấy thiếu tính năng nào ngoài cảnh báo;
• Codex.app không còn trên máy và bạn không muốn cài lại.

Chọn codex app khi:

• bạn chủ động dùng desktop app;
• config của node_repl rõ ràng phụ thuộc path dưới Codex.app;
• bạn muốn giữ nguyên luồng tích hợp đã có.

Bước xác minh sau khi sửa

Đừng dừng ở “có vẻ đã xong”. Chạy checklist ngắn:

codex mcp list
codex doctor --ascii --summary
codex --version

Rồi mở lại Codex trong terminal và quan sát startup. Kết quả tốt là:

• không còn node_repl failed to start;
• không còn MCP startup incomplete (failed: node_repl);
• các lệnh Codex cơ bản vẫn hoạt động như cũ.

Nếu bạn buộc phải kiểm tra config tay

Đây là phương án dự phòng, không phải đường chính. Dùng khi codex mcp remove không chạy được hoặc config bị lệch bất thường.

Tìm block liên quan:

rg -n 'node_repl|mcp_servers' ~/.codex/config.toml

Nếu bạn thấy một block node_repl với command trỏ vào một path dưới /Applications/Codex.app/.../node_repl, trong khi app không còn trên máy, đó chính là stale entry. Lúc ấy có hai lựa chọn sạch:

• xóa block đó bằng công cụ quản lý MCP nếu CLI vẫn dùng được;
• hoặc cài lại app để path trở nên hợp lệ.

Tôi không khuyên sửa tay trước, vì file config thường còn chứa các server khác và biến môi trường mà bạn không muốn đụng sai.

Những đường sửa sai hướng

Khi gặp lỗi này, nhiều người mất thời gian ở các việc gần như không liên quan:

• cài lại Node.js toàn hệ thống;
• npm install trong repo đang mở;
• xoá cache build của project;
• đổi branch;
• nghi Git hook hoặc CI.

Những bước đó không làm xuất hiện lại một file đang thiếu dưới /Applications/Codex.app/....

Một phiên sửa mẫu, gọn và đủ

Đây là flow tôi sẽ dùng nếu chính máy tôi gặp lại lỗi:

codex mcp get node_repl
find /Applications ~/Applications -maxdepth 2 -name 'Codex.app' 2>/dev/null
codex mcp remove node_repl
codex doctor --ascii --summary

Nếu tôi thực sự cần desktop app:

codex app
codex doctor --ascii --summary

Chốt lại: đừng sửa nhiều hơn nhu cầu. Nếu terminal workflow là đủ, gỡ entry stale là xong. Nếu bạn cần runtime của app, khôi phục app là xong.

Đọc tiếp sau khi đã sửa xong

Sau khi cảnh báo biến mất, phần quan trọng hơn là đừng để lần sau quay lại vòng đoán mò cũ. Tôi khuyên nối bài này với các tài liệu sau:

• Codex CLI báo node_repl failed to start: đây là lỗi gì?
• Dùng codex doctor, codex mcp và config.toml để tự chẩn đoán Codex CLI
• Kiểm tra tình trạng PR sau merge: merged ≠ live
• Workflow 30 phút mỗi ngày: sửa bug và tạo PR với OpenCode
• Dùng OpenCode an toàn: không để AI phá repo hoặc lộ token
• Chuyên mục Công nghệ

Nếu bạn muốn tự chẩn đoán các lỗi Codex tương tự trong tương lai, đọc tiếp bài Dùng codex doctor, codex mcp và config.toml để tự chẩn đoán Codex CLI. Còn nếu bạn mới vào series này, bài giải thích root cause của node_repl failed to start sẽ cho bạn bức tranh tổng thể trước khi ra lệnh.