2Slides Team
8 min read
Cách Dùng OpenAI Codex Với 2Slides MCP Server (Hướng Dẫn 2026)
Trả lời nhanh (≤60 từ): OpenAI Codex có thể tạo file PowerPoint thật bằng cách thêm 2Slides MCP server vào
~/.codex/config.toml. Lấy key tại 2slides.com/api, rồi thêm một khối[mcp_servers.2slides]chạynpx -y 2slides-mcp@latest(stdio) hoặc một khốiurl = "https://2slides.com/api/mcp?apikey=KEY"(Streamable HTTP). Hoặc chạycodex mcp add 2slides --env API_KEY=xxx -- npx -y 2slides-mcp@latest. Sau đó yêu cầu Codex dựng bộ slide.
OpenAI Codex là agent lập trình CLI mã nguồn mở của OpenAI, và nó là một Model Context Protocol (MCP) client. Kết nối nó với 2Slides MCP server và Codex có thể biến một bản tóm tắt yêu cầu — hoặc một file trong repo của bạn — thành một file .pptx hoàn chỉnh, chỉnh sửa được, tất cả ngay trong terminal.
Hướng dẫn này cung cấp cho bạn các khối config.toml chính xác cho cả hai transport (stdio cục bộ và Streamable HTTP từ xa), lối tắt một dòng codex mcp add, mỗi công cụ 2Slides làm gì, và điểm lưu ý đặc thù theo phiên bản cần để ý với các server HTTP.
Tại sao ghép Codex với 2Slides?
Codex suy luận trên mã và nội dung; nó không tự xuất ra file slide nhị phân. 2Slides MCP server lấp khoảng trống đó. Sự phân chia công việc:
- Codex đọc nguồn của bạn (đặc tả, README, file dữ liệu), lập kế hoạch slide, và quyết định mạch nội dung.
- 2Slides MCP server kết xuất PowerPoint thực sự — Fast PPT dựa trên theme, hoặc slide thiết kế bằng hình ảnh kèm thuyết minh AI tùy chọn và một gói tài nguyên xuất được.
Bạn yêu cầu bằng tiếng Anh đời thường; Codex gọi các công cụ; một link tải về quay lại.
Bạn cần gì trước tiên
- Đã cài Codex CLI (
codexcó trong PATH). - Một 2Slides API key từ 2slides.com/api — trang đó cũng có cấu hình MCP và endpoint Streamable HTTP.
- Node.js cho transport stdio (nó chạy
npx -y 2slides-mcp@latest). Transport HTTP không cần gì cài cục bộ.
Stdio hay Streamable HTTP: chọn transport nào?
2Slides MCP server cung cấp cả hai. Bộ công cụ giống nhau ở cả hai cách — khác biệt là ở chỗ đầu nối chạy ở đâu.
| Stdio Protocol | Streamable HTTP Protocol | |
|---|---|---|
| Chạy ở đâu | Cục bộ qua npx -y 2slides-mcp@latest | Từ xa, do 2Slides host |
| Node.js cục bộ | Bắt buộc | Không bắt buộc |
| Kiểu cấu hình | command + args + env | url (tùy chọn bearer_token_env_var) |
| Phù hợp nhất cho | Dev cục bộ, toàn quyền kiểm soát | Máy từ xa/CI, thiết lập gọn nhẹ |
Dùng stdio trên máy trạm của bạn; dùng Streamable HTTP khi Codex chạy ở nơi bạn không thể cài Node.
Phương pháp 1: stdio trong config.toml
Chỉnh ~/.codex/config.toml và thêm:
[mcp_servers.2slides]
command = "npx"
args = ["-y", "2slides-mcp@latest"]
[mcp_servers.2slides.env]
API_KEY = "YOUR_2SLIDES_API_KEY"Các trường tùy chọn mà Codex hỗ trợ cho server stdio bao gồm cwd, startup_timeout_sec (mặc định 10s), và tool_timeout_sec (mặc định 60s). Nếu bạn muốn truyền một biến môi trường đã có sẵn thay vì gắn key trực tiếp, hãy dùng env_vars = ["API_KEY"].
Hoặc dùng lối tắt codex mcp add
Không cần chỉnh file — lệnh này tự ghi khối cho bạn:
codex mcp add 2slides --env API_KEY=YOUR_2SLIDES_API_KEY -- npx -y 2slides-mcp@latestMọi thứ sau -- là lệnh server. Chạy codex mcp --help để xem danh sách subcommand đầy đủ trên phiên bản bạn đã cài.
Phương pháp 2: Streamable HTTP trong config.toml
Trỏ Codex đến endpoint được host:
[mcp_servers.2slides_remote]
url = "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"Nếu bạn thích xác thực bằng header hơn là key trong query-string, Codex hỗ trợ một biến môi trường bearer-token và các header tĩnh:
[mcp_servers.2slides_remote]
url = "https://2slides.com/api/mcp"
bearer_token_env_var = "TWOSLIDES_TOKEN"Điểm lưu ý theo phiên bản (quan trọng): Codex định tuyến các server HTTP MCP qua MCP client viết bằng Rust của nó. Các phiên bản gần đây tự thiết lập việc này, nhưng một số bản cũ hơn báo lỗi missing field command in mcp_servers cho đến khi bạn bật client thử nghiệm. Nếu chuyện đó xảy ra với bạn, hãy thêm:
[features]
experimental_use_rmcp_client = trueHãy kiểm tra codex --version trước — các bản phát hành mới hơn đã gộp sẵn điều này, và cờ này đang được đổi tên thành [features].rmcp_client. Chỉ dùng khối này như một phương án dự phòng nếu phiên bản của bạn báo lỗi.
Kiểm tra kết nối
codex mcp list # liệt kê các MCP server đã cấu hình
codex mcp get 2slidesHoặc, bên trong TUI của Codex, chạy /mcp để xem các server đang hoạt động và công cụ của chúng. (Các subcommand quản lý codex mcp vẫn đang phát triển; codex mcp --help là nguồn xác thực cho bản build của bạn.)
Tạo bộ slide đầu tiên của bạn
Bạn không gọi công cụ thủ công — bạn chỉ cần yêu cầu:
Read ./docs/launch-plan.md and generate a 10-slide launch deck.
Use a modern, dark business theme from 2slides. Return the
download link when it's done.Codex chạy themes_search để tìm một themeId, rồi slides_generate (Fast PPT), và trả về một downloadUrl — một PowerPoint thật trong khoảng 30–60 giây. Yêu cầu slide thiết kế bằng hình ảnh và nó chuyển sang slides_create_pdf_slides, thăm dò jobs_get cho đến khi file sẵn sàng.
Bộ công cụ của 2Slides MCP
| Công cụ | Chức năng | Credit |
|---|---|---|
themes_search | Tìm một themeId cho Fast PPT | Miễn phí |
slides_generate | PowerPoint dựa trên theme (Fast PPT), đồng bộ/bất đồng bộ | 10 / trang |
slides_create_pdf_slides | Slide tùy biến thiết kế bằng hình ảnh từ văn bản (Nano Banana) | 100 / trang (1K/2K), 200 (4K) |
slides_create_like_this | Slide khớp phong cách của một ảnh tham chiếu | 100 / trang (1K/2K), 200 (4K) |
slides_generate_narration | Thêm thuyết minh giọng AI vào một job Nano Banana | 210 / trang |
slides_download_slides_pages_voices | Xuất các trang + âm thanh thành một file ZIP | Miễn phí |
jobs_get | Thăm dò một job bất đồng bộ đến khi hoàn tất | Miễn phí |
Lỗi thường gặp và xử lý sự cố
missing field command in mcp_serverstrên một server HTTP. Phiên bản Codex của bạn cầnexperimental_use_rmcp_client = truedưới[features]. Hãy nâng cấp Codex, hoặc thêm cờ.- Tiêu đề bảng TOML so với bảng nội tuyến.
[mcp_servers.2slides.env]là một bảng con; nếu bạn viết nội tuyến, hãy ghienv = { API_KEY = "..." }trên dòng server — đừng trộn cả hai kiểu. - Tên server phải duy nhất. Mỗi server được định danh bằng đoạn
[mcp_servers.NAME]; dùng lại một tên sẽ ghi đè khối trước đó. - Không có
.pptxnếu không có công cụ. Codex một mình có thể soạn dàn ý nhưng không thể xuất một PowerPoint. Hãy thêm 2Slides trước. - Timeout công cụ trên các bộ slide lớn. Job lớn hoặc có thuyết minh có thể vượt mặc định 60s của
tool_timeout_sec; hãy tăng nó lên, hoặc để Codex thăm dòjobs_getcho các job bất đồng bộ.
Câu hỏi thường gặp
OpenAI Codex có hỗ trợ MCP server không?
Có. Codex là một MCP client. Bạn cấu hình server trong ~/.codex/config.toml dưới [mcp_servers.NAME], hoặc thêm chúng bằng codex mcp add. Cả server stdio lẫn HTTP từ xa đều được hỗ trợ.
Codex lưu cấu hình MCP ở đâu?
Trong ~/.codex/config.toml (toàn cục). Các project được tin cậy cũng có thể dùng một .codex/config.toml cục bộ theo project. Mỗi MCP server là một bảng [mcp_servers.NAME].
Stdio hay Streamable HTTP?
Stdio chạy npx -y 2slides-mcp@latest trên máy của bạn và là mặc định cho công việc cục bộ. Streamable HTTP trỏ đến endpoint được host https://2slides.com/api/mcp và không cần cài gì — lý tưởng cho CI và môi trường từ xa. Cùng bộ công cụ, cùng kết quả.
Cái này có tạo ra một PowerPoint thật không?
Có — slides_generate trả về một file .pptx chỉnh sửa được. Các công cụ Nano Banana trả về bộ slide thiết kế bằng hình ảnh và có thể thêm thuyết minh AI cùng một gói tài nguyên xuất được.
Tôi lấy key và cấu hình ở đâu?
Tại 2slides.com/api?tab=mcp: API key của bạn, một cấu hình để dán sẵn, và URL endpoint Streamable HTTP.
Điểm mấu chốt
Thêm một khối
[mcp_servers.2slides]vàoconfig.toml(hoặc chạycodex mcp add), và Codex có thêm một công cụ biến mọi bản tóm tắt yêu cầu thành một PowerPoint hoàn chỉnh — mà không cần rời terminal.
Codex là một agent suy luận mạnh; 2Slides là bộ tạo file mà nó còn thiếu. Để có bức tranh lớn hơn, hãy xem cách MCP đang thay đổi quy trình làm slide và bản đồ hệ sinh thái PowerPoint MCP server. Thích agent của Anthropic hơn? Xem cách dùng Claude Code với 2Slides MCP server.
Lấy key của bạn và cấu hình chính xác tại 2slides.com/api?tab=mcp và xuất xưởng bộ slide đầu tiên do Codex tạo ngay hôm nay.
Nguồn:
About 2Slides
Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.
Try For Free
