@intlayer/docs 7.0.6 → 7.0.8-canary.0

package/docs/vi/introduction.md

@@ -0,0 +1,215 @@
+---
+createdAt: 2025-08-23
+updatedAt: 2025-08-23
+title: Giới thiệu
+description: Tìm hiểu cách Intlayer hoạt động. Xem các bước mà Intlayer sử dụng trong ứng dụng của bạn. Xem các gói khác nhau làm gì.
+keywords:
+  - Giới thiệu
+  - Bắt đầu
+  - Intlayer
+  - Ứng dụng
+  - Gói
+slugs:
+  - doc
+  - get-started
+history:
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: Khởi tạo lịch sử
+---
+
+# Tài liệu Intlayer
+
+Chào mừng bạn đến với tài liệu chính thức của Intlayer! Ở đây, bạn sẽ tìm thấy mọi thứ cần thiết để tích hợp, cấu hình và làm chủ Intlayer cho tất cả các nhu cầu quốc tế hóa (i18n) của bạn, dù bạn đang làm việc với Next.js, React, Vite, Express hay môi trường JavaScript khác.
+
+## Giới thiệu
+
+### Intlayer là gì?
+
+**Intlayer** là một thư viện quốc tế hóa được thiết kế đặc biệt cho các nhà phát triển JavaScript. Nó cho phép khai báo nội dung của bạn ở mọi nơi trong mã nguồn. Nó chuyển đổi khai báo nội dung đa ngôn ngữ thành các từ điển có cấu trúc để dễ dàng tích hợp vào mã của bạn. Sử dụng TypeScript, **Intlayer** giúp phát triển của bạn mạnh mẽ và hiệu quả hơn.
+
+Intlayer cũng cung cấp một trình chỉnh sửa trực quan tùy chọn cho phép bạn dễ dàng chỉnh sửa và quản lý nội dung của mình. Trình chỉnh sửa này đặc biệt hữu ích cho các nhà phát triển thích giao diện trực quan để quản lý nội dung, hoặc cho các nhóm tạo nội dung mà không cần phải lo lắng về mã.
+
+### Ví dụ sử dụng
+
+```bash
+.
+└── Components
+    └── MyComponent
+        ├── index.content.ts
+        └── index.tsx
+```
+
+```tsx fileName="src/components/MyComponent/index.content.ts" contentDeclarationFormat="typescript"
+import { t, type Dictionary } from "intlayer";
+
+const componentContent = {
+  key: "component-key",
+  content: {
+    myTranslatedContent: t({
+      en: "Hello World", // Xin chào Thế giới
+      es: "Hola Mundo", // Xin chào Thế giới
+      fr: "Bonjour le monde", // Xin chào Thế giới
+    }),
+  },
+} satisfies Dictionary;
+
+export default componentContent;
+```
+
+```javascript fileName="src/components/MyComponent/index.content.mjs" contentDeclarationFormat="esm"
+import { t } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+const componentContent = {
+  key: "component-key",
+  content: {
+    myTranslatedContent: t({
+      en: "Hello World", // Xin chào Thế giới
+      es: "Hola Mundo", // Xin chào Thế giới
+      fr: "Bonjour le monde", // Xin chào Thế giới
+    }),
+  },
+};
+
+export default componentContent;
+```
+
+```javascript fileName="src/components/MyComponent/index.content.cjs" contentDeclarationFormat="commonjs"
+const { t } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+const componentContent = {
+  key: "component-key",
+  content: {
+    myTranslatedContent: t({
+      en: "Hello World", // Xin chào Thế giới
+      es: "Hola Mundo", // Xin chào Thế giới
+      fr: "Bonjour le monde", // Xin chào Thế giới
+    }),
+  },
+};
+
+module.exports = componentContent;
+```
+
+```json fileName="src/components/MyComponent/index.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "component-key",
+  "content": {
+    "myTranslatedContent": {
+      "nodeType": "translation",
+      "translation": {
+        "en": "Hello World",
+        "fr": "Bonjour le monde",
+        "es": "Hola Mundo"
+      }
+    }
+  }
+}
+```
+
+```tsx fileName="src/components/MyComponent/index.tsx" codeFormat="typescript"
+import type { FC } from "react";
+import { useIntlayer } from "react-intlayer";
+
+export const MyComponent: FC = () => {
+  const { myTranslatedContent } = useIntlayer("component-key");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+```jsx fileName="src/components/MyComponent/index.mjx" codeFormat="esm"
+import { useIntlayer } from "react-intlayer";
+
+const MyComponent = () => {
+  const { myTranslatedContent } = useIntlayer("component-key");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+```jsx fileName="src/components/MyComponent/index.csx" codeFormat="commonjs"
+const { useIntlayer } = require("react-intlayer");
+
+const MyComponent = () => {
+  const { myTranslatedContent } = useIntlayer("component-key");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+## Tính Năng Chính
+
+Intlayer cung cấp nhiều tính năng được thiết kế phù hợp để đáp ứng nhu cầu phát triển web hiện đại. Dưới đây là các tính năng chính, kèm theo các liên kết đến tài liệu chi tiết cho từng tính năng:
+
+- **Hỗ trợ Quốc tế hóa**: Nâng cao khả năng tiếp cận toàn cầu của ứng dụng với hỗ trợ quốc tế hóa tích hợp sẵn.
+- **Trình Soạn Thảo Trực Quan**: Cải thiện quy trình phát triển của bạn với các plugin trình soạn thảo được thiết kế dành riêng cho Intlayer. Xem hướng dẫn tại [Hướng Dẫn Trình Soạn Thảo Trực Quan](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_visual_editor.md).
+- **Tùy Biến Cấu Hình**: Tùy chỉnh thiết lập của bạn với các tùy chọn cấu hình phong phú được trình bày chi tiết trong [Hướng Dẫn Cấu Hình](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/configuration.md).
+- **Công Cụ CLI Nâng Cao**: Quản lý dự án hiệu quả bằng giao diện dòng lệnh của Intlayer. Khám phá các khả năng trong [Tài Liệu Công Cụ CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_cli.md).
+
+## Các Khái Niệm Cốt Lõi
+
+### Từ Điển
+
+Tổ chức nội dung đa ngôn ngữ gần với mã nguồn của bạn để giữ mọi thứ nhất quán và dễ bảo trì.
+
+- **[Bắt Đầu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/content_file.md)**  
+  Tìm hiểu những kiến thức cơ bản về cách khai báo nội dung trong Intlayer.
+
+- **[Dịch thuật](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/translation.md)**  
+  Hiểu cách các bản dịch được tạo ra, lưu trữ và sử dụng trong ứng dụng của bạn.
+
+- **[Liệt kê](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/enumeration.md)**  
+  Quản lý dễ dàng các tập dữ liệu lặp lại hoặc cố định trên nhiều ngôn ngữ khác nhau.
+
+- **[Điều kiện](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/conditional.md)**  
+  Tìm hiểu cách sử dụng logic điều kiện trong Intlayer để tạo nội dung động.
+
+- **[Chèn giá trị](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/insertion.md)**  
+  Khám phá cách chèn giá trị vào chuỗi bằng các chỗ giữ chèn giá trị.
+
+- **[Lấy dữ liệu bằng hàm](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/function_fetching.md)**  
+  Xem cách lấy nội dung động với logic tùy chỉnh để phù hợp với quy trình làm việc của dự án bạn.
+
+- **[Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/markdown.md)**  
+  Tìm hiểu cách sử dụng Markdown trong Intlayer để tạo nội dung phong phú.
+
+- **[Nhúng tệp](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/file_embeddings.md)**  
+  Khám phá cách nhúng các tệp bên ngoài vào Intlayer để sử dụng trong trình soạn thảo nội dung.
+
+- **[Lồng nhau](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/nesting.md)**  
+  Hiểu cách lồng nội dung trong Intlayer để tạo các cấu trúc phức tạp.
+
+### Môi trường & Tích hợp
+
+Chúng tôi xây dựng Intlayer với sự linh hoạt trong tâm trí, cung cấp tích hợp liền mạch với các framework và công cụ xây dựng phổ biến:
+
+- **[Intlayer với Next.js 16](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_with_nextjs_16.md)**
+- **[Intlayer với Next.js 15](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_with_nextjs_15.md)**
+- **[Intlayer với Next.js 14 (App Router)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_with_nextjs_14.md)**
+- **[Intlayer với Next.js Page Router](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_with_nextjs_page_router.md)**
+- **[Intlayer với React CRA](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_with_create_react_app.md)**
+- **[Intlayer với Vite + React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_with_vite+react.md)**
+- **[Intlayer với React Router v7](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_with_react_router_v7.md)**
+- **[Intlayer với Tanstack Start](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_with_tanstack.md)**
+- **[Intlayer với React Native và Expo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_with_react_native+expo.md)**
+- **[Intlayer với Lynx và React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_with_lynx+react.md)**
+- **[Intlayer với Vite + Preact](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_with_vite+preact.md)**
+- **[Intlayer với Vite + Vue](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_with_vite+vue.md)**
+- **[Intlayer với Nuxt](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_with_nuxt.md)**
+- **[Intlayer với Express](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_with_express.md)**
+- **[Intlayer với NestJS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_with_nestjs.md)**
+- **[Intlayer với Angular](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_with_angular.md)**
+
+Mỗi hướng dẫn tích hợp bao gồm các thực tiễn tốt nhất để sử dụng các tính năng của Intlayer, như **render phía máy chủ (server-side rendering)**, **định tuyến động (dynamic routing)**, hoặc **render phía khách (client-side rendering)**, giúp bạn duy trì một ứng dụng nhanh, thân thiện với SEO và có khả năng mở rộng cao.
+
+## Đóng góp & Phản hồi
+
+Chúng tôi đánh giá cao sức mạnh của phát triển mã nguồn mở và cộng đồng. Nếu bạn muốn đề xuất cải tiến, thêm hướng dẫn mới, hoặc sửa bất kỳ vấn đề nào trong tài liệu của chúng tôi, hãy thoải mái gửi Pull Request hoặc mở một issue trên [kho GitHub của chúng tôi](https://github.com/aymericzip/intlayer/blob/main/docs/docs).
+
+**Sẵn sàng để dịch ứng dụng của bạn nhanh hơn và hiệu quả hơn?** Hãy khám phá tài liệu của chúng tôi để bắt đầu sử dụng Intlayer ngay hôm nay. Trải nghiệm một phương pháp quốc tế hóa mạnh mẽ, tinh gọn giúp giữ cho nội dung của bạn được tổ chức tốt và đội ngũ của bạn làm việc hiệu quả hơn.
+
+---

package/docs/vi/locale_mapper.md

@@ -0,0 +1,242 @@
+---
+createdAt: 2025-07-27
+updatedAt: 2025-07-27
+title: Bộ ánh xạ Locale
+description: Tìm hiểu cách Bộ ánh xạ Locale hoạt động. Xem các bước được Bộ ánh xạ Locale sử dụng trong ứng dụng của bạn. Xem các gói khác nhau thực hiện những gì.
+keywords:
+  - Bộ ánh xạ Locale
+  - Bắt đầu
+  - Intlayer
+  - Ứng dụng
+  - Gói
+slugs:
+  - doc
+  - locale-mapper
+history:
+  - version: 5.7.2
+    date: 2025-07-27
+    changes: Thêm tài liệu bộ ánh xạ locale
+---
+
+# Bộ ánh xạ Locale
+
+Bộ ánh xạ Locale là một tiện ích mạnh mẽ giúp bạn làm việc với dữ liệu quốc tế hóa trong ứng dụng Intlayer của bạn. Nó cung cấp ba hàm chính để chuyển đổi và tổ chức dữ liệu theo locale: `localeMap`, `localeFlatMap`, và `localeRecord`.
+
+## Cách Bộ ánh xạ Locale hoạt động
+
+Bộ ánh xạ Locale hoạt động trên một đối tượng `LocaleData` chứa tất cả thông tin cần thiết về một locale:
+
+```typescript
+type LocaleData = {
+  locale: LocalesValues; // Mã locale hiện tại (ví dụ: 'en', 'fr')
+  defaultLocale: LocalesValues; // Mã locale mặc định
+  isDefault: boolean; // Có phải đây là locale mặc định hay không
+  locales: LocalesValues[]; // Mảng tất cả các locale có sẵn
+  urlPrefix: string; // Tiền tố URL cho locale này (ví dụ: '/fr' hoặc '')
+};
+```
+
+Các hàm mapper tự động tạo dữ liệu này cho mỗi locale trong cấu hình của bạn, dựa trên:
+
+- Danh sách các locale bạn đã cấu hình
+- Cài đặt locale mặc định
+- Việc có nên thêm tiền tố cho locale mặc định trong URL hay không
+
+## Các hàm chính
+
+### `localeMap`
+
+Chuyển đổi mỗi locale thành một đối tượng duy nhất bằng cách sử dụng một hàm mapper.
+
+```typescript
+localeMap<T>(
+  mapper: (locale: LocaleData) => T,
+  locales?: LocalesValues[],
+  defaultLocale?: LocalesValues,
+  prefixDefault?: boolean
+): T[]
+```
+
+**Ví dụ: Tạo các đối tượng route**
+
+```typescript
+import { localeMap } from "intlayer";
+
+const routes = localeMap((localizedData) => ({
+  path: localizedData.urlPrefix,
+  name: localizedData.locale,
+  isDefault: localizedData.isDefault,
+  locales: localizedData.locales,
+  defaultLocale: localizedData.defaultLocale,
+}));
+
+// Kết quả:
+// [
+//   { path: '/', name: 'en', isDefault: true, locales: ['en', 'fr', 'es'], defaultLocale: 'en' },
+//   { path: '/fr', name: 'fr', isDefault: false, locales: ['en', 'fr', 'es'], defaultLocale: 'en' },
+//   { path: '/es', name: 'es', isDefault: false, locales: ['en', 'fr', 'es'], defaultLocale: 'en' }
+// ]
+```
+
+### `localeFlatMap`
+
+Tương tự như `localeMap`, nhưng hàm mapper trả về một mảng các đối tượng và được làm phẳng thành một mảng duy nhất.
+
+```typescript
+localeFlatMap<T>(
+  mapper: (locale: LocaleData) => T[],
+  locales?: LocalesValues[],
+  defaultLocale?: LocalesValues,
+  prefixDefault?: boolean
+): T[]
+```
+
+**Ví dụ: Tạo nhiều route cho mỗi locale**
+
+```typescript
+import { localeFlatMap } from "intlayer";
+
+const routes = localeFlatMap((localizedData) => [
+  {
+    path: localizedData.urlPrefix,
+    name: localizedData.locale,
+    isDefault: localizedData.isDefault,
+  },
+  {
+    path: `${localizedData.urlPrefix}/about`,
+    name: `${localizedData.locale}-about`,
+    isDefault: localizedData.isDefault,
+  },
+]);
+
+// Kết quả:
+// [
+//   { path: '/', name: 'en', isDefault: true },
+//   { path: '/about', name: 'en-about', isDefault: true },
+//   { path: '/fr', name: 'fr', isDefault: false },
+//   { path: '/fr/about', name: 'fr-about', isDefault: false },
+//   { path: '/es', name: 'es', isDefault: false },
+//   { path: '/es/about', name: 'es-about', isDefault: false }
+// ]
+```
+
+### `localeRecord`
+
+Tạo một đối tượng record, trong đó mỗi locale là một khóa ánh xạ tới một giá trị được biến đổi bởi hàm mapper.
+
+```typescript
+localeRecord<T>(
+  mapper: (locale: LocaleData) => T,
+  locales?: Locales[],
+  defaultLocale?: Locales,
+  prefixDefault?: boolean
+): Record<Locales, T>
+```
+
+**Ví dụ: Tải các file dịch**
+
+```typescript
+import { localeRecord } from "intlayer";
+
+const translations = localeRecord(({ locale }) =>
+  require(`./translations/${locale}.json`)
+);
+
+// Kết quả:
+// {
+//   en: { welcome: 'Welcome', hello: 'Hello' },
+//   fr: { welcome: 'Bienvenue', hello: 'Bonjour' },
+//   es: { welcome: 'Bienvenido', hello: 'Hola' }
+// }
+```
+
+## Cấu hình Locale Mapper
+
+Locale Mapper tự động sử dụng cấu hình Intlayer của bạn, nhưng bạn có thể ghi đè các giá trị mặc định bằng cách truyền các tham số:
+
+### Sử dụng cấu hình mặc định
+
+```typescript
+import { localeMap } from "intlayer";
+
+// Sử dụng cấu hình từ intlayer.config.ts
+const routes = localeMap((data) => ({
+  path: data.urlPrefix,
+  locale: data.locale,
+}));
+```
+
+### Ghi đè cấu hình
+
+```typescript
+import { localeMap } from "intlayer";
+
+// Ghi đè locales và locale mặc định
+const customRoutes = localeMap(
+  (data) => ({ path: data.urlPrefix, locale: data.locale }),
+  ["en", "fr", "de"], // Các locales tùy chỉnh
+  "en", // Locale mặc định tùy chỉnh
+  true // Thêm tiền tố locale mặc định vào URL
+);
+```
+
+## Ví dụ Sử dụng Nâng cao
+
+### Tạo Menu Điều hướng
+
+```typescript
+import { localeMap } from "intlayer";
+
+const navigationItems = localeMap((data) => ({
+  label: data.locale.toUpperCase(),
+  href: data.urlPrefix || "/",
+  isActive: data.isDefault,
+  flag: `/flags/${data.locale}.svg`,
+}));
+```
+
+### Tạo Dữ liệu Sitemap
+
+```typescript
+import { localeFlatMap } from "intlayer";
+
+const sitemapUrls = localeFlatMap((data) => [
+  {
+    url: `${data.urlPrefix}/`,
+    lastmod: new Date().toISOString(),
+    changefreq: "daily",
+    priority: data.isDefault ? 1.0 : 0.8,
+  },
+  {
+    url: `${data.urlPrefix}/about`,
+    lastmod: new Date().toISOString(),
+    changefreq: "monthly",
+    priority: data.isDefault ? 0.8 : 0.6,
+  },
+]);
+```
+
+### Tải Dịch Thuật Động
+
+```typescript
+import { localeRecord } from "intlayer";
+
+const translationModules = localeRecord(({ locale }) => ({
+  messages: import(`./locales/${locale}/messages.json`),
+  validation: import(`./locales/${locale}/validation.json`),
+  metadata: {
+    locale,
+    direction: ["ar", "he", "fa"].includes(locale) ? "rtl" : "ltr", // hướng văn bản
+  },
+}));
+```
+
+## Tích Hợp Cấu Hình
+
+Locale Mapper tích hợp liền mạch với cấu hình Intlayer của bạn:
+
+- **Locales**: Tự động sử dụng `configuration.internationalization.locales`
+- **Ngôn ngữ Mặc định**: Sử dụng `configuration.internationalization.defaultLocale`
+- **Tiền tố URL**: Tuân thủ `configuration.middleware.prefixDefault`
+
+Điều này đảm bảo tính nhất quán trên toàn bộ ứng dụng của bạn và giảm thiểu sự trùng lặp trong cấu hình.

package/docs/vi/mcp_server.md

@@ -0,0 +1,211 @@
+---
+createdAt: 2025-06-07
+updatedAt: 2025-07-11
+title: Tài liệu Máy chủ MCP
+description: Khám phá các tính năng và cách thiết lập Máy chủ MCP để tối ưu hóa quản lý và vận hành máy chủ của bạn.
+keywords:
+  - Máy chủ MCP
+  - Quản lý máy chủ
+  - Tối ưu hóa
+  - Intlayer
+  - Tài liệu
+  - Thiết lập
+  - Tính năng
+slugs:
+  - doc
+  - mcp-server
+history:
+  - version: 5.5.12
+    date: 2025-07-11
+    changes: Thêm thiết lập ChatGPT
+  - version: 5.5.12
+    date: 2025-07-10
+    changes: Thêm thiết lập Claude Desktop
+  - version: 5.5.12
+    date: 2025-07-10
+    changes: Thêm giao thức SSE và máy chủ từ xa
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: Khởi tạo lịch sử
+---
+
+# Máy chủ MCP Intlayer
+
+Máy chủ **Intlayer MCP (Model Context Protocol)** cung cấp hỗ trợ IDE được trang bị AI, được thiết kế riêng cho hệ sinh thái Intlayer.
+
+## Tôi có thể sử dụng nó ở đâu?
+
+- Trên các môi trường phát triển hiện đại như **Cursor**, **VS Code**, và bất kỳ IDE nào hỗ trợ giao thức MCP.
+- Trên các trợ lý AI yêu thích của bạn như **Claude Desktop**, **Gemini**, **ChatGPT**, v.v.
+
+## Tại sao nên sử dụng Máy chủ Intlayer MCP?
+
+Bằng cách kích hoạt Máy chủ Intlayer MCP trong IDE của bạn, bạn sẽ mở khóa:
+
+- **Tài liệu nhận biết ngữ cảnh**
+  Máy chủ MCP tải và cung cấp tài liệu của Intlayer. Giúp tăng tốc quá trình thiết lập, di chuyển dữ liệu, v.v.
+  Điều này đảm bảo các gợi ý mã, tùy chọn lệnh và giải thích luôn được cập nhật và phù hợp.
+
+- **Tích hợp CLI thông minh**
+  Truy cập và chạy các lệnh Intlayer CLI trực tiếp từ giao diện IDE của bạn. Sử dụng máy chủ MCP, bạn có thể để trợ lý AI của mình chạy các lệnh như `intlayer dictionaries build` để cập nhật từ điển, hoặc `intlayer dictionaries fill` để điền các bản dịch còn thiếu.
+
+> Xem danh sách đầy đủ các lệnh và tùy chọn trong [tài liệu Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_cli.md).
+
+## Máy chủ cục bộ (stdio) và máy chủ từ xa (SSE)
+
+Máy chủ MCP có thể được sử dụng theo hai cách:
+
+- Máy chủ cục bộ (stdio)
+- Máy chủ từ xa (SSE)
+
+### Máy chủ cục bộ (stdio) (khuyến nghị)
+
+Intlayer cung cấp một gói NPM có thể được cài đặt cục bộ trên máy của bạn. Nó có thể được cài đặt trong IDE yêu thích của bạn, như VS Code, Cursor, cũng như trong ứng dụng trợ lý địa phương của bạn, như ChatGPT, Claude Desktop, v.v.
+
+Máy chủ này là cách được khuyến nghị để sử dụng máy chủ MCP. Vì nó tích hợp tất cả các tính năng của máy chủ MCP, bao gồm cả các công cụ CLI.
+
+### Máy chủ từ xa (SSE)
+
+Máy chủ MCP cũng có thể được sử dụng từ xa, sử dụng phương thức truyền SSE. Máy chủ này được Intlayer lưu trữ và có sẵn tại https://mcp.intlayer.org. Máy chủ này có thể truy cập công khai, không cần xác thực, và miễn phí sử dụng.
+
+Lưu ý rằng máy chủ từ xa không tích hợp các công cụ CLI, tự động hoàn thành AI, v.v. Máy chủ từ xa chỉ dùng để tương tác với tài liệu nhằm hỗ trợ trợ lý AI của bạn với hệ sinh thái Intlayer.
+
+> Do chi phí lưu trữ máy chủ, không thể đảm bảo tính khả dụng của máy chủ từ xa. Chúng tôi giới hạn số lượng kết nối đồng thời. Chúng tôi khuyến nghị sử dụng phương thức truyền máy chủ cục bộ (stdio) để có trải nghiệm ổn định nhất.
+
+---
+
+## Cài đặt trong Cursor
+
+Theo dõi [tài liệu chính thức](https://docs.cursor.com/context/mcp) để cấu hình máy chủ MCP trong Cursor.
+
+Trong thư mục gốc dự án của bạn, thêm tệp cấu hình `.cursor/mcp.json` sau:
+
+### Máy chủ cục bộ (stdio) (khuyến nghị)
+
+```json fileName=".cursor/mcp.json"
+{
+  "mcpServers": {
+    "intlayer": {
+      "command": "npx",
+      "args": ["-y", "@intlayer/mcp"]
+    }
+  }
+}
+```
+
+### Máy chủ từ xa (SSE)
+
+Để kết nối với máy chủ Intlayer MCP từ xa sử dụng Server-Sent Events (SSE), bạn có thể cấu hình client MCP của mình để kết nối với dịch vụ được lưu trữ.
+
+```json fileName=".cursor/mcp.json"
+{
+  "mcpServers": {
+    "intlayer": {
+      "url": "https://mcp.intlayer.org",
+      "transport": "sse"
+    }
+  }
+}
+```
+
+Điều này cho IDE của bạn biết để khởi chạy máy chủ Intlayer MCP bằng `npx`, đảm bảo luôn sử dụng phiên bản mới nhất trừ khi bạn cố định phiên bản.
+
+---
+
+## Cài đặt trong VS Code
+
+Theo dõi [tài liệu chính thức](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) để cấu hình máy chủ MCP trong VS Code.
+
+Để sử dụng Intlayer MCP Server với VS Code, bạn cần cấu hình nó trong workspace hoặc cài đặt người dùng của bạn.
+
+### Máy chủ cục bộ (stdio) (khuyến nghị)
+
+Tạo một file `.vscode/mcp.json` trong thư mục gốc dự án của bạn:
+
+```json fileName=".vscode/mcp.json"
+{
+  "servers": {
+    "intlayer": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@intlayer/mcp"]
+    }
+  }
+}
+```
+
+### Máy chủ từ xa (SSE)
+
+Để kết nối với máy chủ Intlayer MCP từ xa sử dụng Server-Sent Events (SSE), bạn có thể cấu hình client MCP của mình để kết nối với dịch vụ được lưu trữ.
+
+```json fileName=".vscode/mcp.json"
+{
+  "servers": {
+    "intlayer": {
+      "url": "https://mcp.intlayer.org",
+      "type": "sse"
+    }
+  }
+}
+```
+
+---
+
+## Cài đặt trong ChatGPT
+
+### Máy chủ từ xa (SSE)
+
+Theo dõi [tài liệu chính thức](https://platform.openai.com/docs/mcp#test-and-connect-your-mcp-server) để cấu hình máy chủ MCP trong ChatGPT.
+
+1. Truy cập vào [bảng điều khiển promt](https://platform.openai.com/prompts)
+2. Nhấn vào `+ Create`
+3. Nhấn vào `Tools (Create or +)`
+4. Chọn `MCP Server`
+5. Nhấn vào `Add new`
+6. Điền các trường sau:
+   - URL: `https://mcp.intlayer.org`
+   - Label: `Intlayer MCP Server`
+   - Name: `intlayer-mcp-server`
+   - Authentication: `None`
+
+7. Nhấn vào `Save`
+
+---
+
+## Cài đặt trong Claude Desktop
+
+Theo dõi [tài liệu chính thức](https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server) để cấu hình máy chủ MCP trong Claude Desktop.
+
+Đường dẫn file cấu hình:
+
+- macOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+
+### Máy chủ cục bộ (stdio) (khuyến nghị)
+
+```json fileName="claude_desktop_config.json"
+{
+  "mcpServers": {
+    "intlayer": {
+      "command": "npx",
+      "args": ["-y", "@intlayer/mcp"]
+    }
+  }
+}
+```
+
+---
+
+## Sử dụng MCP Server qua CLI
+
+Bạn cũng có thể chạy trực tiếp máy chủ Intlayer MCP từ dòng lệnh để thử nghiệm, gỡ lỗi hoặc tích hợp với các công cụ khác.
+
+```bash
+# Cài đặt toàn cục
+npm install -g @intlayer/mcp
+
+# Hoặc sử dụng trực tiếp với npx (khuyến nghị)
+npx @intlayer/mcp
+```
+
+---