2Slides Logo
Cách Dùng OpenAI Codex Với 2Slides MCP Server (Hướng Dẫn 2026)
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ạy
npx 2slides-mcp
(stdio) hoặc một khối
url = "https://2slides.com/api/mcp?apikey=KEY"
(Streamable HTTP). Hoặc chạy
codex mcp add 2slides --env API_KEY=xxx -- npx 2slides-mcp
. 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

  1. Đã cài Codex CLI (
    codex
    có trong PATH).
  2. Một 2Slides API key từ 2slides.com/api — trang đó cũng có cấu hình MCP và endpoint Streamable HTTP.
  3. Node.js cho transport stdio (nó chạy
    npx 2slides-mcp
    ). 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 ProtocolStreamable HTTP Protocol
Chạy ở đâuCục bộ qua
npx 2slides-mcp
Từ xa, do 2Slides host
Node.js cục bộBắt buộcKhô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 choDev cục bộ, toàn quyền kiểm soátMá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 = ["2slides-mcp"] [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 2slides-mcp

Mọ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 = true

Hã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 2slides

Hoặ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ăngCredit
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ếu100 / trang (1K/2K), 200 (4K)
slides_generate_narration
Thêm thuyết minh giọng AI vào một job Nano Banana210 / trang
slides_download_pages_voices
Xuất các trang + âm thanh thành một file ZIPMiễn phí
jobs_get
Thăm dò một job bất đồng bộ đến khi hoàn tấtMiễn phí

Lỗi thường gặp và xử lý sự cố

  • missing field command in mcp_servers
    trên một server HTTP.
    Phiên bản Codex của bạn cần
    experimental_use_rmcp_client = true
    dướ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 ghi
    env = { 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ó
    .pptx
    nế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_get
    cho 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 2slides-mcp
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ào
config.toml
(hoặc chạy
codex 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 slidebả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