Logo 2Slides
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 -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ìnhcommand / args / envhttpUrl
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": ["-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:

/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_searchTìm một themeId cho Fast PPTMiễn phí
slides_generatePowerPoint dựa trên theme (Fast PPT), đồng bộ/bất đồng bộ10 / trang
slides_create_pdf_slidesSlide 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_thisSlide khớp phong cách của một ảnh tham chiếu100 / trang (1K/2K), 200 (4K)
slides_generate_narrationThêm thuyết minh giọng AI vào một job Nano Banana210 / trang
slides_download_slides_pages_voicesXuất các trang + âm thanh thành một file ZIPMiễn phí
jobs_getThă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 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
2Slides logo

Đại Lý AI Của Bạn Cho Slide. Tiết kiệm thời gian, tỏa sáng nhanh hơn với việc tạo bài thuyết trình thông minh.

Tóm tắt bằng AI

ChatGPTClaudeGrokPerplexity
Tất cả dịch vụ đang hoạt động

© 2026 2slides. Bảo lưu mọi quyền.