@intlayer/docs 5.5.11 → 5.6.0

package/docs/en-GB/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 optimise 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 such as **Cursor**, **GitHub Copilot workspace**, and any IDE supporting the MCP protocol, this server offers 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 favourite 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:
 
-- **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-GB/intlayer_cli.md).
+- **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. 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.
+
+  > View the full list of commands and options in the [Intlayer CLI documentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/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 an NPM package that can be installed locally on your machine. It can be installed in your favourite IDE, such as VS Code, Cursor, as well as your local assistant application, such as ChatGPT, Claude Desktop, etc.
 
-- **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.
+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.
 
-- **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.
+### Remote server (SSE)
 
-- **Lightweight & Instant Setup**  
-  No server maintenance or heavy installation required. Just configure your `.cursor/mcp.json` or equivalent MCP config and you're ready to go.
+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 remote server is only for interaction with the documentation to assist 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:
 }
 ```
 
-This instructs your IDE to launch the Intlayer MCP server using `npx`, ensuring it always uses the latest available version unless you choose to pin it.
+### 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 instructs 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,98 +121,88 @@ Create a `.vscode/mcp.json` file in your project root:
 }
 ```
 
-### Using the MCP Server in VS Code
-
-1. **Enable Agent Mode**: Open the Chat view (⌃⌘I on Mac, Ctrl+Alt+I on Windows/Linux) and select **Agent** mode from the dropdown.
-
-2. **Access Tools**: Click the **Tools** button to view available Intlayer tools. You can select or deselect specific tools as required.
-
-3. **Direct Tool Reference**: Refer to tools directly in your prompts by typing `#` followed by the tool name.
+### Remote server (SSE)
 
-4. **Tool Confirmation**: By default, VS Code will request confirmation before running tools. Use the **Continue** button options to automatically confirm tools for the current session, workspace, or all future invocations.
+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.
 
-### Managing the Server
-
-- 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**
-
-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).
+```json fileName=".vscode/mcp.json"
+{
+  "servers": {
+    "intlayer": {
+      "url": "https://mcp.intlayer.org",
+      "type": "sse"
+    }
+  }
+}
+```
 
 ---
 
-## 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
+## Set Up in ChatGPT
 
-# Or use directly with npx (recommended)
-npx @intlayer/mcp
-```
+### Remote server (SSE)
 
-### Start the Server
+Follow the [official documentation](https://platform.openai.com/docs/mcp#test-and-connect-your-mcp-server) to configure the MCP server in ChatGPT.
 
-To start the MCP server with the inspector for debugging and testing:
+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:
 
-```bash
-# Using the built-in start command
-npm run start
+   - URL: `https://mcp.intlayer.org`
+   - Label: `Intlayer MCP Server`
+   - Name: `intlayer-mcp-server`
+   - Authentication: `None`
 
-# Or directly with npx
-npx @modelcontextprotocol/inspector npx @intlayer/mcp
-```
+7. Click on `Save`
 
-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
+## Set Up in Claude Desktop
 
-### Development Usage
+Follow the [official documentation](https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server) to configure the MCP server in Claude Desktop.
 
-For development and testing purposes, you can run the server in various modes:
+Path of the config file:
 
-```bash
-# Build and start in development mode
-npm run dev
+- macOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
 
-# Run with custom configuration
-node dist/cjs/index.cjs
+### Local server (stdio) (recommended)
 
-# Test the server functionality
-npm test
+```json fileName="claude_desktop_config.json"
+{
+  "mcpServers": {
+    "intlayer": {
+      "command": "npx",
+      "args": ["-y", "@intlayer/mcp"]
+    }
+  }
+}
 ```
 
-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                 |
+## 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.
 
-## Useful Links
+```bash
+# Install globally
+npm install -g @intlayer/mcp
 
-- [Intlayer CLI Documentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/intlayer_cli.md)
-- [Intlayer GitHub Repository](https://github.com/aymericzip/intlayer)
+# Or use directly with npx (recommended)
+npx @intlayer/mcp
+```
 
 ---
 
 ## Doc History
 
-- 5.5.10 - 2025-06-29: Init history
+| Version | Date       | Changes                              |
+| ------- | ---------- | ------------------------------------ |
+| 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 | Initialise history                   |

package/docs/es/intlayer_CMS.md

@@ -16,6 +16,7 @@ slugs:
   - doc
   - concept
   - cms
+youtubeVideo: https://www.youtube.com/watch?v=UDDTnirwi_4
 ---
 
 # Documentación del Sistema de Gestión de Contenidos (CMS) de Intlayer