2Slides Logo
Cách Dùng Gemini CLI Với 2Slides MCP Server (Hướng Dẫn 2026)
2Slides Team
7 min read

Cách Dùng Gemini CLI Với 2Slides MCP Server (Hướng Dẫn 2026)

Trả lời nhanh (≤60 từ): Gemini CLI của Google có thể tạo file PowerPoint thật qua 2Slides MCP server. Lấy key tại 2slides.com/api, rồi thêm một mục

mcpServers
vào
~/.gemini/settings.json
command: "npx"
,
args: ["2slides-mcp"]
,
env.API_KEY
cho stdio, hoặc
httpUrl: "https://2slides.com/api/mcp?apikey=KEY"
cho Streamable HTTP. Hoặc chạy
gemini mcp add
. Sau đó yêu cầu Gemini dựng bộ slide.

Gemini CLI là agent AI terminal mã nguồn mở của Google, và nó hỗ trợ Model Context Protocol (MCP). Kết nối nó với 2Slides MCP server và Gemini có thể biến một prompt — hoặc một file trong thư mục làm việc của bạn — thành một file

.pptx
hoàn chỉnh, chỉnh sửa được.

Hướng dẫn này cung cấp các khối

settings.json
chính xác cho cả hai transport (stdio cục bộ và Streamable HTTP từ xa), lối tắt
gemini mcp add
, và mỗi công cụ 2Slides làm gì.

Tại sao kết nối Gemini CLI với 2Slides?

Gemini là một bộ suy luận đa phương thức mạnh mẽ, nhưng nó không tự xuất ra file

.pptx
nhị phân. 2Slides MCP server là bộ tạo chuyên dụng:

  • Gemini CLI đọc nguồn của bạn, lập kế hoạch slide, và viết câu chữ.
  • 2Slides MCP server kết xuất PowerPoint thật — 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 xuất được.

Bạn cần gì trước tiên

  1. Đã cài Gemini CLI (
    gemini
    có trong PATH).
  2. Một 2Slides API key từ 2slides.com/api.
  3. Node.js cho transport stdio (
    npx 2slides-mcp
    ). Transport HTTP không cần gì cài cục bộ.

Stdio hay Streamable HTTP: chọn transport nào?

Cả hai phơi bày cùng bộ công cụ; khác biệt là khóa cấu hình và chỗ đầu nối chạy.

Stdio (cục bộ)Streamable HTTP (từ xa)
Khóa cấu hình
command
/
args
/
env
httpUrl
Node.js cục bộBắt buộcKhông bắt buộc
Phù hợp nhất choDev cục bộTừ xa/CI, thiết lập gọn nhẹ

Tên khóa quan trọng: Gemini CLI dùng

httpUrl
cho Streamable HTTP và
url
cho SSE cũ. Với endpoint Streamable HTTP của 2Slides, hãy dùng
httpUrl
.

Phương pháp 1: stdio trong settings.json

Gemini CLI đọc

~/.gemini/settings.json
(toàn cục) và
.gemini/settings.json
(project). Thêm một khối
mcpServers
:

{ "mcpServers": { "2slides": { "command": "npx", "args": ["2slides-mcp"], "env": { "API_KEY": "YOUR_2SLIDES_API_KEY" } } } }

Giá trị

env
cũng có thể tham chiếu biến shell (ví dụ
"API_KEY": "$TWOSLIDES_API_KEY"
) nếu bạn không muốn gắn key trực tiếp.

Phương pháp 2: Streamable HTTP trong settings.json

Với endpoint được host, dùng

httpUrl
:

{ "mcpServers": { "2slides-remote": { "httpUrl": "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY" } } }

Thích xác thực bằng header? Thêm một đối tượng

headers
:
"headers": { "Authorization": "Bearer YOUR_2SLIDES_API_KEY" }
.

Hoặc dùng lệnh
gemini mcp add

# stdio (-e sets env vars) gemini mcp add -e API_KEY=YOUR_2SLIDES_API_KEY 2slides npx 2slides-mcp # Streamable HTTP gemini mcp add --transport http 2slides-remote "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"

Những lệnh này ghi cùng các mục

mcpServers
vào
settings.json
. Các cờ bao gồm
-t, --transport
(stdio | sse | http),
-e, --env
,
-H, --header
, và
--timeout
.

Kiểm tra kết nối

Bên trong một phiên

gemini
tương tác, chạy:

/mcp

Nó hiển thị trạng thái của từng server (CONNECTED / CONNECTING / DISCONNECTED) và các công cụ được phát hiện. Dùng

/mcp auth
nếu một server từ xa yêu cầu OAuth.

Tạo bộ slide đầu tiên của bạn

Chỉ cần yêu cầu:

Read ./notes/market-update.md and generate a 9-slide briefing. Find a professional theme from 2slides, build the PowerPoint, and give me the download link.

Gemini CLI chạy

themes_search
slides_generate
(Fast PPT) → trả về
downloadUrl
. Với slide tùy biến thiết kế bằng hình ảnh, nó dùng
slides_create_pdf_slides
và thăm dò
jobs_get
cho đến khi bộ slide 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ố

  • Dùng
    url
    cho endpoint Streamable HTTP.
    Gemini CLI coi
    url
    là SSE. Dùng
    httpUrl
    cho Streamable HTTP của 2Slides.
  • Server hiện DISCONNECTED trong
    /mcp
    .
    Kiểm tra API key, và với stdio xác nhận Node.js đã được cài.
  • Không liệt kê công cụ nào. Khởi động lại phiên sau khi chỉnh
    settings.json
    , hoặc chạy lại
    gemini mcp add
    .
  • Không có
    .pptx
    nếu không có công cụ.
    Gemini một mình soạn dàn ý; 2Slides tạo ra file.
  • Thăm dò dồn dập. Hãy để Gemini thăm dò
    jobs_get
    khoảng mỗi 20 giây cho các job bất đồng bộ Nano Banana / thuyết minh.

Câu hỏi thường gặp

Gemini CLI có hỗ trợ MCP server không?

Có. Gemini CLI là một MCP client. Cấu hình server dưới

mcpServers
trong
~/.gemini/settings.json
, hoặc thêm chúng bằng
gemini mcp add
. Cả ba transport stdio, SSE và Streamable HTTP đều được hỗ trợ.

Khóa cấu hình cho một server Streamable HTTP là gì?

httpUrl
. Chỉ dùng
url
cho server SSE cũ. Endpoint Streamable HTTP của 2Slides đặt trong
httpUrl
.

Gemini CLI lưu cấu hình MCP ở đâu?

~/.gemini/settings.json
(toàn cục) hoặc
.gemini/settings.json
(project). Khối MCP là khóa cấp cao nhất
mcpServers
.

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 kèm thuyết minh AI tùy chọn.

Tôi lấy key và cấu hình ở đâu?

Tại 2slides.com/api?tab=mcp: 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

Một mục

mcpServers
command
cho cục bộ,
httpUrl
cho từ xa — biến Gemini CLI thành một bộ tạo slide. Kiểm tra bằng
/mcp
, rồi chỉ cần yêu cầu một bộ slide.

Để có bức tranh rộng 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. Làm việc trong một agent terminal khác? Xem Claude Code, OpenAI Codex, và Qwen Code với cùng server này.

Lấy key và cấu hình của bạn tại 2slides.com/api?tab=mcp và tạo bộ slide đầu tiên từ Gemini CLI trong chưa đầy một phút.

Nguồn:

About 2Slides

Create stunning AI-powered presentations in seconds. Transform your ideas into professional slides with 2slides AI Agent.

Try For Free