Connect Profound CMS to your AI client

Profound CMS cung cấp một máy chủ MCP từ xa, cho phép các ứng dụng AI tương thích khám phá, tạo, cập nhật, xuất bản và quản lý nội dung CMS.

Điểm cuối MCP:

http://107.21.107.99:8081/mcp

Trong môi trường production, hãy sử dụng phiên bản HTTPS của URL MCP đã cấu hình bất cứ khi nào có thể.

Xác thực

Profound CMS MCP sử dụng WorkOS OAuth.

Để kết nối:

1. Tạo tài khoản Profound CMS.
2. Xác nhận rằng tài khoản của bạn thuộc đúng tổ chức.
3. Thêm máy chủ MCP vào ứng dụng AI của bạn.
4. Hoàn tất đăng nhập trên trình duyệt khi được yêu cầu.

Bạn không cần sao chép khóa API vào ứng dụng AI. Sau khi đăng nhập, ứng dụng sẽ nhận được một access token có thời hạn ngắn và tự động làm mới token đó.

Vai trò CMS của bạn kiểm soát quyền truy cập:

• Thành viên có thể đọc nội dung CMS.
• Biên tập viên và quản trị viên có thể tạo, cập nhật và xuất bản nội dung.

Claude Code

Chạy:

claude mcp add --transport http Profound http://107.21.107.99:8081/mcp

Sau đó khởi động Claude Code và hoàn tất quy trình xác thực trên trình duyệt.

Xác minh kết nối:

claude mcp list

Codex CLI

Chạy:

codex mcp add Profound --url http://107.21.107.99:8081/mcp

Codex sẽ yêu cầu xác thực khi máy chủ được sử dụng lần đầu.

Bạn có thể xác minh kết nối bằng lệnh:

codex mcp list

OpenCode

Thêm nội dung sau vào:

~/.config/opencode/opencode.json

{
  "mcp": {
    "profound": {
      "type": "remote",
      "url": "http://107.21.107.99:8081/mcp",
      "enabled": true,
      "oauth": {}
    }
  }
}

Sau đó xác thực:

opencode mcp auth profound

Xác minh kết nối:

opencode mcp list

Máy chủ sẽ được hiển thị là đã kết nối thông qua OAuth.

Cursor, Windsurf và các ứng dụng MCP khác

Hầu hết các ứng dụng tương thích với MCP đều hỗ trợ cấu hình HTTP từ xa tiêu chuẩn:

{
  "mcpServers": {
    "profound": {
      "url": "http://107.21.107.99:8081/mcp"
    }
  }
}

Trong Cursor, Windsurf, Claude Desktop hoặc một ứng dụng MCP khác:

1. Mở phần cài đặt MCP hoặc tích hợp.
2. Thêm máy chủ MCP HTTP từ xa.
3. Sử dụng URL MCP của Profound.
4. Bật xác thực OAuth nếu ứng dụng cung cấp tùy chọn OAuth.
5. Hoàn tất đăng nhập Profound CMS trong trình duyệt.

Ứng dụng phải hỗ trợ Streamable HTTP MCP và OAuth. Các ứng dụng chỉ hỗ trợ máy chủ cục bộ hoặc khóa API tĩnh không thể xác thực trực tiếp với máy chủ này.

Bắt đầu mỗi phiên bằng việc khám phá

Sau khi kết nối, hãy yêu cầu ứng dụng AI khám phá các tổ chức và website mà bạn có quyền truy cập:

Chỉ sử dụng máy chủ Profound MCP.

Trước tiên hãy gọi list_my_organizations.
Sau đó gọi list_organizations.
Sử dụng ID tổ chức được list_organizations trả về để gọi list_websites.

Hiển thị tên tổ chức, tên website và ID website trong một bảng.

Mọi thao tác CMS đều yêu cầu một website_id.

Các công cụ khả dụng

Máy chủ MCP hiện cung cấp 35 công cụ CMS.

Tổ chức và website

• list_my_organizations
• list_organizations
• list_websites

Trang

• create_page
• update_page
• delete_page
• get_page
• list_pages

Liên kết route

• create_route_binding
• update_route_binding
• delete_route_binding
• get_route_binding
• list_route_bindings

Liên kết route kết nối các trang mẫu với nội dung hoặc giá trị tham số cụ thể.

Component

• create_component
• update_component
• delete_component
• list_components

Component định nghĩa các loại nội dung có thể tái sử dụng và các trường của chúng.

Block

• create_block
• update_block
• delete_block
• get_block
• list_blocks
• publish_block

Block là các thực thể nội dung được đặt trên trang.

Trường động và biểu thức Template Builder

• set_block_field_expression
• set_block_field_expressions
• list_block_field_expressions
• delete_block_field_expression

Các công cụ này quản lý các biểu thức fx động, dùng để tính toán giá trị trường tại thời điểm render.

Tài liệu và biến thể

• create_document
• update_document
• delete_document
• get_document
• list_documents

Tài liệu là các mục nội dung có thể tái sử dụng, còn được gọi là biến thể. list_documents trả về siêu dữ liệu; sử dụng get_document để lấy toàn bộ nội dung.

Bản dịch

• list_document_translations
• upsert_document_translation
• delete_document_translation

Bản dịch nên được lưu dưới dạng các hàng locale trong một tài liệu duy nhất thay vì tạo một tài liệu riêng cho mỗi ngôn ngữ.

Quy trình CMS điển hình

Một quy trình nội dung hoàn chỉnh thường gồm các bước sau:

1. Khám phá các tổ chức và website.
2. Kiểm tra các component, trang, block và tài liệu hiện có.
3. Tạo hoặc cập nhật nội dung cần thiết.
4. Sử dụng expected_version khi cập nhật block, component hoặc tài liệu.
5. Xuất bản block hoặc tài liệu.
6. Đặt trạng thái trang thành Live.
7. Xác minh nội dung đã xuất bản.

Một trang chỉ hiển thị công khai khi ở trạng thái live và nội dung của trang đã được xuất bản.

Ví dụ câu lệnh

Tạo một trang:

Sử dụng Profound CMS, tạo một trang tại /pricing cho website <website_id>.
Tạo các block cần thiết, xuất bản chúng và đặt trang thành Live.

Cập nhật nội dung hiện có:

Tìm trang chủ của website <website_id>.
Đọc các block hiện tại, cập nhật tiêu đề hero và xuất bản thay đổi.

Tạo nội dung bản địa hóa:

Đối với tài liệu <document_id>, hãy thêm bản dịch tiếng Pháp và tiếng Đức.
Sử dụng tài liệu hiện có và tạo các hàng bản dịch thay vì tạo các tài liệu trùng lặp.

Sử dụng nội dung động:

Đối với block hero trên trang mẫu, hãy lấy tiêu đề từ tài liệu được liên kết với route.
Sử dụng biểu thức trường của block thay vì đặt công thức trong draft_content.

Quy trình nội dung đầu-cuối

Profound CMS MCP có thể kết hợp với các máy chủ MCP khác để hỗ trợ một quy trình hoàn chỉnh:

Ví dụ:

Figma MCP + Profound CMS MCP

có thể kết nối việc khám phá thiết kế, tạo nội dung, biên soạn CMS, bản địa hóa và xuất bản thành một quy trình duy nhất có sự hỗ trợ của AI.