Ưu tiên runtime-native
Nếu tool đã hiện trong phiên làm việc, tránh setup client thêm và gọi trực tiếp capability đang thấy.
Ctrl K
Tóm tắt nhanh / Lệnh
Bộ Marketing
/ak:use-mcp
Chạy tool MCP đã có
Khám phá và chạy MCP server tool bằng đường hẹp an toàn nhất: ưu tiên tool có sẵn trong runtime, dùng script trực tiếp khi cần.
01
Chọn đường chạy
02
Tìm tool native
03
Chọn tối thiểu
04
Fallback bằng script
Nguyên tắc 01
Dùng MCP native trong runtime khi thấy được; đây là đường ít setup và ít tốn context nhất.
Nguyên tắc 02
Dùng script trực tiếp khi cần tên tool, schema rõ ràng hoặc server không đăng ký trong runtime hiện tại.
Nguyên tắc 03
Phải khám phá capability trước khi thực thi.
Nguyên tắc 04
Dùng MCP server khác với tạo server MCP; mcp-builder không phải fallback.
Bản đồ thực thi
Các nhánh chính từ đầu vào đến kết quả, bám theo cách command chạy khi dùng thật.
01
Khởi động
Đầu vào, phạm vi, route
- 1 Chọn đường chạy Chọn giữa MCP native trong runtime và script trực tiếp dựa trên việc runtime hiện tại đã có server/tool cần dùng hay chưa.
- 2 Tìm tool native Kiểm tra resource và tool đang thấy trong Claude Code, Codex hoặc Pi; dùng đúng tên hiện có thay vì giả định tên giống nhau.
02
Xử lý
Agent / skill thực thi
- 3 Chọn tối thiểu Chọn tool nhỏ nhất giải quyết trực tiếp yêu cầu và xác thực tham số bắt buộc trước khi chạy.
- 4 Fallback bằng script Nếu server chỉ có trong .claude/.mcp.json hoặc cần schema xác định, cài dependency cho scripts rồi dùng lệnh list/call của cli.ts.
03
Kiểm chứng
Gate, review, xác thực
- 5 Lập catalog Chạy list-tools để lưu assets/tools.json kèm schema, rồi đọc catalog đó trước khi gọi tool chưa rõ.
- 6 Thực thi Gọi MCP tool đã chọn với JSON args hợp lệ, xử lý timeout và cleanup lifecycle qua script client khi áp dụng.
04
Đóng
Báo cáo, bàn giao, artifact
- 7 Xử lý giới hạn Với việc cần cookie/profile Chrome, gọi ak:chrome-profile trước; không dùng mcp-builder làm fallback để tiêu thụ server sẵn có.
- 8 Báo cáo Nêu rõ đã dùng đường nào, tìm thấy capability gì, đã chạy gì và lưu ý nào về khả năng nhìn thấy server.
Tính năng đặc biệt
Script trực tiếp
Dùng client đi kèm cho server chỉ khai báo trong .claude/.mcp.json hoặc workflow script cần tái lập.
Prompt mẫu
Ví dụ gọi command theo từng flag, subcommand, mode hoặc route dùng được trong workflow thực tế.
Khám phá tool Khuyến nghị
/ak:use-mcp khám phá các công cụ tự động hóa trình duyệt có sẵn- Dùng khi:
- Dùng khi cần biết capability MCP nào đang có trước khi chọn tool.
- Kết quả:
- Catalog tối thiểu các tool liên quan và yêu cầu tham số.
Thực thi có kiểm soát
/ak:use-mcp gọi công cụ danh sách nguồn notebook cho dự án này- Dùng khi:
- Dùng khi tác vụ cần chạy an toàn một capability MCP cụ thể.
- Kết quả:
- Đường gọi MCP đã xác thực kèm kết quả hoặc lưu ý về visibility.
Catalog MCP của project
/ak:use-mcp khám phá các công cụ từ .claude/.mcp.json cho dự án này- Dùng khi:
- Runtime không hiện server nhưng project có MCP config.
- Kết quả:
- Dùng đường catalog script với .claude/.mcp.json, không chép credential sang runtime khác.
Phạm vi xử lý
- Khám phá MCP tool
- Thực thi tool có kiểm schema
- Workflow client script trực tiếp
- Catalog tool lưu lâu dài
- Lưu ý về khả năng nhìn thấy của runtime