Para usuários do Claude Desktop

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

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

Comece grátis Leia a configuração do Claude Desktop

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

Sem checkout. Pergunte ao índice.

O que você precisa saber sobre o Claude Desktop

Quatro fatos específicos do Claude Desktop.

// arquivo de configuração

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

// transporte

A bridge local

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

// chave

Uma entrada env

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

// reinício

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.

// workflow 01

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

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.

// workflow 02

Dimensionar uma mudança antes de planejá-la

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.

// step 01

Indexe um repositório em maguyva.ai

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

// step 02

Adicione o Maguyva ao claude_desktop_config.json

claude_desktop_config.json

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

// step 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).