Trợ lý AI (MCP)

MCP (Model Context Protocol) là tiêu chuẩn mở mà các trợ lý AI dùng để kết nối với ứng dụng khác. Bạn thêm một địa chỉ vào trợ lý, phê duyệt kết nối một lần, rồi từ đó yêu cầu công việc SEO và nội dung ngay trong cuộc trò chuyện bạn vẫn dùng. Tổng quan về những gì nó mang lại cho bạn có trên trang Máy chủ MCP Semurai.

Bạn có thể làm gì

Hãy viết bằng lời của bạn. Trợ lý sẽ chọn đúng thao tác trong Semurai, làm việc trong không gian làm việc của bạn và cho bạn biết nó đã làm gì. Vài ví dụ cho từng lĩnh vực:

Nghiên cứu SEO

Nghiên cứu từ khóa và từ khóa liên quan, phân tích đối thủ và khoảng trống từ khóa, ai đang xếp hạng cho một truy vấn, tổng quan tên miền, kiểm tra thứ hạng trực tiếp và cụm chủ đề. Xem thêm tại Nghiên cứu từ khóa.

• Tìm từ khóa dài về cà phê cold brew có độ khó thấp.
• Đối thủ của tôi xếp hạng cho những từ khóa nào mà chúng tôi chưa có?
• Xây dựng một cụm chủ đề xoay quanh espresso tại nhà.

Thứ hạng và Search Console

Từ khóa đang theo dõi và lịch sử thứ hạng, thêm từ khóa mới để theo dõi, báo cáo Google Search Console (tổng quan, truy vấn hàng đầu, trang hàng đầu, xu hướng truy vấn và cơ hội), kiểm tra từng trang, kiểm tra toàn bộ trang web và báo cáo hiệu suất.

• Tháng này các từ khóa chúng tôi theo dõi thay đổi thế nào?
• Cho tôi xem các truy vấn trong Search Console có nhiều lượt hiển thị nhưng CTR thấp.
• Kiểm tra SEO toàn bộ trang web của chúng tôi và liệt kê những chỗ cần sửa quan trọng nhất.

Nội dung

Tìm và đọc bài viết, tài liệu, tạo dàn ý, viết bài SEO có chỗ dành sẵn cho hình ảnh, cập nhật nội dung, tạo tài liệu và bản nháp email, lên kế hoạch nội dung và chiến dịch, tìm dịp tiếp thị và nhận gợi ý liên kết nội bộ.

• Viết bài SEO về cách chọn máy xay cà phê, dựa trên nghiên cứu từ khóa của chúng tôi.
• Lên kế hoạch nội dung blog một tháng cho cửa hàng của chúng tôi.
• Gợi ý liên kết nội bộ cho bài viết về máy pha espresso.

Mạng xã hội và lịch

Bản nháp bài đăng mạng xã hội (văn bản), danh sách bài đăng của bạn, lịch nội dung và lên lịch cho nội dung cũng như bài đăng.

• Viết ba bài đăng LinkedIn quảng bá bài viết mới nhất của chúng tôi.
• Tuần sau lịch nội dung có những gì?
• Lên lịch bài đăng LinkedIn về dòng cà phê mùa thu vào thứ Sáu lúc 9:00.

Xuất bản

Xuất bản bài viết lên WordPress, PrestaShop hoặc blog Shoper. Trên WordPress, trợ lý còn có thể xem bài đăng và chuẩn bị, áp dụng hoặc hủy các thay đổi SEO.

• Đăng bài viết về máy xay cà phê lên blog Shoper của chúng tôi.
• Kiểm tra SEO của năm bài WordPress mới nhất và chuẩn bị các chỗ sửa.

Thương mại điện tử

Làm việc với các cửa hàng Shoper, WooCommerce và PrestaShop đã kết nối: tìm sản phẩm và danh mục, chuẩn bị đề xuất SEO cho sản phẩm, danh mục và văn bản thay thế của hình ảnh, áp dụng các đề xuất bạn đã phê duyệt và nhập sản phẩm từ Shoper. Xem thêm tại Cửa hàng.

• Tìm các sản phẩm chưa có meta description và chuẩn bị đề xuất SEO.
• Viết văn bản thay thế cho hình ảnh trong danh mục Máy xay.
• Áp dụng các đề xuất đã phê duyệt vào cửa hàng.

Media và công việc

Tìm trong thư viện media, thêm media từ URL, cập nhật thông tin và sắp xếp thư mục. Xem, tạo và cập nhật công việc, và giao một công việc cho một AI agent của Semurai.

• Chuyển ảnh sản phẩm của tuần trước vào thư mục Chiến dịch mùa xuân.
• Tạo công việc cập nhật bài viết về giá và giao cho Tenko.

Kết nối trợ lý của bạn

Mọi trợ lý đều dùng cùng một địa chỉ máy chủ. Hãy sao chép địa chỉ và làm theo các bước cho trợ lý của bạn. Địa chỉ này cùng hướng dẫn ngắn cũng có trong ứng dụng Semurai, tại Cài đặt → Trợ lý AI (MCP).

https://api.semur.ai/mcp

Claude (web và ứng dụng desktop)

1. Trong Claude, mở Customize → Connectors.
2. Nhấp + Add và chọn Add custom connector.
3. Nhập tên, ví dụ Semurai, dán địa chỉ máy chủ rồi nhấp Continue, sau đó nhấp Add.
4. Nhấp Connect và phê duyệt kết nối trên trang Semurai.

Với gói Claude Team và Enterprise, Owner của tổ chức thêm connector một lần trong Organization settings → Connectors → Add → Custom → Web. Sau đó các thành viên nhấp Connect và đăng nhập tài khoản Semurai của riêng mình. Với gói Free, bạn có thể thêm một connector tùy chỉnh. Claude có thể làm gì với Semurai, kèm prompt mẫu: Claude cho SEO.

ChatGPT

1. Trong ChatGPT trên web, mở Plugins rồi nhấp +.
2. Chọn Add custom MCP server, nhập tên rồi dán địa chỉ máy chủ.
3. Ở phần xác thực, chọn OAuth, đánh dấu I understand and want to continue rồi nhấp Create.
4. Phê duyệt kết nối trên trang Semurai.

Thao tác đầy đủ (ghi) trong ChatGPT: gói Business, Enterprise và Edu. Với gói Pro, máy chủ MCP tùy chỉnh kết nối ở chế độ chỉ đọc. Máy chủ MCP tùy chỉnh được thêm trong ChatGPT trên web. Các trường hợp sử dụng và prompt để thử có tại ChatGPT cho SEO.

Claude Code

Chạy lệnh này trong terminal:

claude mcp add --transport http --scope user semurai https://api.semur.ai/mcp

Tùy chọn --scope user thêm Semurai vào mọi dự án của bạn. Sau đó đăng nhập Semurai bằng claude mcp login semurai, hoặc gõ /mcp trong Claude Code. Làm SEO ngay từ terminal, kèm ví dụ: Claude Code cho SEO.

Codex

Chạy lệnh này trong terminal:

codex mcp add semurai --url https://api.semur.ai/mcp

Sau đó đăng nhập Semurai bằng codex mcp login semurai. Bạn cũng có thể thêm máy chủ vào ~/.codex/config.toml:

[mcp_servers.semurai]
url = "https://api.semur.ai/mcp"

Tiện ích Codex cho IDE và ứng dụng Codex trên máy tính dùng chung cấu hình này. Ở đó bạn cũng có thể thêm máy chủ trong Settings → MCP servers → Add server, với loại Streamable HTTP. Tìm hiểu thêm về cách làm việc với Semurai trong Codex: Codex MCP.

Cursor

Thêm máy chủ vào ~/.cursor/mcp.json để dùng cho mọi dự án, hoặc vào .cursor/mcp.json trong một dự án:

{
  "mcpServers": {
    "semurai": {
      "url": "https://api.semur.ai/mcp"
    }
  }
}

Đăng nhập vào Semurai khi Cursor yêu cầu. Những gì bạn có thể yêu cầu trong Cursor: Cursor MCP.

VS Code (GitHub Copilot)

Ở chế độ agent, GitHub Copilot dùng các máy chủ trong .vscode/mcp.json của dự án:

{
  "servers": {
    "semurai": {
      "type": "http",
      "url": "https://api.semur.ai/mcp"
    }
  }
}

Nhấp Start phía trên máy chủ trong tệp và đăng nhập vào Semurai. Ví dụ cho Copilot ở chế độ agent: VS Code MCP.

Trợ lý khác

Mọi trợ lý hỗ trợ máy chủ MCP từ xa với đăng nhập OAuth đều kết nối theo cách tương tự: thêm https://api.semur.ai/mcp làm địa chỉ máy chủ.

Gemini CLI: thêm máy chủ bằng lệnh này, rồi đăng nhập bằng /mcp auth semurai trong Gemini CLI.

gemini mcp add --transport http semurai https://api.semur.ai/mcp

Trong tệp settings.json của Gemini CLI, địa chỉ nằm ở khóa httpUrl:

{
  "mcpServers": {
    "semurai": {
      "httpUrl": "https://api.semur.ai/mcp"
    }
  }
}

Máy chủ đầy đủ có đồ họa AI

Địa chỉ ở trên là máy chủ chính thức, dành cho danh mục ứng dụng của Claude và ChatGPT và công việc hằng ngày. Semurai còn có máy chủ đầy đủ: cùng cách đăng nhập và cùng công cụ, thêm vào đó là đồ họa AI. Bạn tự thêm máy chủ này làm connector riêng, với địa chỉ sau:

https://api.semur.ai/mcp/full

Với máy chủ đầy đủ, trợ lý của bạn còn có thể:

• tạo hình ảnh cho bài đăng mạng xã hội và bài viết,
• tạo thiết kế trong Canvas,
• tạo thiết kế trong Creative Studio,
• làm việc với các thiết kế Creative Studio của bạn: chọn chế độ, trả lời câu hỏi của nhà thiết kế, chỉnh sửa thiết kế và quay lại phiên bản trước hoặc một biến thể,
• lưu đồ họa mạng xã hội, băng chuyền ảnh và quảng cáo từ Creative Studio vào thư viện phương tiện rồi gắn chúng vào bài đăng mạng xã hội,
• gợi ý ý tưởng thiết kế cho thương hiệu của bạn,
• viết mô tả AI và văn bản thay thế cho hình ảnh trong thư viện phương tiện của bạn.

Thêm máy chủ đầy đủ

• Claude: trong Customize → Connectors, nhấp + Add, chọn Add custom connector rồi dán địa chỉ máy chủ đầy đủ.
• ChatGPT: trong Plugins, nhấp +, chọn Add custom MCP server rồi dán địa chỉ máy chủ đầy đủ.
• Cursor và VS Code: dùng cùng tệp mcp.json như ở trên, với địa chỉ máy chủ đầy đủ.

Trong Claude Code, chạy:

claude mcp add --transport http --scope user semurai-full https://api.semur.ai/mcp/full

Trong Codex, chạy:

codex mcp add semurai-full --url https://api.semur.ai/mcp/full

Kết nối đã phê duyệt cho máy chủ chính thức hoạt động với máy chủ chính thức. Để dùng máy chủ đầy đủ, hãy thêm nó thành một connector riêng và phê duyệt kết nối trên trang Semurai. Trong Claude Code và Codex, đăng nhập bằng claude mcp login semurai-full hoặc codex mcp login semurai-full. Đồ họa tạo qua máy chủ đầy đủ được tính vào giới hạn sử dụng của không gian làm việc, giống như đồ họa tạo trong ứng dụng.

Kết nối lần đầu và không gian làm việc

Ở lần kết nối đầu tiên, trợ lý mở một trang Semurai. Đăng nhập nếu bạn chưa đăng nhập, rồi:

1. Kiểm tra tên ứng dụng và địa chỉ mà trình duyệt sẽ quay về. Cả hai đều hiện trên trang.
2. Chọn Không gian làm việc mặc định.
3. Nhấp Cho phép. Trình duyệt đưa bạn trở lại trợ lý, sẵn sàng làm việc.

Trợ lý làm việc trong không gian làm việc mặc định. Khi bạn yêu cầu, trợ lý liệt kê các không gian làm việc khác, làm việc trong bất kỳ không gian nào và đổi không gian mặc định, ví dụ: Tôi có những không gian làm việc nào? Chuyển sang không gian làm việc của cửa hàng.

Các việc dài hơn chạy ở chế độ nền: viết bài, kiểm tra toàn bộ trang web, kế hoạch nội dung, bài đăng mạng xã hội hoặc cụm chủ đề. Trợ lý theo dõi tiến độ và mang kết quả về khi đã xong. Bản nháp xuất hiện trong ứng dụng Semurai: trong Thư viện, lịch nội dung và bài đăng mạng xã hội của bạn.

Quản lý và ngắt kết nối

Trong ứng dụng Semurai, mở Cài đặt → Trợ lý AI (MCP). Tại đây bạn có:

• cả hai địa chỉ máy chủ (chính thức và đầy đủ) kèm nút sao chép và hướng dẫn ngắn cho từng trợ lý,
• các ứng dụng đã kết nối, kèm ngày kết nối và lần dùng gần nhất,
• không gian làm việc mặc định của từng ứng dụng, có thể đổi bất cứ lúc nào,
• Ngắt kết nối, giúp chấm dứt quyền truy cập của ứng dụng ngay lập tức.

Để dùng lại một trợ lý đã ngắt kết nối, hãy kết nối lại từ chính trợ lý đó.

An toàn và giới hạn sử dụng

• Bạn xác nhận những gì rời khỏi Semurai. Xuất bản hoặc lên lịch bên ngoài Semurai (WordPress, blog PrestaShop hoặc Shoper, mạng xã hội) và áp dụng thay đổi cho cửa hàng hay trang WordPress là các thao tác riêng, và trợ lý sẽ hỏi bạn xác nhận từng thao tác.
• Thay đổi cửa hàng bắt đầu bằng đề xuất. Thay đổi SEO cho sản phẩm, danh mục và hình ảnh được tạo trước dưới dạng đề xuất, và chỉ những đề xuất bạn phê duyệt mới được đưa vào cửa hàng.
• Vai trò của bạn được áp dụng. Trợ lý làm việc theo vai trò của bạn trong từng không gian làm việc. Với vai trò Người xem, trợ lý chỉ có thể đọc thông tin cơ bản của không gian làm việc.
• Cùng một giới hạn sử dụng. Thao tác của trợ lý được tính vào cùng giới hạn sử dụng như công việc của bạn trong ứng dụng.

Khắc phục sự cố

• Liên kết kết nối đã hết hạn: trang phê duyệt có hiệu lực trong 10 phút. Hãy bắt đầu kết nối lại từ trợ lý.
• Trợ lý báo đã mất quyền truy cập: hãy kết nối lại. Tại Cài đặt → Trợ lý AI (MCP), bạn có thể kiểm tra xem ứng dụng có bị ngắt kết nối không.
• Đã dùng hết giới hạn sử dụng: hãy chờ đến khi giới hạn được làm mới rồi yêu cầu lại.
• Một công cụ báo tích hợp chưa được kết nối: hãy kết nối Google Search Console, WordPress hoặc cửa hàng tại Cài đặt → Tích hợp, rồi yêu cầu lại. Xem Kết nối website hoặc cửa hàng của bạn.

Tiếp theo

• Tích hợpKết nối Search Console, WordPress và cửa hàng của bạn.
• Thư việnXem lại các bản nháp trợ lý đã tạo.
• Lịch nội dungBài viết và bài đăng đã lên lịch ở cùng một nơi.
• AI agentLàm quen với các AI agent của Semurai và công việc họ đảm nhận.
• Máy chủ MCP SemuraiMỗi trợ lý có thể làm gì với Semurai, kèm prompt mẫu.