# O Claude Desktop não enxerga o seu repositório. Mostre um a ele.

Canonical source: https://maguyva.ai/pt-br/for-claude-desktop

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

É no Claude Desktop que muita gente pergunta sobre código que não está editando agora: revisões, onboarding, chamadas de incidente. O Maguyva indexa o repositório e o serve via MCP, então as respostas citam arquivos e linhas em vez de memória.

> Sem checkout. Pergunte ao índice.

## O que você precisa saber sobre o Claude Desktop

Quatro fatos específicos do Claude Desktop.

### claude_desktop_config.json

Settings → Developer → Edit Config abre o arquivo. No macOS ele fica em `~/Library/Application Support/Claude/`; no Windows, em `%APPDATA%\Claude\`.

### A bridge local

Este arquivo inicia processos locais, então este guia roda o `@maguyva/mcp` via `npx`. O Node.js precisa estar instalado.

### Uma entrada env

A bridge lê `MAGUYVA_API_KEY` do bloco `env` do servidor, no mesmo arquivo.

### Feche e abra de novo

O Claude Desktop lê o arquivo ao iniciar. Feche o app por completo depois de editar; o servidor sobe na próxima inicialização.

## As instruções do projeto definem o briefing. Use-as.

Os Projects do Claude guardam instruções e arquivos com que toda conversa do projeto começa. São o lugar certo para:

- Para quem são as respostas: um revisor, alguém recém-chegado, um engenheiro de plantão.
- O estilo da casa para explicações e resumos.
- Alguns documentos que você quer ver citados, como uma visão geral da arquitetura.

Arquivos enviados são um retrato instantâneo. O repositório já andou no dia seguinte ao envio.

## Onde código colado não dá conta

Três jeitos de uma conversa sobre código dar errado sem o código.

### // trechos colados envelhecem

Um arquivo colado na conversa semana passada descreve o código da semana passada. O Claude responde com confiança a partir da versão que recebeu.

### // o trecho não é o sistema

Um único arquivo raramente responde “o que acontece quando isso falha?” O handler, a retentativa e o alerta costumam morar em três pacotes diferentes.

### // sem checkout, sem grep

O Claude Desktop não tem uma cópia de trabalho do seu repositório. Sem uma ferramenta, toda resposta sobre a estrutura depende do que você lembrou de colar.

## O Maguyva como servidor MCP no Claude Desktop

Uma entrada em mcpServers dá ao Claude:

- **11 ferramentas sobre o seu repositório indexado**: busca semântica, estrutural (AST), de grafo e de texto, além de busca de símbolos, dependentes e recuperação de arquivos.
- **Respostas com caminhos de arquivo e números de linha**: em mais de 285 linguagens, para você conferir cada afirmação.
- **Resultados que levam a branch em conta**: para que o Claude responda sobre a branch que você indicar, não sobre um arquivo que alguém enviou mês passado.

> As instruções do projeto dizem ao Claude *como responder*.
> O Maguyva dá ao Claude *o código de onde tirar a resposta*.

## Dois fluxos de trabalho

Perguntas que você normalmente responderia abrindo uma IDE.

### 01. Explicar um caminho de código durante uma revisão

```text
claude> o que acontece depois que um webhook de pagamento falha na checagem de assinatura?

semantic_search("webhook signature verification failure")
  src/payments/webhooks.ts:64   verifySignature()
  src/payments/webhooks.ts:91   rejectAndAlert()

→ O Claude responde citando as duas linhas.
[exit 0]
```

Cada passo da resposta aponta para um arquivo e uma linha que você pode abrir.

### 02. Dimensionar uma mudança antes de planejá-la

```text
claude> quantos lugares leem o campo legado plan_code?

text_pattern_search("plan_code")
  14 ocorrências em 9 arquivos
dependency_search("getPlanCode", dependents)
  6 chamadores

→ A estimativa parte de um número, não de um chute.
[exit 0]
```

Útil numa reunião de planejamento, quando ninguém está com o repositório aberto.

## Configuração no Claude Desktop

Três passos. Plano Free: 3 repositórios, Até 50 mil linhas de repositório indexadas, sem cartão.

### 01. Indexe um repositório em maguyva.ai

Escolha um que você já conheça, para poder avaliar as respostas.

### 02. Adicione o Maguyva ao claude_desktop_config.json

`claude_desktop_config.json`

```json
{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "@maguyva/mcp"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}
```

### 03. Troque o placeholder, reinicie e faça uma pergunta

Troque `mgv_xxxx` pela sua chave de API, feche o Claude Desktop por completo e abra de novo. Se o servidor não aparecer, leia `mcp-server-maguyva.log` na pasta de logs do Claude (`~/Library/Logs/Claude` no macOS).

O [guia do MCP sobre servidores locais](https://modelcontextprotocol.io/docs/develop/connect-local-servers) detalha o arquivo de configuração e os logs.

## Indexe um repositório que você já conhece.

Conecte o Claude Desktop via MCP e faça uma pergunta que você consiga conferir.