@intlayer/docs 5.5.12 → 5.6.0

package/docs/en/intlayer_with_vite+solid.md

@@ -14,6 +14,7 @@ slugs:
   - doc
   - environment
   - vite-and-solid
+# applicationTemplate: https://github.com/aymericzip/intlayer-vite-solid-template
 ---
 
 # Getting Started Internationalizing (i18n) with Intlayer and Vite and Solid
@@ -43,17 +44,17 @@ Install the necessary packages using npm:
 
 ```bash packageManager="npm"
 npm install intlayer solid-intlayer
-npm install --save-dev vite-intlayer
+npm install vite-intlayer --save-dev
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer solid-intlayer
-pnpm add --save-dev vite-intlayer
+pnpm add vite-intlayer --save-dev
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer solid-intlayer
-yarn add --save-dev vite-intlayer
+yarn add vite-intlayer --save-dev
 ```
 
 - **intlayer**

package/docs/en/intlayer_with_vite+svelte.md

@@ -14,6 +14,7 @@ slugs:
   - doc
   - environment
   - vite-and-svelte
+# applicationTemplate: https://github.com/aymericzip/intlayer-vite-svelte-template
 ---
 
 # Getting Started Internationalizing (i18n) with Intlayer and Vite and Svelte
@@ -43,17 +44,17 @@ Install the necessary packages using npm:
 
 ```bash packageManager="npm"
 npm install intlayer svelte-intlayer
-npm install --save-dev vite-intlayer
+npm install vite-intlayer --save-dev
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer svelte-intlayer
-pnpm add --save-dev vite-intlayer
+pnpm add vite-intlayer --save-dev
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer svelte-intlayer
-yarn add --save-dev vite-intlayer
+yarn add vite-intlayer --save-dev
 ```
 
 - **intlayer**

package/docs/en/intlayer_with_vite+vue.md

@@ -14,6 +14,7 @@ slugs:
   - doc
   - environment
   - vite-and-vue
+applicationTemplate: https://github.com/aymericzip/intlayer-vite-vue-template
 ---
 
 # Getting Started Internationalizing (i18n) with Intlayer and Vite and Vue
@@ -41,17 +42,17 @@ Install the necessary packages using npm:
 
 ```bash packageManager="npm"
 npm install intlayer vue-intlayer
-npm install --save-dev vite-intlayer
+npm install vite-intlayer --save-dev
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer vue-intlayer
-pnpm add --save-dev vite-intlayer
+pnpm add vite-intlayer --save-dev
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer vue-intlayer
-yarn add --save-dev vite-intlayer
+yarn add vite-intlayer --save-dev
 ```
 
 - **intlayer**
@@ -646,6 +647,8 @@ import LocaleSwitcher from "@components/LocaleSwitcher.vue";
 
 In parallel, you can also use the `intLayerMiddlewarePlugin` to add server-side routing to your application. This plugin will automatically detect the current locale based on the URL and set the appropriate locale cookie. If no locale is specified, the plugin will determine the most appropriate locale based on the user's browser language preferences. If no locale is detected, it will redirect to the default locale.
 
+> Note that to use the `intLayerMiddlewarePlugin` in production, you need to switch the `vite-intlayer` package from `devDependencies` to `dependencies`.
+
 ```typescript {3,7} fileName="vite.config.ts" codeFormat="typescript"
 import { defineConfig } from "vite";
 import vue from "@vitejs/plugin-vue";
@@ -938,7 +941,7 @@ By default Intlayer render markdown as string. But Intlayer also provides a way
 
 > To see how to declare markdown content using the `intlayer` package, see the [markdown doc](https://github.com/aymericzip/intlayer/tree/main/docs/en/dictionary/markdown.md).
 
-```ts filename="main.ts"
+```ts fileName="main.ts"
 import MarkdownIt from "markdown-it";
 import { createApp, h } from "vue";
 import { installIntlayer, installIntlayerMarkdown } from "vue-intlayer";

package/docs/en/mcp_server.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-06-07
-updatedAt: 2025-06-07
+updatedAt: 2025-07-11
 title: MCP Server Documentation
 description: Explore the features and setup of the MCP Server to optimize your server management and operations.
 keywords:
@@ -18,31 +18,58 @@ slugs:
 
 # Intlayer MCP Server
 
-The **Intlayer MCP (Model Context Protocol) Server** provides AI-powered IDE assistance tailored for the Intlayer ecosystem. Designed for modern developer environments like **Cursor**, **GitHub Copilot workspace**, and any IDE supporting the MCP protocol, this server gives you contextual, real-time support based on your project's setup.
+The **Intlayer MCP (Model Context Protocol) Server** provides AI-powered IDE assistance tailored for the Intlayer ecosystem.
+
+## Where can I use it?
+
+- On modern developer environments like **Cursor**, **VS Code**, and any IDE supporting the MCP protocol.
+- On your favorite AI assistant like **Claude Desktop**, **Gemini**, **ChatGPT**, etc.
 
 ## Why Use the Intlayer MCP Server?
 
 By enabling the Intlayer MCP Server in your IDE, you unlock:
 
+- **Context-Aware Documentation**
+  The MCP server loads and exposes the documentation of Intlayer. To speed up your set up, your migrations, etc.
+  This ensures that code suggestions, command options, and explanations are always up to date and relevant.
+
 - **Smart CLI Integration**
-  Access and run Intlayer CLI commands directly from your IDE interface. View the full list of commands and options in the [Intlayer CLI documentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_cli.md).
+  Access and run Intlayer CLI commands directly from your IDE interface. Using the MCP server, you can let your AI assistant run commands like `intlayer dictionaries build` to update your dictionaries, or `intlayer dictionaries fill` to fill your missing translations.
 
-- **Context-Aware Documentation**
-  The MCP server loads and exposes the documentation that corresponds to the version of Intlayer you're using in your project. This ensures that code suggestions, command options, and explanations are always up to date and relevant.
+  > View the full list of commands and options in the [Intlayer CLI documentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_cli.md).
+
+## Local server (stdio) vs Remote server (SSE)
+
+The MCP server can be used in two ways:
+
+- Local server (stdio)
+- Remote server (SSE)
+
+### Local server (stdio) (recommended)
+
+Intlayer provides a NPM package that can be installed locally on your machine. It can be installed in your favorite IDE, as VS Code, Cursor, as well as your locale assistant application, as ChatGPT, Claude Desktop, etc.
 
-- **AI-Assisted Development**
-  With project-aware suggestions and autocomplete, the AI assistant can explain your code, recommend CLI usage, or suggest how to use specific features of Intlayer based on your current files.
+This server is the recommended way to use the MCP server. As it integrates all the features of the MCP server, including the CLI tools.
 
-- **Lightweight & Instant Setup**
-  No server maintenance or heavy install required. Just configure your `.cursor/mcp.json` or equivalent MCP config and you're ready to go.
+### Remote server (SSE)
+
+The MCP server can also be used remotely, using the SSE transport method. This server is hosted by Intlayer, and is available at https://mcp.intlayer.org. This server can be accessed publicly, without any authentication, and is free to use.
+
+Note that the remote server does not integrate CLI tools, AI autocompletion, etc. The distant server is only for interaction with the documentation to help your AI assistant with the Intlayer ecosystem.
+
+> Due to server hosting costs, the availability of the remote server cannot be guaranteed. We limit the number of simultaneous connections. We recommend using the local server (stdio) transport method for the most reliable experience.
 
 ---
 
-## Setup Cursor
+## Setup in Cursor
+
+Follow the [official documentation](https://docs.cursor.com/context/mcp) to configure the MCP server in Cursor.
 
 In your project root, add the following `.cursor/mcp.json` configuration file:
 
-```json
+### Local server (stdio) (recommended)
+
+```json fileName=".cursor/mcp.json"
 {
   "mcpServers": {
     "intlayer": {
@@ -53,19 +80,36 @@ In your project root, add the following `.cursor/mcp.json` configuration file:
 }
 ```
 
+### Remote server (SSE)
+
+For connecting to a remote Intlayer MCP server using Server-Sent Events (SSE), you can configure your MCP client to connect to the hosted service.
+
+```json fileName=".cursor/mcp.json"
+{
+  "mcpServers": {
+    "intlayer": {
+      "url": "https://mcp.intlayer.org",
+      "transport": "sse"
+    }
+  }
+}
+```
+
 This tells your IDE to launch the Intlayer MCP server using `npx`, ensuring it always uses the latest available version unless you pin it.
 
 ---
 
-## Setup VS Code
+## Setup in VS Code
+
+Follow the [official documentation](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) to configure the MCP server in VS Code.
 
 To use the Intlayer MCP Server with VS Code, you need to configure it in your workspace or user settings.
 
-### Workspace Configuration
+### Local server (stdio) (recommended)
 
 Create a `.vscode/mcp.json` file in your project root:
 
-```json
+```json fileName=".vscode/mcp.json"
 {
   "servers": {
     "intlayer": {
@@ -77,72 +121,73 @@ Create a `.vscode/mcp.json` file in your project root:
 }
 ```
 
-### Using the MCP Server in VS Code
+### Remote server (SSE)
 
-1. **Enable Agent Mode**: Open the Chat view (⌃⌘I on Mac, Ctrl+Alt+I on Windows/Linux) and select **Agent** mode from the dropdown.
+For connecting to a remote Intlayer MCP server using Server-Sent Events (SSE), you can configure your MCP client to connect to the hosted service.
 
-2. **Access Tools**: Click the **Tools** button to view available Intlayer tools. You can select/deselect specific tools as needed.
+```json fileName=".vscode/mcp.json"
+{
+  "servers": {
+    "intlayer": {
+      "url": "https://mcp.intlayer.org",
+      "type": "sse"
+    }
+  }
+}
+```
 
-3. **Direct Tool Reference**: Reference tools directly in your prompts by typing `#` followed by the tool name.
+---
 
-4. **Tool Confirmation**: By default, VS Code will ask for confirmation before running tools. Use the **Continue** button options to automatically confirm tools for the current session, workspace, or all future invocations.
+## Set Up in ChatGPT
 
-### Managing the Server
+### Remote server (SSE)
 
-- Run **MCP: List Servers** from the Command Palette to view configured servers
-- Start, stop, or restart the Intlayer MCP server as needed
-- View server logs for troubleshooting by selecting the server and choosing **Show Output**
+Follow the [official documentation](https://platform.openai.com/docs/mcp#test-and-connect-your-mcp-server) to configure the MCP server in ChatGPT.
 
-For more detailed information about VS Code MCP integration, see the [official VS Code MCP documentation](https://code.visualstudio.com/docs/copilot/chat/mcp-servers).
+1. Go to the [promt dashboard](https://platform.openai.com/prompts)
+2. Click on `+ Create`
+3. Click on `Tools (Create or +)`
+4. Select `MCP Server`
+5. Click on `Add new`
+6. Fill the following fields:
 
----
+   - URL: `https://mcp.intlayer.org`
+   - Label: `Intlayer MCP Server`
+   - Name: `intlayer-mcp-server`
+   - Authentication: `None`
 
-## Setup with Remote Server (SSE)
+7. Click on `Save`
 
-For connecting to a remote Intlayer MCP server using Server-Sent Events (SSE), you can configure your MCP client to connect to the hosted service.
+---
 
-### Cursor Configuration
+## Set Up in Claude Desktop
 
-Add the following to your `.cursor/mcp.json` configuration file:
+Follow the [official documentation](https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server) to configure the MCP server in Claude Desktop.
 
-```json
-{
-  "mcpServers": {
-    "intlayer-sse": {
-      "url": "http://mcp.intlayer.com",
-      "transport": "sse"
-    }
-  }
-}
-```
+Path of the config file:
 
-### VS Code Configuration
+- macOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
 
-Add the following to your `.vscode/mcp.json` configuration file:
+### Local server (stdio) (recommended)
 
-```json
+```json fileName="claude_desktop_config.json"
 {
-  "servers": {
-    "intlayer-sse": {
-      "type": "sse",
-      "url": "http://mcp.intlayer.com"
+  "mcpServers": {
+    "intlayer": {
+      "command": "npx",
+      "args": ["-y", "@intlayer/mcp"]
     }
   }
 }
 ```
 
-This configuration allows you to connect to a remote Intlayer MCP server without needing to run the server locally. The remote server provides the same functionality as the local version but is hosted and maintained externally.
-
 ---
 
 ## Using the MCP Server via CLI
 
 You can also run the Intlayer MCP server directly from the command line for testing, debugging, or integration with other tools.
 
-### Install the MCP Server
-
-First, install the MCP server package globally or use it via npx:
-
 ```bash
 # Install globally
 npm install -g @intlayer/mcp
@@ -151,65 +196,13 @@ npm install -g @intlayer/mcp
 npx @intlayer/mcp
 ```
 
-### Start the Server
-
-To start the MCP server with the inspector for debugging and testing:
-
-```bash
-# Using the built-in start command
-npm run start
-
-# Or directly with npx
-npx @modelcontextprotocol/inspector npx @intlayer/mcp
-```
-
-This will launch the MCP server with an inspector interface that allows you to:
-
-- Test MCP protocol communications
-- Debug server responses
-- Validate tool and resource implementations
-- Monitor server performance
-
-### Development Usage
-
-For development and testing purposes, you can run the server in various modes:
-
-```bash
-# Build and start in development mode
-npm run dev
-
-# Run with custom configuration
-node dist/cjs/index.cjs
-
-# Test the server functionality
-npm test
-```
-
-The server will expose Intlayer-specific tools and resources that can be consumed by any MCP-compatible client, not just Cursor or other IDEs.
-
----
-
-## Features Overview
-
-| Feature        | Description                                                                  |
-| -------------- | ---------------------------------------------------------------------------- |
-| CLI Support    | Run `intlayer` commands, get usage hints and arguments inline                |
-| Versioned Docs | Auto-detect and load documentation matching your current version of Intlayer |
-| Autocompletion | Intelligent command and config suggestions as you type                       |
-| Plugin-Ready   | Compatible with IDEs and tools that support the MCP standard                 |
-
----
-
-##Useful Links
-
-- [Intlayer CLI Documentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_cli.md)
-- [Intlayer GitHub Repository](https://github.com/aymericzip/intlayer)
-
 ---
 
 ## Doc History
 
 | Version | Date       | Changes                              |
 | ------- | ---------- | ------------------------------------ |
-| 5.5.11  | 2025-07-10 | Add SSE transport and distant server |
+| 5.5.12  | 2025-07-11 | Add set up of ChatGPT                |
+| 5.5.12  | 2025-07-10 | Add set up of Claude Desktop         |
+| 5.5.12  | 2025-07-10 | Add SSE transport and distant server |
 | 5.5.10  | 2025-06-29 | Init history                         |

package/docs/en-GB/intlayer_CMS.md

@@ -16,6 +16,7 @@ slugs:
   - doc
   - concept
   - cms
+youtubeVideo: https://www.youtube.com/watch?v=UDDTnirwi_4
 ---
 
 # Intlayer Content Management System (CMS) Documentation