@intlayer/docs 5.5.11 → 5.6.0

package/docs/pt/intlayer_with_vite+solid.md

@@ -14,6 +14,7 @@ slugs:
   - doc
   - environment
   - vite-and-solid
+# applicationTemplate: https://github.com/aymericzip/intlayer-vite-solid-template
 ---
 
 # Começando a Internacionalizar (i18n) com Intlayer, Vite e Solid
@@ -43,17 +44,17 @@ Instale os pacotes necessários 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/pt/intlayer_with_vite+svelte.md

@@ -14,6 +14,7 @@ slugs:
   - doc
   - environment
   - vite-and-svelte
+# applicationTemplate: https://github.com/aymericzip/intlayer-vite-solid-template
 ---
 
 # Começando a Internacionalizar (i18n) com Intlayer, Vite e Svelte
@@ -43,17 +44,17 @@ Instale os pacotes necessários 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/pt/intlayer_with_vite+vue.md

@@ -41,17 +41,17 @@ Instale os pacotes necessários 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**
@@ -976,7 +976,7 @@ Por padrão, o Intlayer renderiza markdown como string. Mas o Intlayer também f
 
 > Para ver como declarar conteúdo markdown usando o pacote `intlayer`, consulte a [documentação de markdown](https://github.com/aymericzip/intlayer/tree/main/docs/pt/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/pt/mcp_server.md

@@ -1,11 +1,11 @@
 ---
 createdAt: 2025-06-07
-updatedAt: 2025-06-07
+updatedAt: 2025-07-11
 title: Documentação do Servidor MCP
-description: Explore os recursos e a configuração do Servidor MCP para otimizar a gestão e operações do seu servidor.
+description: Explore os recursos e a configuração do Servidor MCP para otimizar o gerenciamento e as operações do seu servidor.
 keywords:
   - Servidor MCP
-  - Gestão de Servidor
+  - Gerenciamento de Servidor
   - Otimização
   - Intlayer
   - Documentação
@@ -18,31 +18,58 @@ slugs:
 
 # Servidor MCP Intlayer
 
-O **Servidor Intlayer MCP (Model Context Protocol)** oferece assistência para IDE com inteligência artificial, adaptada ao ecossistema Intlayer. Projetado para ambientes modernos de desenvolvimento como **Cursor**, **GitHub Copilot workspace** e qualquer IDE que suporte o protocolo MCP, este servidor fornece suporte contextual e em tempo real baseado na configuração do seu projeto.
+O **Servidor MCP (Model Context Protocol) Intlayer** oferece assistência para IDEs com inteligência artificial, personalizada para o ecossistema Intlayer.
 
-## Por que usar o Servidor Intlayer MCP?
+## Onde posso usá-lo?
 
-Ao ativar o Servidor Intlayer MCP na sua IDE, você desbloqueia:
+- Em ambientes modernos de desenvolvimento como **Cursor**, **VS Code** e qualquer IDE que suporte o protocolo MCP.
+- No seu assistente de IA favorito como **Claude Desktop**, **Gemini**, **ChatGPT**, etc.
 
-- **Integração Inteligente com CLI**
-  Acesse e execute comandos da CLI do Intlayer diretamente da interface da sua IDE. Veja a lista completa de comandos e opções na [documentação da CLI do Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_cli.md).
+## Por que usar o Servidor MCP Intlayer?
+
+Ao ativar o Servidor MCP Intlayer na sua IDE, você desbloqueia:
 
 - **Documentação Contextualizada**
-  O servidor MCP carrega e expõe a documentação que corresponde à versão do Intlayer que você está usando no seu projeto. Isso garante que as sugestões de código, opções de comando e explicações estejam sempre atualizadas e relevantes.
+  O servidor MCP carrega e expõe a documentação do Intlayer. Para acelerar sua configuração, suas migrações, etc.
+  Isso garante que sugestões de código, opções de comando e explicações estejam sempre atualizadas e relevantes.
+
+- **Integração Inteligente com CLI**
+  Acesse e execute comandos do Intlayer CLI diretamente da interface da sua IDE. Usando o servidor MCP, você pode permitir que seu assistente de IA execute comandos como `intlayer dictionaries build` para atualizar seus dicionários, ou `intlayer dictionaries fill` para preencher suas traduções faltantes.
+
+  > Veja a lista completa de comandos e opções na [documentação do Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_cli.md).
+
+## Servidor local (stdio) vs Servidor remoto (SSE)
+
+O servidor MCP pode ser usado de duas maneiras:
+
+- Servidor local (stdio)
+- Servidor remoto (SSE)
+
+### Servidor local (stdio) (recomendado)
 
-- **Desenvolvimento Assistido por IA**
-  Com sugestões e autocompletar conscientes do projeto, o assistente de IA pode explicar seu código, recomendar o uso da CLI ou sugerir como usar recursos específicos do Intlayer com base nos seus arquivos atuais.
+O Intlayer fornece um pacote NPM que pode ser instalado localmente na sua máquina. Ele pode ser instalado na sua IDE favorita, como VS Code, Cursor, assim como no seu aplicativo assistente local, como ChatGPT, Claude Desktop, etc.
 
-- **Configuração Leve e Instantânea**
-  Nenhuma manutenção de servidor ou instalação pesada é necessária. Basta configurar seu arquivo `.cursor/mcp.json` ou configuração MCP equivalente e você estará pronto para começar.
+Este servidor é a forma recomendada de usar o servidor MCP, pois integra todos os recursos do servidor MCP, incluindo as ferramentas CLI.
+
+### Servidor remoto (SSE)
+
+O servidor MCP também pode ser usado remotamente, utilizando o método de transporte SSE. Este servidor é hospedado pelo Intlayer e está disponível em https://mcp.intlayer.org. Este servidor pode ser acessado publicamente, sem qualquer autenticação, e é gratuito para uso.
+
+Observe que o servidor remoto não integra ferramentas CLI, autocompletar de IA, etc. O servidor remoto é apenas para interação com a documentação para ajudar seu assistente de IA com o ecossistema Intlayer.
+
+> Devido aos custos de hospedagem do servidor, a disponibilidade do servidor remoto não pode ser garantida. Limitamos o número de conexões simultâneas. Recomendamos usar o método de transporte do servidor local (stdio) para uma experiência mais confiável.
 
 ---
 
-## Configurar Cursor
+## Configuração no Cursor
+
+Siga a [documentação oficial](https://docs.cursor.com/context/mcp) para configurar o servidor MCP no Cursor.
 
 Na raiz do seu projeto, adicione o seguinte arquivo de configuração `.cursor/mcp.json`:
 
-```json
+### Servidor local (stdio) (recomendado)
+
+```json fileName=".cursor/mcp.json"
 {
   "mcpServers": {
     "intlayer": {
@@ -53,19 +80,36 @@ Na raiz do seu projeto, adicione o seguinte arquivo de configuração `.cursor/m
 }
 ```
 
-Isso instrui seu IDE a iniciar o servidor MCP do Intlayer usando `npx`, garantindo que ele sempre use a versão mais recente disponível, a menos que você fixe uma versão específica.
+### Servidor remoto (SSE)
+
+Para conectar a um servidor Intlayer MCP remoto usando Server-Sent Events (SSE), você pode configurar seu cliente MCP para se conectar ao serviço hospedado.
+
+```json fileName=".cursor/mcp.json"
+{
+  "mcpServers": {
+    "intlayer": {
+      "url": "https://mcp.intlayer.org",
+      "transport": "sse"
+    }
+  }
+}
+```
+
+Isso instrui seu IDE a iniciar o servidor Intlayer MCP usando `npx`, garantindo que ele sempre use a versão mais recente disponível, a menos que você a fixe.
 
 ---
 
-## Configurar o VS Code
+## Configuração no VS Code
 
-Para usar o Servidor MCP do Intlayer com o VS Code, você precisa configurá-lo nas configurações do seu workspace ou usuário.
+Siga a [documentação oficial](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) para configurar o servidor MCP no VS Code.
 
-### Configuração do Workspace
+Para usar o Intlayer MCP Server com o VS Code, você precisa configurá-lo nas configurações do seu espaço de trabalho ou do usuário.
+
+### Servidor local (stdio) (recomendado)
 
 Crie um arquivo `.vscode/mcp.json` na raiz do seu projeto:
 
-```json
+```json fileName=".vscode/mcp.json"
 {
   "servers": {
     "intlayer": {
@@ -77,98 +121,88 @@ Crie um arquivo `.vscode/mcp.json` na raiz do seu projeto:
 }
 ```
 
-### Usando o Servidor MCP no VS Code
-
-1. **Ativar o Modo Agente**: Abra a visualização de Chat (⌃⌘I no Mac, Ctrl+Alt+I no Windows/Linux) e selecione o modo **Agente** no menu suspenso.
+### Servidor remoto (SSE)
 
-2. **Acessar Ferramentas**: Clique no botão **Ferramentas** para visualizar as ferramentas Intlayer disponíveis. Você pode selecionar/deselecionar ferramentas específicas conforme necessário.
+Para conectar a um servidor Intlayer MCP remoto usando Server-Sent Events (SSE), você pode configurar seu cliente MCP para se conectar ao serviço hospedado.
 
-3. **Referência Direta de Ferramentas**: Faça referência às ferramentas diretamente em seus prompts digitando `#` seguido do nome da ferramenta.
-
-4. **Confirmação de Ferramentas**: Por padrão, o VS Code solicitará confirmação antes de executar as ferramentas. Use as opções do botão **Continuar** para confirmar automaticamente as ferramentas para a sessão atual, workspace ou todas as invocações futuras.
-
-### Gerenciando o Servidor
-
-- Execute **MCP: Listar Servidores** no Command Palette para visualizar os servidores configurados
-- Inicie, pare ou reinicie o servidor MCP do Intlayer conforme necessário
-- Visualize os logs do servidor para solução de problemas selecionando o servidor e escolhendo **Mostrar Saída**
-
-Para obter informações mais detalhadas sobre a integração do VS Code MCP, consulte a [documentação oficial do VS Code MCP](https://code.visualstudio.com/docs/copilot/chat/mcp-servers).
+```json fileName=".vscode/mcp.json"
+{
+  "servers": {
+    "intlayer": {
+      "url": "https://mcp.intlayer.org",
+      "type": "sse"
+    }
+  }
+}
+```
 
 ---
 
-## Usando o Servidor MCP via CLI
-
-Você também pode executar o servidor Intlayer MCP diretamente a partir da linha de comando para testes, depuração ou integração com outras ferramentas.
-
-### Instalar o Servidor MCP
-
-Primeiro, instale o pacote do servidor MCP globalmente ou use-o via npx:
-
-```bash
-# Instalar globalmente
-npm install -g @intlayer/mcp
+## Configuração no ChatGPT
 
-# Ou usar diretamente com npx (recomendado)
-npx @intlayer/mcp
-```
+### Servidor remoto (SSE)
 
-### Iniciar o Servidor
+Siga a [documentação oficial](https://platform.openai.com/docs/mcp#test-and-connect-your-mcp-server) para configurar o servidor MCP no ChatGPT.
 
-Para iniciar o servidor MCP com o inspetor para depuração e testes:
+1. Vá para o [painel de prompts](https://platform.openai.com/prompts)
+2. Clique em `+ Create`
+3. Clique em `Tools (Create or +)`
+4. Selecione `MCP Server`
+5. Clique em `Add new`
+6. Preencha os seguintes campos:
 
-```bash
-# Usando o comando start embutido
-npm run start
+   - URL: `https://mcp.intlayer.org`
+   - Label: `Intlayer MCP Server`
+   - Name: `intlayer-mcp-server`
+   - Authentication: `None`
 
-# Ou diretamente com npx
-npx @modelcontextprotocol/inspector npx @intlayer/mcp
-```
+7. Clique em `Save`
 
-Isso iniciará o servidor MCP com uma interface de inspetor que permite:
+---
 
-- Testar comunicações do protocolo MCP
-- Depurar respostas do servidor
-- Validar implementações de ferramentas e recursos
-- Monitorar o desempenho do servidor
+## Configuração no Claude Desktop
 
-### Uso em Desenvolvimento
+Siga a [documentação oficial](https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server) para configurar o servidor MCP no Claude Desktop.
 
-Para fins de desenvolvimento e teste, você pode executar o servidor em vários modos:
+Caminho do arquivo de configuração:
 
-```bash
-# Construir e iniciar em modo de desenvolvimento
-npm run dev
+- macOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
 
-# Executar com configuração personalizada
-node dist/cjs/index.cjs
+### Servidor local (stdio) (recomendado)
 
-# Testar a funcionalidade do servidor
-npm test
+```json fileName="claude_desktop_config.json"
+{
+  "mcpServers": {
+    "intlayer": {
+      "command": "npx",
+      "args": ["-y", "@intlayer/mcp"]
+    }
+  }
+}
 ```
 
-O servidor exporá ferramentas e recursos específicos do Intlayer que podem ser consumidos por qualquer cliente compatível com MCP, não apenas pelo Cursor ou outros IDEs.
-
 ---
 
-## Visão Geral das Funcionalidades
-
-| Feature                 | Description                                                                                    |
-| ----------------------- | ---------------------------------------------------------------------------------------------- |
-| Suporte CLI             | Execute comandos `intlayer`, obtenha dicas de uso e argumentos inline                          |
-| Documentação Versionada | Detecta automaticamente e carrega a documentação correspondente à sua versão atual do Intlayer |
-| Autocompletar           | Sugestões inteligentes de comandos e configurações enquanto você digita                        |
-| Pronto para Plugin      | Compatível com IDEs e ferramentas que suportam o padrão MCP                                    |
+## Usando o Servidor MCP via CLI
 
----
+Você também pode executar o servidor MCP Intlayer diretamente pela linha de comando para testes, depuração ou integração com outras ferramentas.
 
-## Links Úteis
+```bash
+# Instalar globalmente
+npm install -g @intlayer/mcp
 
-- [Documentação CLI do Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_cli.md)
-- [Repositório GitHub do Intlayer](https://github.com/aymericzip/intlayer)
+# Ou usar diretamente com npx (recomendado)
+npx @intlayer/mcp
+```
 
 ---
 
-## Histórico da Documentação
+## Histórico do Documento
 
-- 5.5.10 - 2025-06-29: Histórico inicial
+| Versão | Data       | Alterações                                  |
+| ------ | ---------- | ------------------------------------------- |
+| 5.5.12 | 2025-07-11 | Adicionado configuração do ChatGPT          |
+| 5.5.12 | 2025-07-10 | Adicionado configuração do Claude Desktop   |
+| 5.5.12 | 2025-07-10 | Adicionado transporte SSE e servidor remoto |
+| 5.5.10 | 2025-06-29 | Histórico inicial                           |

package/docs/ru/intlayer_CMS.md

@@ -16,6 +16,7 @@ slugs:
   - doc
   - concept
   - cms
+youtubeVideo: https://www.youtube.com/watch?v=UDDTnirwi_4
 ---
 
 # Документация по системе управления контентом Intlayer (CMS)