

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
mcpServersvào~/.gemini/settings.json—command: "npx",args: ["2slides-mcp"],env.API_KEYcho stdio, hoặchttpUrl: "https://2slides.com/api/mcp?apikey=KEY"cho Streamable HTTP. Hoặc chạygemini 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
- Đã cài Gemini CLI (
geminicó trong PATH). - Một 2Slides API key từ 2slides.com/api.
- Node.js cho transport stdio (
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?
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ộc | Không bắt buộc |
| Phù hợp nhất cho | Dev cục bộ | Từ xa/CI, thiết lập gọn nhẹ |
Tên khóa quan trọng: Gemini CLI dùng
httpUrlcho Streamable HTTP vàurlcho SSE cũ. Với endpoint Streamable HTTP của 2Slides, hãy dùnghttpUrl.
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": ["-y", "2slides-mcp@latest"],
"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 -y 2slides-mcp@latest
# 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:
/mcpNó 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ă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ố
- Dùng
urlcho endpoint Streamable HTTP. Gemini CLI coiurllà SSE. DùnghttpUrlcho 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ạigemini mcp add. - Không có
.pptxnế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_getkhoả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—commandcho cục bộ,httpUrlcho 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 slide và bả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