# Início rápido

Canonical source: https://maguyva.ai/pt-br/docs/quickstart

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

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](https://app.maguyva.ai) — sem cartão de crédito. Sua chave de API (que começa com `mgv_`) fica em [app.maguyva.ai](https://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:

```text
/plugin marketplace add maguyva/agent-plugins
/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):

```bash
export MAGUYVA_API_KEY="mgv_xxxx"
```

Trabalha em equipe? Escolha o escopo project no painel que o `/plugin install maguyva@maguyva` abre. Isso registra o plugin no `.claude/settings.json` do repositório, que você commita; cada colega ainda roda a instalação uma vez. Os comandos `/plugin` dentro da sessão não aceitam a flag `--scope`, então, para automatizar, rode a forma de shell na raiz do repositório:

```bash
claude plugin marketplace add maguyva/agent-plugins --scope project
claude plugin install maguyva@maguyva --scope project
```

A maioria dos outros clientes (Cursor, VS Code, Devin Desktop, 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:

```json
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
      }
    }
  }
}
```

O formato varia um pouco por cliente (o VS Code aninha sob `servers` com `type: "http"`, o Antigravity usa `serverUrl`, o Zed usa `context_servers`). Este exemplo do Cursor lê sua chave da variável de ambiente `MAGUYVA_API_KEY` mostrada acima; se a configuração de um cliente mostrar o placeholder `mgv_xxxx` no lugar, substitua-o pela sua chave de API. Depois reinicie o cliente. A configuração exata para todos os 23 clientes documentados está no [Guia de Instalação](https://maguyva.ai/pt-br/docs/installation).

## 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 nesta base de código?"**

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.

Sem resultados ou com erros de conexão? Verifique a chave de API, a configuração do cliente e o estado de indexação do repositório em [Solução de Problemas](https://maguyva.ai/pt-br/docs/troubleshooting). Se sua configuração usa a bridge, confira também se `npx` está disponível.

## Próximos passos

- Guia de Instalação: configuração por cliente para todos os 23 clientes documentados
- Como Funciona: o que acontece entre a sua pergunta e a resposta
- Referência da API MCP: cada ferramenta, parâmetro por parâmetro