Pular para o conteúdo

Início rápido

O caminho mais rápido do zero até uma resposta verificada: pegue uma chave, indexe um repositório que você já conhece, conecte seu cliente e faça uma pergunta que você já sabe avaliar.

1. Pegue uma chave de API#

Comece grátis — sem cartão de crédito. Sua chave de API (que começa com mgv_) fica em app.maguyva.ai.

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

Conecte um repositório do GitHub pelo portal e deixe indexar. Escolha um repositório pequeno que você consiga conferir rápido — assim fica óbvio se o Maguyva está fundamentando o modelo, em vez de tentar indexar a empresa inteira logo de cara.

3. Conecte seu cliente#

Para o Claude Code, instale o plugin do Maguyva pelo marketplace — rode cada comando dentro do Claude Code:

/plugin marketplace add maguyva/claude-code-plugin
/plugin install maguyva@maguyva

O plugin se autentica com a sua chave a partir da variável de ambiente MAGUYVA_API_KEY. Defina-a no seu shell (o direnv por projeto é recomendado, já que as chaves são vinculadas ao repositório):

export MAGUYVA_API_KEY=mgv_xxxx

Trabalhando em equipe? Adicione --scope project aos dois comandos /plugin para versionar o plugin no .claude/settings.json do repositório, para que os colegas de time já recebam ele automaticamente.

A maioria dos outros clientes (Cursor, VS Code, Windsurf, Zed e companhia) se conecta direto ao servidor remoto — aponte-os para o endpoint com um cabeçalho Bearer, sem bridge necessário. Por exemplo, o .cursor/mcp.json do Cursor:

.cursor/mcp.json
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

O formato varia um pouco por cliente (o VS Code aninha sob servers com type: "http", o Windsurf usa serverUrl, o Zed usa context_servers). Substitua mgv_xxxx pela sua chave de API e reinicie o cliente. A configuração exata para todos os 24 clientes documentados está no Guia de Instalação.

4. Faça uma pergunta que você já sabe avaliar#

Comece com "Quais repositórios eu tenho conectados?" para confirmar a conexão, depois faça uma pergunta real sobre o seu repositório cuja resposta você já saiba — algo como "Como a autenticação é tratada nesse codebase?"

Você deve receber respostas com caminhos de arquivo e números de linha. Abra os arquivos citados e confira se a resposta sobrevive ao contato com o repositório de verdade. Essa única resposta verificada te diz mais do que qualquer lista de recursos — faça a ferramenta ganhar confiança antes de ela entrar no seu loop padrão.

Nenhum resultado, ou erros de conexão? Vá até Solução de Problemas — a maioria das falhas é uma chave de API não definida, um npx ausente, ou um repositório que ainda não terminou de indexar.

Próximos passos#