@intlayer/docs 7.5.12 → 7.5.14

package/docs/uk/introduction.md

@@ -0,0 +1,222 @@
+---
+createdAt: 2025-08-23
+updatedAt: 2025-08-23
+title: Вступ
+description: Дізнайтеся, як працює Intlayer. Перегляньте кроки, які Intlayer виконує у вашому застосунку. Дізнайтеся, що роблять різні пакети.
+keywords:
+  - Вступ
+  - Початок роботи
+  - Intlayer
+  - Застосунок
+  - Пакети
+slugs:
+  - doc
+  - get-started
+history:
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: Init history
+---
+
+# Документація Intlayer
+
+Ласкаво просимо до офіційної документації Intlayer! Тут ви знайдете все, що потрібно для інтеграції, конфігурації та опанування Intlayer для всіх ваших потреб з інтернаціоналізації (i18n), незалежно від того, працюєте ви з Next.js, React, Vite, Express або іншим JavaScript-середовищем.
+
+## Вступ
+
+### Що таке Intlayer?
+
+**Intlayer** — бібліотека інтернаціоналізації (i18n), розроблена спеціально для JavaScript-розробників. Вона дозволяє оголошувати ваш контент у будь-якому місці коду. Intlayer перетворює оголошення багатомовного контенту на структуровані словники, щоб їх було легко інтегрувати у ваш код. Використовуючи TypeScript, **Intlayer** робить розробку більш надійною та ефективною.
+
+Intlayer також надає необов'язковий візуальний редактор, який дозволяє легко редагувати та керувати контентом. Цей редактор особливо корисний для розробників, які віддають перевагу візуальному інтерфейсу для управління контентом, або для команд, що генерують контент без необхідності працювати з кодом.
+
+### Приклад використання
+
+```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({
+      uk: "Привіт, світ",
+      en: "Hello World",
+      es: "Hola Mundo",
+      fr: "Bonjour le monde",
+    }),
+  },
+} 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({
+      uk: "Привіт, світ",
+      en: "Hello World",
+      es: "Hola Mundo",
+      fr: "Bonjour le monde",
+    }),
+  },
+};
+
+export default componentContent;
+```
+
+```javascript fileName="src/components/MyComponent/index.content.cjs" contentDeclarationFormat="commonjs"
+const { t } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+// Тип: import('intlayer').Dictionary
+const componentContent = {
+  key: "component-key",
+  content: {
+    myTranslatedContent: t({
+      uk: "Привіт, світ",
+      en: "Hello World",
+      es: "Hola Mundo",
+      fr: "Bonjour le monde",
+    }),
+  },
+};
+
+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": {
+        "uk": "Привіт, світ",
+        "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>;
+};
+```
+
+## Основні можливості
+
+Intlayer пропонує низку можливостей, адаптованих під потреби сучасної веб-розробки. Нижче наведено ключові функції з посиланнями на докладну документацію для кожної:
+
+- **Підтримка інтернаціоналізації**: Розширюйте глобальне охоплення вашого застосунку за допомогою вбудованої підтримки інтернаціоналізації.
+- **Візуальний редактор**: Покращуйте свій робочий процес розробки за допомогою плагінів для редактора, створених для Intlayer. Перегляньте [Посібник із візуального редактора](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_visual_editor.md).
+- **Гнучкість конфігурації**: Налаштуйте ваше середовище за допомогою широких опцій конфігурації, детально описаних у [Довіднику з конфігурації](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/configuration.md).
+- **Розширені інструменти CLI**: Ефективно керуйте своїми проєктами за допомогою командного інтерфейсу Intlayer. Дослідіть можливості в [Документації інструментів CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/index.md).
+
+## Основні поняття
+
+### Словник
+
+Організуйте ваш багатомовний контент поруч із кодом, щоб усе залишалося узгодженим і простим у підтримці.
+
+- **[Початок роботи](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/content_file.md)**  
+  Дізнайтеся основи декларування вашого контенту в Intlayer.
+
+- **[Переклад](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/translation.md)**  
+  Дізнайтеся, як переклади генеруються, зберігаються та використовуються у вашому застосунку.
+
+- **[Перелічення](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/enumeration.md)**  
+  Легко керуйте повторюваними або фіксованими наборами даних для різних мов.
+
+- **[Умова](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/conditional.md)**  
+  Дізнайтеся, як використовувати умовну логіку в Intlayer для створення динамічного контенту.
+
+- **[Вставлення](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/insertion.md)**
+  Дізнайтеся, як вставляти значення в рядок за допомогою плейсхолдерів вставки.
+
+- **[Отримання за допомогою функцій](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/function_fetching.md)**  
+  Дізнайтеся, як динамічно отримувати контент за допомогою кастомної логіки, щоб відповідати робочому процесу вашого проєкту.
+
+- **[Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/markdown.md)**  
+  Дізнайтеся, як використовувати Markdown в Intlayer для створення насиченого контенту.
+
+- **[Вбудовування файлів](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/file_embeddings.md)**  
+  Дізнайтеся, як вбудовувати зовнішні файли в Intlayer для використання їх у редакторі контенту.
+
+- **[Вкладення](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/nesting.md)**  
+  Дізнайтеся, як вкладати контент в Intlayer для створення складних структур.
+
+### Середовища та інтеграції
+
+Intlayer створено з урахуванням гнучкості, забезпечуючи безшовну інтеграцію з популярними фреймворками та інструментами збірки:
+
+- **[Intlayer з Next.js 16](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_with_nextjs_16.md)**
+- **[Intlayer з Next.js 15](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_with_nextjs_15.md)**
+- **[Intlayer з Next.js 14 (App Router)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_with_nextjs_14.md)**
+- **[Intlayer з Next.js Page Router](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_with_nextjs_page_router.md)**
+- **[Intlayer з React CRA](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_with_create_react_app.md)**
+- **[Intlayer з Vite + React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_with_vite+react.md)**
+- **[Intlayer з React Router v7](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_with_react_router_v7.md)**
+- **[Intlayer з Tanstack Start](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_with_tanstack.md)**
+- **[Intlayer з React Native та Expo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_with_react_native+expo.md)**
+- **[Intlayer з Lynx та React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_with_lynx+react.md)**
+- **[Intlayer з Vite + Preact](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_with_vite+preact.md)**
+- **[Intlayer з Vite + Vue](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_with_vite+vue.md)**
+- **[Intlayer з Nuxt](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_with_nuxt.md)**
+- **[Intlayer з Vite + Svelte](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_with_vite+svelte.md)**
+- **[Intlayer з SvelteKit](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_with_svelte_kit.md)**
+- **[Intlayer з Express](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_with_express.md)**
+- **[Intlayer з NestJS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_with_nestjs.md)**
+- **[Intlayer з Angular](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/intlayer_with_angular.md)**
+
+Кожен посібник з інтеграції містить найкращі практики використання можливостей Intlayer, таких як **server-side rendering**, **dynamic routing** або **client-side rendering**, щоб ви могли підтримувати швидкий, SEO-дружній та високо масштабований застосунок.
+
+## Внесок і відгуки
+
+Ми цінуємо силу open-source та розробку, що керується спільнотою. Якщо ви хочете запропонувати покращення, додати новий посібник або виправити будь-які помилки в нашій документації, не соромтеся надіслати Pull Request або відкрити issue у нашому [репозиторії на GitHub](https://github.com/aymericzip/intlayer/blob/main/docs/docs).
+
+**Готові перекласти ваш додаток швидше та ефективніше?** Ознайомтеся з нашою документацією, щоб почати використовувати Intlayer вже сьогодні. Відчуйте надійний, оптимізований підхід до інтернаціоналізації, який зберігає ваш контент впорядкованим і підвищує продуктивність вашої команди.
+
+---

package/docs/uk/locale_mapper.md

@@ -0,0 +1,242 @@
+---
+createdAt: 2025-07-27
+updatedAt: 2025-07-27
+title: Маппер локалей
+description: Дізнайтеся, як працює Маппер локалей. Перегляньте кроки, які виконує Маппер локалей у вашому застосунку. Дізнайтеся, що роблять різні пакети.
+keywords:
+  - Locale Mapper
+  - Початок роботи
+  - Intlayer
+  - Додаток
+  - Пакети
+slugs:
+  - doc
+  - locale-mapper
+history:
+  - version: 5.7.2
+    date: 2025-07-27
+    changes: Додано документацію для Locale Mapper
+---
+
+# Маппер локалей
+
+Маппер локалей — потужний інструмент, який допомагає працювати з даними інтернаціоналізації в вашому застосунку Intlayer. Він надає три основні функції для перетворення і організації даних, специфічних для локалі: `localeMap`, `localeFlatMap` та `localeRecord`.
+
+## Як працює Маппер локалей
+
+Мапер локалей працює з об'єктом `LocaleData`, який містить всю необхідну інформацію про локаль:
+
+```typescript
+type LocaleData = {
+  locale: LocalesValues; // Поточний код локалі (наприклад, 'en', 'fr')
+  defaultLocale: LocalesValues; // Код локалі за замовчуванням
+  isDefault: boolean; // Чи є ця локаль за замовчуванням
+  locales: LocalesValues[]; // Масив всіх доступних локалей
+  urlPrefix: string; // Префікс URL для цієї локалі (наприклад, '/fr' або '')
+};
+```
+
+Функції-мапери автоматично генерують ці дані для кожної локалі у вашій конфігурації, враховуючи:
+
+- Ваш список налаштованих локалей
+- Налаштування локалі за замовчуванням
+- Чи слід додавати префікс для локалі за замовчуванням у URL
+
+## Основні функції
+
+### `localeMap`
+
+Перетворює кожну локаль на один об'єкт за допомогою функції mapper.
+
+```typescript
+localeMap<T>(
+  mapper: (locale: LocaleData) => T,
+  locales?: LocalesValues[],
+  defaultLocale?: LocalesValues,
+  prefixDefault?: boolean
+): T[]
+```
+
+**Приклад: створення об'єктів маршрутів**
+
+```typescript
+import { localeMap } from "intlayer";
+
+const routes = localeMap((localizedData) => ({
+  path: localizedData.urlPrefix,
+  name: localizedData.locale,
+  isDefault: localizedData.isDefault,
+  locales: localizedData.locales,
+  defaultLocale: localizedData.defaultLocale,
+}));
+
+// Result:
+// [
+//   { 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`
+
+Подібно до `localeMap`, але функція mapper повертає масив об'єктів, який згортається в один масив.
+
+```typescript
+localeFlatMap<T>(
+  mapper: (locale: LocaleData) => T[],
+  locales?: LocalesValues[],
+  defaultLocale?: LocalesValues,
+  prefixDefault?: boolean
+): T[]
+```
+
+**Приклад: Створення кількох маршрутів для кожної локалі**
+
+```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,
+  },
+]);
+
+// Результат:
+// [
+//   { 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`
+
+Створює об'єкт запису, де кожна локаль є ключем, що відображається на значення, перетворене функцією mapper.
+
+```typescript
+localeRecord<T>(
+  mapper: (locale: LocaleData) => T,
+  locales?: Locales[],
+  defaultLocale?: Locales,
+  prefixDefault?: boolean
+): Record<Locales, T>
+```
+
+**Приклад: Завантаження файлів перекладу**
+
+```typescript
+import { localeRecord } from "intlayer";
+
+const translations = localeRecord(({ locale }) =>
+  require(`./translations/${locale}.json`)
+);
+
+// Результат:
+// {
+//   en: { welcome: 'Welcome', hello: 'Hello' },
+//   fr: { welcome: 'Bienvenue', hello: 'Bonjour' },
+//   es: { welcome: 'Bienvenido', hello: 'Hola' }
+// }
+```
+
+## Налаштування Locale Mapper
+
+Locale Mapper автоматично використовує вашу конфігурацію Intlayer, але ви можете перевизначити значення за замовчуванням, передавши параметри:
+
+### Використання конфігурації за замовчуванням
+
+```typescript
+import { localeMap } from "intlayer";
+
+// Використовує конфігурацію з intlayer.config.ts
+const routes = localeMap((data) => ({
+  path: data.urlPrefix,
+  locale: data.locale,
+}));
+```
+
+### Перевизначення конфігурації
+
+```typescript
+import { localeMap } from "intlayer";
+
+// Перевизначити локалі та локаль за замовчуванням
+const customRoutes = localeMap(
+  (data) => ({ path: data.urlPrefix, locale: data.locale }),
+  ["en", "fr", "de"], // Користувацькі локалі
+  "en", // Користувацька локаль за замовчуванням
+  true // Додавати префікс локалі за замовчуванням у URL
+);
+```
+
+## Розширені приклади використання
+
+### Створення навігаційних меню
+
+```typescript
+import { localeMap } from "intlayer";
+
+const navigationItems = localeMap((data) => ({
+  label: data.locale.toUpperCase(),
+  href: data.urlPrefix || "/",
+  isActive: data.isDefault,
+  flag: `/flags/${data.locale}.svg`,
+}));
+```
+
+### Генерація даних 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,
+  },
+]);
+```
+
+### Динамічне завантаження перекладів
+
+```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",
+  },
+}));
+```
+
+## Інтеграція конфігурації
+
+Locale Mapper безшовно інтегрується з вашою конфігурацією Intlayer:
+
+- **Locales**: Автоматично використовує `configuration.internationalization.locales`
+- **Локаль за замовчуванням**: Використовує `configuration.internationalization.defaultLocale`
+- **Додавання префіксу до URL**: Дотримується `configuration.middleware.prefixDefault`
+
+Це забезпечує узгодженість у всьому додатку та зменшує дублювання конфігурації.

package/docs/uk/mcp_server.md

@@ -0,0 +1,211 @@
+---
+createdAt: 2025-06-07
+updatedAt: 2025-07-11
+title: Документація MCP Server
+description: Дослідіть функції та налаштування MCP Server, щоб оптимізувати управління сервером і операції.
+keywords:
+  - MCP Server
+  - Управління сервером
+  - Оптимізація
+  - Intlayer
+  - Документація
+  - Налаштування
+  - Функції
+slugs:
+  - doc
+  - mcp-server
+history:
+  - version: 5.5.12
+    date: 2025-07-11
+    changes: Додано налаштування ChatGPT
+  - version: 5.5.12
+    date: 2025-07-10
+    changes: Додано налаштування Claude Desktop
+  - version: 5.5.12
+    date: 2025-07-10
+    changes: Додано SSE-транспорт і віддалений сервер
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: Ініціалізовано історію
+---
+
+# Документація MCP Server
+
+Сервер **Intlayer MCP (Model Context Protocol)** надає підтримку IDE на базі AI, адаптовану для екосистеми Intlayer.
+
+## Де його можна використовувати?
+
+- У сучасних середовищах розробки, таких як **Cursor**, **VS Code**, та будь-якому IDE, яке підтримує протокол MCP.
+- У вашому улюбленому AI-асистенті, наприклад **Claude Desktop**, **Gemini**, **ChatGPT** тощо.
+
+## Чому варто використовувати сервер Intlayer MCP?
+
+Увімкнувши сервер Intlayer MCP у вашому IDE, ви отримуєте доступ до:
+
+- **Контекстно-залежна документація**
+  MCP-сервер завантажує й надає документацію Intlayer, щоб прискорити налаштування, міграції тощо.
+  Це гарантує, що підказки коду, параметри команд та пояснення завжди актуальні та релевантні.
+
+- **Розумна інтеграція CLI**
+  Отримуйте доступ і запускайте команди Intlayer CLI безпосередньо з інтерфейсу вашого IDE. Використовуючи MCP server, ви можете дозволити своєму AI-помічнику виконувати команди, такі як `intlayer dictionaries build` для оновлення словників, або `intlayer dictionaries fill` для заповнення відсутніх перекладів.
+
+> Перегляньте повний список команд та опцій у [документації Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/index.md).
+
+## Локальний сервер (stdio) проти Віддаленого сервера (SSE)
+
+MCP server можна використовувати двома способами:
+
+- Локальний сервер (stdio)
+- Віддалений сервер (SSE)
+
+### Локальний сервер (stdio) (рекомендовано)
+
+Intlayer надає пакет NPM, який можна встановити локально на вашому комп’ютері. Його можна інтегрувати в улюблене IDE, як-от VS Code або Cursor, а також у вашу локальну програму асистента, таку як ChatGPT, Claude Desktop тощо.
+
+Цей сервер є рекомендованим способом використання MCP‑сервера, оскільки він інтегрує всі можливості MCP‑сервера, включно з CLI‑інструментами.
+
+### Віддалений сервер (SSE)
+
+MCP‑сервер також можна використовувати віддалено, використовуючи транспортний метод SSE. Цей сервер хоститься Intlayer і доступний за адресою https://mcp.intlayer.org. До сервера можна підключитися публічно, без автентифікації, і його використання безкоштовне.
+
+Зверніть увагу, що віддалений сервер не інтегрує CLI-інструменти, AI-автозавершення тощо. Дистанційний сервер призначений лише для взаємодії з документацією, щоб допомогти вашому AI-асистентові з екосистемою Intlayer.
+
+> Через витрати на хостинг доступність віддаленого сервера не може бути гарантована. Ми обмежуємо кількість одночасних підключень. Для найнадійнішої роботи ми рекомендуємо використовувати локальний сервер з транспортом stdio.
+
+---
+
+## Налаштування в Cursor
+
+Дотримуйтесь [офіційної документації](https://docs.cursor.com/context/mcp), щоб налаштувати MCP-сервер у Cursor.
+
+У корені вашого проєкту додайте наступний конфігураційний файл `.cursor/mcp.json`:
+
+### Локальний сервер (stdio) (рекомендовано)
+
+```json fileName=".cursor/mcp.json"
+{
+  "mcpServers": {
+    "intlayer": {
+      "command": "npx",
+      "args": ["-y", "@intlayer/mcp"]
+    }
+  }
+}
+```
+
+### Віддалений сервер (SSE)
+
+Для підключення до віддаленого Intlayer MCP сервера за допомогою Server-Sent Events (SSE), ви можете налаштувати ваш MCP клієнт на підключення до хостингу.
+
+```json fileName=".cursor/mcp.json"
+{
+  "mcpServers": {
+    "intlayer": {
+      "url": "https://mcp.intlayer.org",
+      "transport": "sse"
+    }
+  }
+}
+```
+
+Це вказує вашому IDE запускати Intlayer MCP server за допомогою `npx`, гарантує, що він завжди використовує останню доступну версію, якщо ви її не закріпите.
+
+---
+
+## Налаштування в VS Code
+
+Дотримуйтесь [офіційної документації](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) для налаштування MCP сервера у VS Code.
+
+Щоб використовувати Intlayer MCP Server у VS Code, потрібно налаштувати його в налаштуваннях робочого простору або у користувацьких налаштуваннях.
+
+### Локальний сервер (stdio) (рекомендується)
+
+Створіть файл `.vscode/mcp.json` у корені вашого проєкту:
+
+```json fileName=".vscode/mcp.json"
+{
+  "servers": {
+    "intlayer": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@intlayer/mcp"]
+    }
+  }
+}
+```
+
+### Віддалений сервер (SSE)
+
+Щоб підключитися до віддаленого Intlayer MCP сервера через Server-Sent Events (SSE), ви можете налаштувати ваш MCP-клієнт на підключення до хостингованого сервісу.
+
+```json fileName=".vscode/mcp.json"
+{
+  "servers": {
+    "intlayer": {
+      "url": "https://mcp.intlayer.org",
+      "type": "sse"
+    }
+  }
+}
+```
+
+---
+
+## Налаштування в ChatGPT
+
+### Віддалений сервер (SSE)
+
+Дотримуйтесь [офіційної документації](https://platform.openai.com/docs/mcp#test-and-connect-your-mcp-server), щоб налаштувати MCP сервер у ChatGPT.
+
+1. Перейдіть на [панель підказок](https://platform.openai.com/prompts)
+2. Натисніть `+ Create`
+3. Натисніть `Tools (Create or +)`
+4. Виберіть `MCP Server`
+5. Натисніть `Add new`
+6. Заповніть наступні поля:
+   - URL: `https://mcp.intlayer.org`
+   - Мітка: `Intlayer MCP Server`
+   - Назва: `intlayer-mcp-server`
+   - Аутентифікація: `None`
+
+7. Натисніть `Save`
+
+---
+
+## Налаштування в Claude Desktop
+
+Дотримуйтесь [офіційної документації](https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server) щоб налаштувати MCP-сервер у Claude Desktop.
+
+Шлях до файлу конфігурації:
+
+- macOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+
+### Локальний сервер (stdio) (рекомендовано)
+
+```json fileName="claude_desktop_config.json"
+{
+  "mcpServers": {
+    "intlayer": {
+      "command": "npx",
+      "args": ["-y", "@intlayer/mcp"]
+    }
+  }
+}
+```
+
+---
+
+## Використання MCP-сервера через CLI
+
+Ви також можете запускати Intlayer MCP-сервер безпосередньо з командного рядка для тестування, налагодження або інтеграції з іншими інструментами.
+
+```bash
+# Встановити глобально
+npm install -g @intlayer/mcp
+
+# Або використовувати безпосередньо через npx (рекомендовано)
+npx @intlayer/mcp
+```
+
+---