@intlayer/docs 5.5.11 → 5.6.0

package/docs/it/intlayer_with_vite+solid.md

@@ -14,6 +14,7 @@ slugs:
   - doc
   - environment
   - vite-and-solid
+# applicationTemplate: https://github.com/aymericzip/intlayer-vite-solid-template
 ---
 
 # Iniziare con l'internazionalizzazione (i18n) con Intlayer, Vite e Solid
@@ -43,17 +44,17 @@ Installa i pacchetti necessari usando 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/it/intlayer_with_vite+svelte.md

@@ -14,6 +14,7 @@ slugs:
   - doc
   - environment
   - vite-and-svelte
+# applicationTemplate: https://github.com/aymericzip/intlayer-vite-svelte-template
 ---
 
 # Iniziare con l'internazionalizzazione (i18n) con Intlayer, Vite e Svelte
@@ -43,17 +44,17 @@ Installa i pacchetti necessari usando 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/it/intlayer_with_vite+vue.md

@@ -41,17 +41,17 @@ Installa i pacchetti necessari usando 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**
@@ -993,7 +993,7 @@ Per impostazione predefinita Intlayer rende il markdown come stringa. Ma Intlaye
 
 > Per vedere come dichiarare contenuti markdown usando il pacchetto `intlayer`, consulta la [documentazione markdown](https://github.com/aymericzip/intlayer/tree/main/docs/it/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/it/mcp_server.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-06-07
-updatedAt: 2025-06-07
+updatedAt: 2025-07-11
 title: Documentazione del Server MCP
 description: Esplora le funzionalità e la configurazione del Server MCP per ottimizzare la gestione e le operazioni del tuo server.
 keywords:
@@ -18,31 +18,58 @@ slugs:
 
 # Server MCP di Intlayer
 
-Il **Server Intlayer MCP (Model Context Protocol)** fornisce assistenza IDE potenziata dall'IA, progettata specificamente per l'ecosistema Intlayer. Ideato per ambienti di sviluppo moderni come **Cursor**, **GitHub Copilot workspace** e qualsiasi IDE che supporti il protocollo MCP, questo server ti offre supporto contestuale e in tempo reale basato sulla configurazione del tuo progetto.
+Il **Server MCP (Model Context Protocol) di Intlayer** fornisce assistenza IDE potenziata dall'IA, su misura per l'ecosistema Intlayer.
 
-## Perché usare il Server Intlayer MCP?
+## Dove posso usarlo?
 
-Abilitando il Server Intlayer MCP nel tuo IDE, potrai usufruire di:
+- Su ambienti di sviluppo moderni come **Cursor**, **VS Code** e qualsiasi IDE che supporti il protocollo MCP.
+- Sul tuo assistente AI preferito come **Claude Desktop**, **Gemini**, **ChatGPT**, ecc.
 
-- **Integrazione intelligente della CLI**
-  Accedi ed esegui i comandi della CLI Intlayer direttamente dall'interfaccia del tuo IDE. Visualizza l'elenco completo dei comandi e delle opzioni nella [documentazione della CLI Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_cli.md).
+## Perché usare il Server MCP di Intlayer?
 
-- **Documentazione contestuale**
-  Il server MCP carica ed espone la documentazione corrispondente alla versione di Intlayer che stai utilizzando nel tuo progetto. Questo garantisce che i suggerimenti di codice, le opzioni dei comandi e le spiegazioni siano sempre aggiornati e pertinenti.
+Abilitando il Server MCP di Intlayer nel tuo IDE, sblocchi:
 
-- **Sviluppo assistito dall'IA**
-  Con suggerimenti e completamento automatico consapevoli del progetto, l'assistente IA può spiegare il tuo codice, consigliare l'uso della CLI o suggerire come utilizzare funzionalità specifiche di Intlayer basandosi sui file attuali.
+- **Documentazione Contestuale**
+  Il server MCP carica ed espone la documentazione di Intlayer. Per velocizzare la tua configurazione, le tue migrazioni, ecc.
+  Questo garantisce che i suggerimenti di codice, le opzioni dei comandi e le spiegazioni siano sempre aggiornati e pertinenti.
 
-- **Leggero e configurazione istantanea**
-  Nessuna manutenzione del server o installazione pesante richiesta. Basta configurare il file `.cursor/mcp.json` o un equivalente file di configurazione MCP e sei pronto per partire.
+- **Integrazione Intelligente della CLI**
+  Accedi ed esegui i comandi CLI di Intlayer direttamente dall'interfaccia del tuo IDE. Utilizzando il server MCP, puoi permettere al tuo assistente AI di eseguire comandi come `intlayer dictionaries build` per aggiornare i tuoi dizionari, o `intlayer dictionaries fill` per completare le traduzioni mancanti.
+
+  > Visualizza l'elenco completo dei comandi e delle opzioni nella [documentazione CLI di Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_cli.md).
+
+## Server locale (stdio) vs Server remoto (SSE)
+
+Il server MCP può essere utilizzato in due modi:
+
+- Server locale (stdio)
+- Server remoto (SSE)
+
+### Server locale (stdio) (consigliato)
+
+Intlayer fornisce un pacchetto NPM che può essere installato localmente sulla tua macchina. Può essere installato nel tuo IDE preferito, come VS Code, Cursor, così come nella tua applicazione assistente locale, come ChatGPT, Claude Desktop, ecc.
+
+Questo server è il modo consigliato per utilizzare il server MCP, in quanto integra tutte le funzionalità del server MCP, inclusi gli strumenti CLI.
+
+### Server remoto (SSE)
+
+Il server MCP può essere utilizzato anche da remoto, utilizzando il metodo di trasporto SSE. Questo server è ospitato da Intlayer ed è disponibile all'indirizzo https://mcp.intlayer.org. Questo server è accessibile pubblicamente, senza alcuna autenticazione, ed è gratuito.
+
+Nota che il server remoto non integra strumenti CLI, completamento automatico AI, ecc. Il server remoto è solo per l'interazione con la documentazione per aiutare il tuo assistente AI con l'ecosistema Intlayer.
+
+> A causa dei costi di hosting del server, la disponibilità del server remoto non può essere garantita. Limitiamo il numero di connessioni simultanee. Raccomandiamo di utilizzare il metodo di trasporto del server locale (stdio) per un'esperienza più affidabile.
 
 ---
 
-## Configurazione di Cursor
+## Configurazione in Cursor
+
+Segui la [documentazione ufficiale](https://docs.cursor.com/context/mcp) per configurare il server MCP in Cursor.
 
 Nella radice del tuo progetto, aggiungi il seguente file di configurazione `.cursor/mcp.json`:
 
-```json
+### Server locale (stdio) (consigliato)
+
+```json fileName=".cursor/mcp.json"
 {
   "mcpServers": {
     "intlayer": {
@@ -53,19 +80,36 @@ Nella radice del tuo progetto, aggiungi il seguente file di configurazione `.cur
 }
 ```
 
-Questo indica al tuo IDE di avviare il server MCP di Intlayer utilizzando `npx`, assicurandosi che venga sempre usata la versione più recente disponibile a meno che tu non la blocchi.
+### Server remoto (SSE)
+
+Per connettersi a un server MCP Intlayer remoto utilizzando Server-Sent Events (SSE), puoi configurare il tuo client MCP per connettersi al servizio ospitato.
+
+```json fileName=".cursor/mcp.json"
+{
+  "mcpServers": {
+    "intlayer": {
+      "url": "https://mcp.intlayer.org",
+      "transport": "sse"
+    }
+  }
+}
+```
+
+Questo indica al tuo IDE di avviare il server MCP Intlayer usando `npx`, assicurandosi che utilizzi sempre l'ultima versione disponibile a meno che non venga bloccata.
 
 ---
 
-## Configurare VS Code
+## Configurazione in VS Code
 
-Per utilizzare il server MCP di Intlayer con VS Code, devi configurarlo nelle impostazioni del workspace o dell'utente.
+Segui la [documentazione ufficiale](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) per configurare il server MCP in VS Code.
 
-### Configurazione del Workspace
+Per utilizzare il server MCP Intlayer con VS Code, devi configurarlo nelle impostazioni del tuo workspace o utente.
+
+### Server locale (stdio) (consigliato)
 
 Crea un file `.vscode/mcp.json` nella radice del tuo progetto:
 
-```json
+```json fileName=".vscode/mcp.json"
 {
   "servers": {
     "intlayer": {
@@ -77,98 +121,88 @@ Crea un file `.vscode/mcp.json` nella radice del tuo progetto:
 }
 ```
 
-### Utilizzo del server MCP in VS Code
-
-1. **Abilita la modalità Agent**: Apri la vista Chat (⌃⌘I su Mac, Ctrl+Alt+I su Windows/Linux) e seleziona la modalità **Agent** dal menu a tendina.
-
-2. **Accedi agli Strumenti**: Clicca sul pulsante **Strumenti** per visualizzare gli strumenti Intlayer disponibili. Puoi selezionare/deselezionare strumenti specifici secondo necessità.
-
-3. **Riferimento Diretto agli Strumenti**: Fai riferimento agli strumenti direttamente nei tuoi prompt digitando `#` seguito dal nome dello strumento.
+### Server remoto (SSE)
 
-4. **Conferma degli Strumenti**: Per impostazione predefinita, VS Code chiederà conferma prima di eseguire gli strumenti. Usa le opzioni del pulsante **Continua** per confermare automaticamente gli strumenti per la sessione corrente, il workspace o tutte le invocazioni future.
+Per connettersi a un server MCP Intlayer remoto utilizzando Server-Sent Events (SSE), puoi configurare il tuo client MCP per connettersi al servizio ospitato.
 
-### Gestione del Server
-
-- Esegui **MCP: Elenca Server** dalla Command Palette per visualizzare i server configurati
-- Avvia, ferma o riavvia il server MCP di Intlayer secondo necessità
-- Visualizza i log del server per la risoluzione dei problemi selezionando il server e scegliendo **Mostra Output**
-
-Per maggiori informazioni sull'integrazione MCP in VS Code, consulta la [documentazione ufficiale MCP di VS Code](https://code.visualstudio.com/docs/copilot/chat/mcp-servers).
+```json fileName=".vscode/mcp.json"
+{
+  "servers": {
+    "intlayer": {
+      "url": "https://mcp.intlayer.org",
+      "type": "sse"
+    }
+  }
+}
+```
 
 ---
 
-## Utilizzo del Server MCP tramite CLI
+## Configurazione in ChatGPT
 
-Puoi anche eseguire il server MCP di Intlayer direttamente dalla riga di comando per test, debug o integrazione con altri strumenti.
+### Server remoto (SSE)
 
-### Installare il Server MCP
+Segui la [documentazione ufficiale](https://platform.openai.com/docs/mcp#test-and-connect-your-mcp-server) per configurare il server MCP in ChatGPT.
 
-Per prima cosa, installa il pacchetto del server MCP globalmente oppure usalo tramite npx:
+1. Vai al [promt dashboard](https://platform.openai.com/prompts)
+2. Clicca su `+ Create`
+3. Clicca su `Tools (Create or +)`
+4. Seleziona `MCP Server`
+5. Clicca su `Add new`
+6. Compila i seguenti campi:
 
-```bash
-# Installa globalmente
-npm install -g @intlayer/mcp
-
-# Oppure usa direttamente con npx (consigliato)
-npx @intlayer/mcp
-```
+   - URL: `https://mcp.intlayer.org`
+   - Label: `Intlayer MCP Server`
+   - Name: `intlayer-mcp-server`
+   - Authentication: `None`
 
-### Avviare il Server
+7. Clicca su `Save`
 
-Per avviare il server MCP con l'inspector per il debug e i test:
-
-```bash
-# Usando il comando start integrato
-npm run start
-
-# Oppure direttamente con npx
-npx @modelcontextprotocol/inspector npx @intlayer/mcp
-```
-
-Questo avvierà il server MCP con un'interfaccia inspector che ti permette di:
+---
 
-- Testare le comunicazioni del protocollo MCP
-- Eseguire il debug delle risposte del server
-- Validare le implementazioni di strumenti e risorse
-- Monitorare le prestazioni del server
+## Configurazione in Claude Desktop
 
-### Uso per lo Sviluppo
+Segui la [documentazione ufficiale](https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server) per configurare il server MCP in Claude Desktop.
 
-Per scopi di sviluppo e test, puoi eseguire il server in diverse modalità:
+Percorso del file di configurazione:
 
-```bash
-# Compila e avvia in modalità sviluppo
-npm run dev
+- macOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
 
-# Esegui con configurazione personalizzata
-node dist/cjs/index.cjs
+### Server locale (stdio) (consigliato)
 
-# Testa la funzionalità del server
-npm test
+```json fileName="claude_desktop_config.json"
+{
+  "mcpServers": {
+    "intlayer": {
+      "command": "npx",
+      "args": ["-y", "@intlayer/mcp"]
+    }
+  }
+}
 ```
 
-Il server esporrà strumenti e risorse specifici di Intlayer che possono essere utilizzati da qualsiasi client compatibile con MCP, non solo da Cursor o altri IDE.
-
 ---
 
-## Panoramica delle Funzionalità
-
-| Feature                   | Description                                                                                             |
-| ------------------------- | ------------------------------------------------------------------------------------------------------- |
-| Supporto CLI              | Esegui comandi `intlayer`, ottieni suggerimenti sull'uso e argomenti inline                             |
-| Documentazione Versionata | Rileva automaticamente e carica la documentazione corrispondente alla tua versione corrente di Intlayer |
-| Completamento Automatico  | Suggerimenti intelligenti per comandi e configurazioni mentre digiti                                    |
-| Pronto per Plugin         | Compatibile con IDE e strumenti che supportano lo standard MCP                                          |
+## Utilizzo del Server MCP tramite CLI
 
----
+Puoi anche eseguire direttamente il server MCP di Intlayer dalla riga di comando per test, debug o integrazione con altri strumenti.
 
-## Link Utili
+```bash
+# Installa globalmente
+npm install -g @intlayer/mcp
 
-- [Documentazione CLI di Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_cli.md)
-- [Repository GitHub di Intlayer](https://github.com/aymericzip/intlayer)
+# Oppure usa direttamente con npx (consigliato)
+npx @intlayer/mcp
+```
 
 ---
 
-## Cronologia Documentazione
+## Cronologia del Documento
 
-- 5.5.10 - 2025-06-29: Inizio cronologia
+| Versione | Data       | Modifiche                                 |
+| -------- | ---------- | ----------------------------------------- |
+| 5.5.12   | 2025-07-11 | Aggiunta configurazione di ChatGPT        |
+| 5.5.12   | 2025-07-10 | Aggiunta configurazione di Claude Desktop |
+| 5.5.12   | 2025-07-10 | Aggiunto trasporto SSE e server remoto    |
+| 5.5.10   | 2025-06-29 | Inizializzazione della cronologia         |

package/docs/ja/intlayer_CMS.md

@@ -16,6 +16,7 @@ slugs:
   - doc
   - concept
   - cms
+youtubeVideo: https://www.youtube.com/watch?v=UDDTnirwi_4
 ---
 
 # Intlayer コンテンツ管理システム (CMS) ドキュメント