@intlayer/docs 7.0.7 → 7.0.8-canary.0

package/docs/pl/introduction.md

@@ -0,0 +1,209 @@
+---
+createdAt: 2025-08-23
+updatedAt: 2025-08-23
+title: Wprowadzenie
+description: Odkryj, jak działa Intlayer. Zobacz kroki używane przez Intlayer w Twojej aplikacji. Dowiedz się, co robią różne pakiety.
+keywords:
+  - Wprowadzenie
+  - Pierwsze kroki
+  - Intlayer
+  - Aplikacja
+  - Pakiety
+slugs:
+  - doc
+  - get-started
+history:
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: Inicjalizacja historii
+---
+
+# Dokumentacja Intlayer
+
+Witamy w oficjalnej dokumentacji Intlayer! Znajdziesz tutaj wszystko, czego potrzebujesz, aby zintegrować, skonfigurować i opanować Intlayer dla wszystkich Twoich potrzeb związanych z internacjonalizacją (i18n), niezależnie od tego, czy pracujesz z Next.js, React, Vite, Express czy innym środowiskiem JavaScript.
+
+## Wprowadzenie
+
+### Czym jest Intlayer?
+
+**Intlayer** to biblioteka do internacjonalizacji zaprojektowana specjalnie dla programistów JavaScript. Pozwala na deklarowanie Twoich treści w dowolnym miejscu w kodzie. Przekształca deklaracje wielojęzycznych treści w ustrukturyzowane słowniki, które można łatwo zintegrować w Twoim kodzie. Korzystając z TypeScript, **Intlayer** sprawia, że Twój rozwój jest silniejszy i bardziej efektywny.
+
+Intlayer oferuje również opcjonalny edytor wizualny, który pozwala łatwo edytować i zarządzać Twoimi treściami. Ten edytor jest szczególnie przydatny dla programistów, którzy wolą wizualny interfejs do zarządzania treścią, lub dla zespołów generujących treści bez konieczności martwienia się o kod.
+
+### Przykład użycia
+
+```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",
+      es: "Hola Mundo",
+      fr: "Bonjour le monde",
+    }),
+  },
+} satisfies Dictionary; // spełnia typ Dictionary (słownik)
+
+export default componentContent; // eksportuje zawartość komponentu
+```
+
+```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",
+      es: "Hola Mundo",
+      fr: "Bonjour le monde",
+    }),
+  },
+};
+
+export default componentContent; // eksportuje zawartość komponentu
+```
+
+```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",
+      es: "Hola Mundo",
+      fr: "Bonjour le monde",
+    }),
+  },
+};
+
+module.exports = componentContent; // eksportuje zawartość komponentu
+```
+
+```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>;
+};
+```
+
+## Główne funkcje
+
+Intlayer oferuje szereg funkcji dostosowanych do potrzeb nowoczesnego tworzenia stron internetowych. Poniżej znajdują się kluczowe funkcje wraz z linkami do szczegółowej dokumentacji dla każdej z nich:
+
+- **Wsparcie dla internacjonalizacji**: Zwiększ globalny zasięg swojej aplikacji dzięki wbudowanemu wsparciu dla internacjonalizacji.
+- **Edytor wizualny**: Ulepsz swój proces tworzenia dzięki wtyczkom do edytorów zaprojektowanym dla Intlayer. Sprawdź [Przewodnik po edytorze wizualnym](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_visual_editor.md).
+- **Elastyczność konfiguracji**: Dostosuj swoje środowisko za pomocą rozbudowanych opcji konfiguracyjnych opisanych w [Przewodniku po konfiguracji](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/configuration.md).
+- **Zaawansowane narzędzia CLI**: Zarządzaj swoimi projektami efektywnie, korzystając z interfejsu wiersza poleceń Intlayer. Poznaj możliwości w [Dokumentacji narzędzi CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_cli.md).
+
+## Podstawowe koncepcje
+
+### Słownik
+
+Organizuj swoje wielojęzyczne treści blisko kodu, aby wszystko było spójne i łatwe w utrzymaniu.
+
+- **[Pierwsze kroki](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/content_file.md)**  
+  Poznaj podstawy deklarowania treści w Intlayer.
+
+- **[Tłumaczenie](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/translation.md)**  
+  Zrozum, jak tłumaczenia są generowane, przechowywane i wykorzystywane w Twojej aplikacji.
+
+- **[Enumeracja](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/enumeration.md)**  
+  Łatwo zarządzaj powtarzającymi się lub stałymi zestawami danych w różnych językach.
+
+- **[Warunek](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/conditional.md)**  
+  Naucz się, jak używać logiki warunkowej w Intlayer, aby tworzyć dynamiczne treści.
+
+- **[Wstawianie](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/insertion.md)**  
+  Odkryj, jak wstawiać wartości do ciągu znaków za pomocą symboli zastępczych wstawiania.
+
+- **[Pobieranie funkcji](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/function_fetching.md)**  
+  Zobacz, jak dynamicznie pobierać zawartość za pomocą niestandardowej logiki, aby dopasować ją do przepływu pracy Twojego projektu.
+
+- **[Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/markdown.md)**  
+  Naucz się, jak używać Markdown w Intlayer do tworzenia bogatej zawartości.
+
+- **[Osadzanie plików](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/file_embeddings.md)**  
+  Odkryj, jak osadzać zewnętrzne pliki w Intlayer, aby używać ich w edytorze treści.
+
+- **[Zagnieżdżanie](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/nesting.md)**  
+  Zrozum, jak zagnieżdżać zawartość w Intlayer, aby tworzyć złożone struktury.
+
+### Środowiska i integracje
+
+Intlayer został zaprojektowany z myślą o elastyczności, oferując bezproblemową integrację z popularnymi frameworkami i narzędziami do budowania:
+
+- **[Intlayer z Next.js 16](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_with_nextjs_16.md)**
+- **[Intlayer z Next.js 15](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_with_nextjs_15.md)**
+- **[Intlayer z Next.js 14 (App Router)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_with_nextjs_14.md)**
+- **[Intlayer z Next.js Page Router](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_with_nextjs_page_router.md)**
+- **[Intlayer z React CRA](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_with_create_react_app.md)**
+- **[Intlayer z Vite + React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_with_vite+react.md)**
+- **[Intlayer z React Router v7](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_with_react_router_v7.md)**
+- **[Intlayer z Tanstack Start](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_with_tanstack.md)**
+- **[Intlayer z React Native i Expo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_with_react_native+expo.md)**
+- **[Intlayer z Lynx i React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_with_lynx+react.md)**
+- **[Intlayer z Vite + Preact](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_with_vite+preact.md)**
+- **[Intlayer z Vite + Vue](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_with_vite+vue.md)**
+- **[Intlayer z Nuxt](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_with_nuxt.md)**
+- **[Intlayer z Express](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_with_express.md)**
+- **[Intlayer z NestJS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_with_nestjs.md)**
+- **[Intlayer z Angular](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_with_angular.md)**
+
+Każdy przewodnik integracyjny zawiera najlepsze praktyki korzystania z funkcji Intlayer, takich jak **renderowanie po stronie serwera**, **dynamiczne routowanie** czy **renderowanie po stronie klienta**, dzięki czemu możesz utrzymać szybką, przyjazną dla SEO i wysoce skalowalną aplikację.
+
+## Współtworzenie i opinie
+
+Cenimy siłę open-source i rozwój oparty na społeczności. Jeśli chcesz zaproponować ulepszenia, dodać nowy przewodnik lub poprawić jakiekolwiek problemy w naszej dokumentacji, śmiało zgłoś Pull Request lub otwórz issue w naszym [repozytorium GitHub](https://github.com/aymericzip/intlayer/blob/main/docs/docs).
+
+Każdy przewodnik integracji zawiera najlepsze praktyki dotyczące korzystania z funkcji Intlayer, takich jak **renderowanie po stronie serwera**, **dynamiczne routowanie** czy **renderowanie po stronie klienta**, dzięki czemu możesz utrzymać szybką, przyjazną dla SEO i wysoce skalowalną aplikację.
+
+## Współtworzenie i opinie
+
+Cenimy siłę open-source i rozwój oparty na społeczności. Jeśli chcesz zaproponować ulepszenia, dodać nowy przewodnik lub poprawić jakiekolwiek błędy w naszej dokumentacji, śmiało zgłoś Pull Request lub otwórz issue w naszym [repozytorium GitHub](https://github.com/aymericzip/intlayer/blob/main/docs/docs).
+
+**Gotowy, aby tłumaczyć swoją aplikację szybciej i efektywniej?** Zanurz się w naszej dokumentacji i zacznij korzystać z Intlayer już dziś. Doświadcz solidnego, usprawnionego podejścia do internacjonalizacji, które pozwala utrzymać porządek w treściach i zwiększa produktywność Twojego zespołu.

package/docs/pl/locale_mapper.md

@@ -0,0 +1,242 @@
+---
+createdAt: 2025-07-27
+updatedAt: 2025-07-27
+title: Maper Lokalizacji
+description: Odkryj, jak działa Maper Lokalizacji. Zobacz kroki używane przez Maper Lokalizacji w Twojej aplikacji. Zobacz, co robią różne pakiety.
+keywords:
+  - Maper Lokalizacji
+  - Pierwsze kroki
+  - Intlayer
+  - Aplikacja
+  - Pakiety
+slugs:
+  - doc
+  - locale-mapper
+history:
+  - version: 5.7.2
+    date: 2025-07-27
+    changes: Dodano dokumentację mapera lokalizacji
+---
+
+# Maper Lokalizacji
+
+Maper Lokalizacji to potężne narzędzie, które pomaga w pracy z danymi internacjonalizacyjnymi w Twojej aplikacji Intlayer. Udostępnia trzy główne funkcje do transformacji i organizacji danych specyficznych dla lokalizacji: `localeMap`, `localeFlatMap` oraz `localeRecord`.
+
+## Jak działa Maper Lokalizacji
+
+Maper Lokalizacji działa na obiekcie `LocaleData`, który zawiera wszystkie niezbędne informacje o lokalizacji:
+
+```typescript
+type LocaleData = {
+  locale: LocalesValues; // Aktualny kod lokalizacji (np. 'en', 'fr')
+  defaultLocale: LocalesValues; // Domyślny kod lokalizacji
+  isDefault: boolean; // Czy jest to domyślna lokalizacja
+  locales: LocalesValues[]; // Tablica wszystkich dostępnych lokalizacji
+  urlPrefix: string; // Prefiks URL dla tej lokalizacji (np. '/fr' lub '')
+};
+```
+
+Funkcje mapera automatycznie generują te dane dla każdej lokalizacji w Twojej konfiguracji, uwzględniając:
+
+- Twoją skonfigurowaną listę lokalizacji
+- Ustawienie domyślnej lokalizacji
+- Czy domyślna lokalizacja powinna mieć prefiks w URL
+
+## Główne funkcje
+
+### `localeMap`
+
+Przekształca każdą lokalizację w pojedynczy obiekt za pomocą funkcji mapującej.
+
+```typescript
+localeMap<T>(
+  mapper: (locale: LocaleData) => T,
+  locales?: LocalesValues[],
+  defaultLocale?: LocalesValues,
+  prefixDefault?: boolean
+): T[]
+```
+
+**Przykład: Tworzenie obiektów tras**
+
+```typescript
+import { localeMap } from "intlayer";
+
+const routes = localeMap((localizedData) => ({
+  path: localizedData.urlPrefix,
+  name: localizedData.locale,
+  isDefault: localizedData.isDefault,
+  locales: localizedData.locales,
+  defaultLocale: localizedData.defaultLocale,
+}));
+
+// Wynik:
+// [
+//   { 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`
+
+Podobne do `localeMap`, ale funkcja mapująca zwraca tablicę obiektów, która jest spłaszczana do pojedynczej tablicy.
+
+```typescript
+localeFlatMap<T>(
+  mapper: (locale: LocaleData) => T[],
+  locales?: LocalesValues[],
+  defaultLocale?: LocalesValues,
+  prefixDefault?: boolean
+): T[]
+```
+
+**Przykład: Tworzenie wielu tras dla każdej lokalizacji**
+
+```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,
+  },
+]);
+
+// Wynik:
+// [
+//   { 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`
+
+Tworzy obiekt rekord, gdzie każdy locale jest kluczem mapującym do wartości przekształconej przez funkcję mapującą.
+
+```typescript
+localeRecord<T>(
+  mapper: (locale: LocaleData) => T,
+  locales?: Locales[],
+  defaultLocale?: Locales,
+  prefixDefault?: boolean
+): Record<Locales, T>
+```
+
+**Przykład: Ładowanie plików tłumaczeń**
+
+```typescript
+import { localeRecord } from "intlayer";
+
+const translations = localeRecord(({ locale }) =>
+  require(`./translations/${locale}.json`)
+);
+
+// Wynik:
+// {
+//   en: { welcome: 'Welcome', hello: 'Hello' },
+//   fr: { welcome: 'Bienvenue', hello: 'Bonjour' },
+//   es: { welcome: 'Bienvenido', hello: 'Hola' }
+// }
+```
+
+## Konfiguracja Locale Mapper
+
+Locale Mapper automatycznie korzysta z Twojej konfiguracji Intlayer, ale możesz nadpisać domyślne ustawienia, przekazując parametry:
+
+### Użycie domyślnej konfiguracji
+
+```typescript
+import { localeMap } from "intlayer";
+
+// Korzysta z konfiguracji z intlayer.config.ts
+const routes = localeMap((data) => ({
+  path: data.urlPrefix,
+  locale: data.locale,
+}));
+```
+
+### Nadpisanie konfiguracji
+
+```typescript
+import { localeMap } from "intlayer";
+
+// Nadpisanie locales i domyślnego locale
+const customRoutes = localeMap(
+  (data) => ({ path: data.urlPrefix, locale: data.locale }),
+  ["en", "fr", "de"], // Niestandardowe locales
+  "en", // Niestandardowy domyślny locale
+  true // Prefiksuj domyślny locale w URLach
+);
+```
+
+## Zaawansowane przykłady użycia
+
+### Tworzenie menu nawigacyjnych
+
+```typescript
+import { localeMap } from "intlayer";
+
+const navigationItems = localeMap((data) => ({
+  label: data.locale.toUpperCase(),
+  href: data.urlPrefix || "/",
+  isActive: data.isDefault,
+  flag: `/flags/${data.locale}.svg`,
+}));
+```
+
+### Generowanie danych mapy witryny
+
+```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,
+  },
+]);
+```
+
+### Dynamiczne ładowanie tłumaczeń
+
+```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",
+  },
+}));
+```
+
+## Integracja konfiguracji
+
+Locale Mapper bezproblemowo integruje się z Twoją konfiguracją Intlayer:
+
+- **Locales**: Automatycznie używa `configuration.internationalization.locales`
+- **Domyślny język**: Używa `configuration.internationalization.defaultLocale`
+- **Prefiks URL**: Respektuje `configuration.middleware.prefixDefault`
+
+Zapewnia to spójność w całej aplikacji i redukuje duplikację konfiguracji.

package/docs/pl/mcp_server.md

@@ -0,0 +1,211 @@
+---
+createdAt: 2025-06-07
+updatedAt: 2025-07-11
+title: Dokumentacja Serwera MCP
+description: Poznaj funkcje i konfigurację Serwera MCP, aby zoptymalizować zarządzanie i działanie serwera.
+keywords:
+  - Serwer MCP
+  - Zarządzanie Serwerem
+  - Optymalizacja
+  - Intlayer
+  - Dokumentacja
+  - Konfiguracja
+  - Funkcje
+slugs:
+  - doc
+  - mcp-server
+history:
+  - version: 5.5.12
+    date: 2025-07-11
+    changes: Dodano konfigurację ChatGPT
+  - version: 5.5.12
+    date: 2025-07-10
+    changes: Dodano konfigurację Claude Desktop
+  - version: 5.5.12
+    date: 2025-07-10
+    changes: Dodano transport SSE i zdalny serwer
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: Inicjalizacja historii
+---
+
+# Serwer Intlayer MCP
+
+**Serwer Intlayer MCP (Model Context Protocol)** zapewnia wsparcie IDE oparte na AI, dostosowane do ekosystemu Intlayer.
+
+## Gdzie mogę go używać?
+
+- W nowoczesnych środowiskach programistycznych, takich jak **Cursor**, **VS Code** oraz w każdym IDE obsługującym protokół MCP.
+- W Twoim ulubionym asystencie AI, takim jak **Claude Desktop**, **Gemini**, **ChatGPT** i inne.
+
+## Dlaczego warto używać Serwera Intlayer MCP?
+
+Włączając Serwer Intlayer MCP w swoim IDE, zyskujesz:
+
+- **Dokumentację świadomą kontekstu**
+  Serwer MCP ładuje i udostępnia dokumentację Intlayer. Przyspiesza to konfigurację, migracje i inne działania.
+  Zapewnia to, że sugestie kodu, opcje poleceń oraz wyjaśnienia są zawsze aktualne i odpowiednie.
+
+- **Inteligentną integrację CLI**
+  Uzyskaj dostęp i uruchamiaj polecenia Intlayer CLI bezpośrednio z interfejsu swojego IDE. Korzystając z serwera MCP, możesz pozwolić swojemu asystentowi AI na wykonywanie poleceń takich jak `intlayer dictionaries build` w celu aktualizacji słowników lub `intlayer dictionaries fill` do uzupełniania brakujących tłumaczeń.
+
+> Pełną listę poleceń i opcji znajdziesz w [dokumentacji Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_cli.md).
+
+## Serwer lokalny (stdio) vs Serwer zdalny (SSE)
+
+Serwer MCP można używać na dwa sposoby:
+
+- Serwer lokalny (stdio)
+- Serwer zdalny (SSE)
+
+### Serwer lokalny (stdio) (zalecany)
+
+Intlayer udostępnia pakiet NPM, który można zainstalować lokalnie na swoim komputerze. Może być on zainstalowany w Twoim ulubionym IDE, takim jak VS Code, Cursor, a także w lokalnej aplikacji asystenta, takiej jak ChatGPT, Claude Desktop itp.
+
+Ten serwer jest zalecanym sposobem korzystania z serwera MCP, ponieważ integruje wszystkie funkcje serwera MCP, w tym narzędzia CLI.
+
+### Serwer zdalny (SSE)
+
+Serwer MCP może być również używany zdalnie, korzystając z metody transportu SSE. Serwer ten jest hostowany przez Intlayer i jest dostępny pod adresem https://mcp.intlayer.org. Do tego serwera można uzyskać dostęp publicznie, bez żadnej autoryzacji, i jest on bezpłatny w użyciu.
+
+Należy zauważyć, że serwer zdalny nie integruje narzędzi CLI, autouzupełniania AI itp. Zdalny serwer służy wyłącznie do interakcji z dokumentacją, aby wspomóc Twojego asystenta AI w ekosystemie Intlayer.
+
+> Ze względu na koszty hostingu serwera, dostępność serwera zdalnego nie może być gwarantowana. Ograniczamy liczbę jednoczesnych połączeń. Zalecamy korzystanie z lokalnego serwera (stdio) jako metody transportu dla najbardziej niezawodnego doświadczenia.
+
+---
+
+## Konfiguracja w Cursor
+
+Postępuj zgodnie z [oficjalną dokumentacją](https://docs.cursor.com/context/mcp), aby skonfigurować serwer MCP w Cursor.
+
+W katalogu głównym projektu dodaj następujący plik konfiguracyjny `.cursor/mcp.json`:
+
+### Lokalny serwer (stdio) (zalecany)
+
+```json fileName=".cursor/mcp.json"
+{
+  "mcpServers": {
+    "intlayer": {
+      "command": "npx",
+      "args": ["-y", "@intlayer/mcp"]
+    }
+  }
+}
+```
+
+### Serwer zdalny (SSE)
+
+Aby połączyć się ze zdalnym serwerem Intlayer MCP za pomocą Server-Sent Events (SSE), możesz skonfigurować swojego klienta MCP do łączenia się z usługą hostowaną.
+
+```json fileName=".cursor/mcp.json"
+{
+  "mcpServers": {
+    "intlayer": {
+      "url": "https://mcp.intlayer.org",
+      "transport": "sse"
+    }
+  }
+}
+```
+
+To polecenie informuje Twoje IDE, aby uruchomiło serwer Intlayer MCP za pomocą `npx`, zapewniając, że zawsze używana jest najnowsza dostępna wersja, chyba że ją przypniesz.
+
+---
+
+## Konfiguracja w VS Code
+
+Postępuj zgodnie z [oficjalną dokumentacją](https://code.visualstudio.com/docs/copilot/chat/mcp-servers), aby skonfigurować serwer MCP w VS Code.
+
+Aby korzystać z serwera Intlayer MCP w VS Code, musisz go skonfigurować w ustawieniach workspace lub użytkownika.
+
+### Lokalny serwer (stdio) (zalecane)
+
+Utwórz plik `.vscode/mcp.json` w katalogu głównym projektu:
+
+```json fileName=".vscode/mcp.json"
+{
+  "servers": {
+    "intlayer": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@intlayer/mcp"]
+    }
+  }
+}
+```
+
+### Serwer zdalny (SSE)
+
+Aby połączyć się ze zdalnym serwerem Intlayer MCP za pomocą Server-Sent Events (SSE), możesz skonfigurować swojego klienta MCP do łączenia się z usługą hostowaną.
+
+```json fileName=".vscode/mcp.json"
+{
+  "servers": {
+    "intlayer": {
+      "url": "https://mcp.intlayer.org",
+      "type": "sse"
+    }
+  }
+}
+```
+
+---
+
+## Konfiguracja w ChatGPT
+
+### Serwer zdalny (SSE)
+
+Postępuj zgodnie z [oficjalną dokumentacją](https://platform.openai.com/docs/mcp#test-and-connect-your-mcp-server), aby skonfigurować serwer MCP w ChatGPT.
+
+1. Przejdź do [panelu promptów](https://platform.openai.com/prompts)
+2. Kliknij `+ Create`
+3. Kliknij `Tools (Create or +)`
+4. Wybierz `MCP Server`
+5. Kliknij `Add new`
+6. Wypełnij następujące pola:
+   - URL: `https://mcp.intlayer.org`
+   - Label: `Intlayer MCP Server`
+   - Name: `intlayer-mcp-server`
+   - Authentication: `None`
+
+7. Kliknij `Save`
+
+---
+
+## Konfiguracja w Claude Desktop
+
+Postępuj zgodnie z [oficjalną dokumentacją](https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server), aby skonfigurować serwer MCP w Claude Desktop.
+
+Ścieżka do pliku konfiguracyjnego:
+
+- macOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+
+### Lokalny serwer (stdio) (zalecane)
+
+```json fileName="claude_desktop_config.json"
+{
+  "mcpServers": {
+    "intlayer": {
+      "command": "npx",
+      "args": ["-y", "@intlayer/mcp"]
+    }
+  }
+}
+```
+
+---
+
+## Korzystanie z serwera MCP przez CLI
+
+Możesz również uruchomić serwer Intlayer MCP bezpośrednio z linii poleceń do testowania, debugowania lub integracji z innymi narzędziami.
+
+```bash
+# Instalacja globalna
+npm install -g @intlayer/mcp
+
+# Lub użycie bezpośrednio przez npx (zalecane)
+npx @intlayer/mcp
+```
+
+---