> For the complete documentation index, see [llms.txt](https://ereemby.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ereemby.gitbook.io/docs/desenvolvedores/mcp.md).

# MCP

Conecte a documentação da Ereemby ao seu assistente de IA usando MCP.

Conecte a documentação da **Ereemby** direto ao seu assistente de IA usando **MCP**.

Com o MCP ativo, ferramentas como **Claude**, **Codex**, **Cursor**, **Zed** e **Antigravity** passam a consultar a documentação oficial da Ereemby na fonte, em tempo real.

Você pergunta como configurar o checkout no seu editor de IA. O assistente responde com base nesta documentação.

{% hint style="info" %}
O servidor é **somente leitura** e expõe apenas o conteúdo público da documentação.

Nenhum dado de loja, cliente ou painel é acessado.
{% endhint %}

### Endpoint do servidor

```
https://ereemby.gitbook.io/docs/~gitbook/mcp
```

* **Transporte:** HTTP (streamable).
* **Suporte:** não aceita `stdio` nem `SSE`.
* **Autenticação:** nenhuma.
* **Função:** permite ao assistente buscar e ler as páginas da documentação.

{% hint style="warning" %}
Use um cliente que suporte **MCP remoto por HTTP**.

Se o cliente aceitar apenas servidores locais com `stdio`, use uma ponte como `mcp-remote`.
{% endhint %}

***

### Como conectar

Escolha a aba do seu programa.

{% tabs %}
{% tab title="Claude Code" icon="claude" %}
No terminal, adicione o servidor via HTTP:

```bash
claude mcp add --transport http ereemby-docs https://ereemby.gitbook.io/docs/~gitbook/mcp
```

Para deixar disponível em todos os projetos, use o escopo de usuário:

```bash
claude mcp add --transport http --scope user ereemby-docs https://ereemby.gitbook.io/docs/~gitbook/mcp
```

Dentro do Claude Code, rode `/mcp` para confirmar que `ereemby-docs` aparece como **connected**.

Você também pode configurar por arquivo com `.mcp.json` na raiz do projeto:

```json
{
  "mcpServers": {
    "ereemby-docs": {
      "type": "http",
      "url": "https://ereemby.gitbook.io/docs/~gitbook/mcp"
    }
  }
}
```

{% endtab %}

{% tab title="Claude" icon="claude" %}
No app de desktop do Claude, a conexão é feita pela interface.

O arquivo `claude_desktop_config.json` aceita apenas servidores locais.

1. Abra **Configurações**.
2. Vá em **Connectors**.
3. Clique em **Add custom connector**.
4. Em **Name**, informe `Ereemby Docs`.
5. Em **Remote MCP server URL**, cole: `https://ereemby.gitbook.io/docs/~gitbook/mcp`
6. Clique em **Add**.
7. Depois, clique em **Connect**.

Não preencha OAuth. A documentação é pública.
{% endtab %}

{% tab title="Codex CLI" icon="openai" %}
Edite `~/.codex/config.toml` e adicione:

```toml
[features]
experimental_use_rmcp_client = true

[mcp_servers.ereemby_docs]
url = "https://ereemby.gitbook.io/docs/~gitbook/mcp"
```

A linha `experimental_use_rmcp_client = true` habilita servidores MCP remotos por URL.

Se ela já existir, não duplique.

Reinicie o Codex CLI para carregar o servidor.
{% endtab %}

{% tab title="Codex" icon="openai" %}
A extensão do **Codex no IDE** usa o mesmo arquivo de configuração da CLI: `~/.codex/config.toml`.

1. Habilite MCP remoto e adicione o servidor:

```toml
[features]
experimental_use_rmcp_client = true

[mcp_servers.ereemby_docs]
url = "https://ereemby.gitbook.io/docs/~gitbook/mcp"
```

2. Recarregue a janela do editor ou reinicie a extensão do Codex.

Se a sua versão da extensão tiver um painel próprio de MCP, você também pode adicionar o servidor por lá usando a mesma URL.
{% endtab %}

{% tab title="Antigravity" icon="google" %}
No **Google Antigravity**, a configuração de MCP fica em `~/.gemini/config/mcp_config.json`.

A forma mais simples de abrir é pelo painel do agente:

**...** → **Manage MCP Servers** → **View raw config**

Adicione o servidor.

**Atenção:** o Antigravity usa `serverUrl` para servidores HTTP.

```json
{
  "mcpServers": {
    "ereemby-docs": {
      "serverUrl": "https://ereemby.gitbook.io/docs/~gitbook/mcp"
    }
  }
}
```

Salve o arquivo.

As ferramentas do servidor ficam disponíveis automaticamente no editor.
{% endtab %}

{% tab title="Cursor" icon="cursor" %}
Crie ou edite o arquivo de configuração de MCP:

* Global, para todos os projetos: `~/.cursor/mcp.json`
* Por projeto: `.cursor/mcp.json` na raiz

```json
{
  "mcpServers": {
    "ereemby-docs": {
      "url": "https://ereemby.gitbook.io/docs/~gitbook/mcp"
    }
  }
}
```

Você também pode adicionar pela interface:

**Settings** → **Tools & MCP** → **New MCP Server**

Depois, escolha o transporte **HTTP** e cole a URL.
{% endtab %}

{% tab title="Zed" icon="square-z" %}
Abra as configurações do Zed com `Cmd/Ctrl + ,` e adicione o servidor em `context_servers`.

**Método compatível com `mcp-remote`:** funciona em qualquer versão e requer Node.js.

```json
{
  "context_servers": {
    "ereemby-docs": {
      "source": "custom",
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://ereemby.gitbook.io/docs/~gitbook/mcp"]
    }
  }
}
```

Se a sua versão do Zed já suportar MCP remoto por URL nativamente, use:

```json
{
  "context_servers": {
    "ereemby-docs": {
      "url": "https://ereemby.gitbook.io/docs/~gitbook/mcp"
    }
  }
}
```

{% endtab %}
{% endtabs %}

***

### Como testar se funcionou

1. Abra o seu assistente de IA com o servidor conectado.
2. Confira se `ereemby-docs` aparece como conectado na lista de MCP.
3. Faça uma pergunta que dependa da documentação, por exemplo: *"Pela documentação da Ereemby, quais são as opções de fundo do checkout?"*
4. O assistente deve buscar na documentação e responder com base no conteúdo.

***

### Problemas comuns

{% hint style="info" %}
**O servidor não conecta ou retorna erro de transporte**

Confirme que o cliente está usando **HTTP**.

O MCP não aceita `stdio` nem `SSE` diretamente.

Em clientes que só aceitam servidores locais, use `mcp-remote`.
{% endhint %}

{% hint style="info" %}
**A URL retorna 404**

Confira se você copiou o endpoint completo, terminando em `~gitbook/mcp`.
{% endhint %}

{% hint style="info" %}
**O assistente não usa o servidor**

Reinicie o programa depois de salvar a configuração.

Confirme também que o servidor aparece como conectado na lista de MCP do cliente.

No Antigravity, use `serverUrl`.

Nos demais clientes, use `url`.
{% endhint %}