---
createdAt: 2025-06-07
updatedAt: 2026-03-03
title: Documentação do Servidor MCP
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
  - Gerenciamento de Servidor
  - Otimização
  - Intlayer
  - Documentação
  - Configuração
  - Recursos
slugs:
  - doc
  - mcp-server
history:
  - version: 5.5.12
    date: 2025-07-11
    changes: "Adicionado configuração do ChatGPT"
  - version: 5.5.12
    date: 2025-07-10
    changes: "Adicionado configuração do Claude Desktop"
  - version: 5.5.12
    date: 2025-07-10
    changes: "Adicionado transporte Streamable HTTP e servidor remoto"
  - version: 5.5.10
    date: 2025-06-29
    changes: "Histórico inicial"
---

# Servidor MCP Intlayer

O **Servidor MCP (Model Context Protocol) Intlayer** oferece assistência para IDEs com inteligência artificial, personalizada para o ecossistema Intlayer.

## Onde posso usá-lo?

- 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.

## 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 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/cli/index.md).

## Servidor local (stdio) vs Servidor remoto (Streamable HTTP)

O servidor MCP pode ser usado de duas maneiras:

- Servidor local (stdio)
- Servidor remoto (Streamable HTTP)

### Servidor local (stdio) (recomendado)

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.

Este servidor é a forma recomendada de usar o servidor MCP, pois integra todos os recursos do servidor MCP, incluindo as ferramentas CLI.

### Servidor remoto (Streamable HTTP)

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.

---

## Configuração via CLI do Intlayer (recomendado)

O Intlayer fornece um comando CLI para configurar automaticamente o servidor MCP no seu projeto.

```bash packageManager="npm"
npx intlayer init mcp
```

```bash packageManager="yarn"
yarn intlayer init mcp
```

```bash packageManager="pnpm"
pnpm intlayer init mcp
```

```bash packageManager="bun"
bun x intlayer init mcp
```

Este comando irá:

1. Perguntar qual plataforma você está usando (Cursor, VS Code, Claude Desktop, etc.).
2. Perguntar qual método de transporte você deseja usar (Servidor local (stdio) ou Servidor remoto (Streamable HTTP)).
3. Atualizar automaticamente seu arquivo de configuração (ex: `.cursor/mcp.json`, `.vscode/mcp.json` ou a configuração global do Claude Desktop).

---

## Setup via Intlayer VS Code extension

1. Abra a paleta de comandos (Ctrl+Shift+P ou Cmd+Shift+P).
2. Digite `Intlayer: Setup AI Agent Skills`
3. Escolha a plataforma que você usa (ex: `VS Code`, `Cursor`, `Windsurf`, `OpenCode`, `Claude Code`, `GitHub Copilot Workspace`, etc.).
4. Escolha o MCP para instalar (stdio, Streamable HTTP)
5. Pressione Enter.

---

## 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`:

### Servidor local (stdio) (recomendado)

```json fileName=".cursor/mcp.json"
{
  "mcpServers": {
    "intlayer": {
      "command": "npx",
      "args": ["-y", "@intlayer/mcp"]
    }
  }
}
```

### Servidor remoto (Streamable HTTP)

Para conectar a um servidor Intlayer MCP remoto usando Server-Sent Events (Streamable HTTP), você pode configurar seu cliente MCP para se conectar ao serviço hospedado.

```json fileName=".cursor/mcp.json"
{
  "mcpServers": {
    "intlayer-sse": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.intlayer.org"]
    }
  }
}
```

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.

---

## Configuração no VS Code

Siga a [documentação oficial](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) para configurar o servidor MCP no VS Code.

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 fileName=".vscode/mcp.json"
{
  "servers": {
    "intlayer": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@intlayer/mcp"]
    }
  }
}
```

### Servidor remoto (Streamable HTTP)

Para conectar a um servidor Intlayer MCP remoto usando Server-Sent Events (Streamable HTTP), você pode configurar seu cliente MCP para se conectar ao serviço hospedado.

```json fileName=".vscode/mcp.json"
{
  "servers": {
    "intlayer-sse": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.intlayer.org"]
    }
  }
}
```

---

## Configuração no ChatGPT

### Servidor remoto (Streamable HTTP)

Siga a [documentação oficial](https://platform.openai.com/docs/mcp#test-and-connect-your-mcp-server) para configurar o servidor MCP no ChatGPT.

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:
   - URL: `https://mcp.intlayer.org`
   - Label: `Intlayer MCP Server`
   - Name: `intlayer-mcp-server`
   - Authentication: `None`

7. Clique em `Save`

---

## Configuração no Claude Desktop

Siga a [documentação oficial](https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server) para configurar o servidor MCP no Claude Desktop.

Caminho do arquivo de configuração:

- macOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`

### Servidor local (stdio) (recomendado)

```json fileName="claude_desktop_config.json"
{
  "mcpServers": {
    "intlayer": {
      "command": "npx",
      "args": ["-y", "@intlayer/mcp"]
    }
  }
}
```

### Servidor remoto (Streamable HTTP)

```json fileName="claude_desktop_config.json"
{
  "mcpServers": {
    "intlayer-sse": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.intlayer.org"]
    }
  }
}
```

---

## 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.

```bash
# Instalar globalmente
npm install -g @intlayer/mcp

# Ou usar diretamente com npx (recomendado)
npx @intlayer/mcp
```

---
