# O Continue roda à base de configuração. Adicione um bloco que conhece seu repo.

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

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 agente do Continue trabalha com o contexto que você dá e com as ferramentas que a configuração permite. O Maguyva indexa o repo inteiro e o entrega via MCP, então o modo agente pergunta onde o código fica antes de ler arquivo atrás de arquivo.

> Um bloco YAML: uma URL, um cabeçalho e um segredo do seu .env.

## O que o Continue precisa saber

Quatro fatos específicos do Continue.

### Um bloco YAML

Salve o bloco como `.continue/mcpServers/maguyva.yaml` no seu workspace ou adicione a entrada `mcpServers` dele ao `~/.continue/config.yaml`. O `config.json` está obsoleto.

### streamable-http

O Continue se conecta ao endpoint do Maguyva por Streamable HTTP; o cabeçalho fica em `requestOptions`. Sem processo local, sem Node.js.

### Uma referência a segredo

`${{ secrets.MAGUYVA_API_KEY }}` é resolvido a partir de `~/.continue/.env`, depois de `.continue/.env` e `.env` do workspace e, por fim, do ambiente do processo. O bloco em si não guarda nenhuma chave.

### Só no modo agente

O Continue oferece ferramentas MCP no modo agente, não no chat. Configurações JSON de outros clientes também funcionam: basta colocá-las em `.continue/mcpServers/`.

## Regras são um acordo de trabalho. Use-as.

```text
# .continue/rules/testing.md
---
globs: "src/**/*.ts"
---
Rode os testes do pacote antes de dar uma mudança por concluída.
```

O Continue carrega regras em Markdown de `.continue/rules/`. Uma regra pode valer sempre, só quando arquivos correspondentes estão no contexto (`globs`) ou quando o agente decide que a `description` dela se aplica. Use regras para:

- Comandos de build, teste e lint.
- Convenções por linguagem ou pasta.
- Diretórios que o agente não deve tocar.

Uma regra diz ao agente como trabalhar. Não diz o que o código diz depois do merge de hoje de manhã.

## Onde o contexto escolhido a dedo acaba

Três lacunas que o modo agente preenche lendo arquivos.

### // contexto é o que você escolhe

Você adiciona os arquivos que acha importantes. A implementação de que o agente precisa costuma estar justamente naquele em que você não pensou.

### // os chamadores não estão no arquivo

“O que quebra se eu mudar isto?” é uma pergunta de grafo. Sem índice, o agente lê os arquivos um por um para responder.

### // modelos locais têm janelas pequenas

O Continue pode rodar modelos locais com limites de contexto apertados. Uma resposta ranqueada com file:line cabe onde dez leituras exploratórias não cabem.

## Maguyva como bloco MCP no Continue

Um bloco mcpServers dá ao modo agente:

- **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 que até um modelo pequeno receba o arquivo certo em vez de uma listagem longa.
- **Ferramentas que só leem**: As ferramentas do Maguyva consultam o índice. Nenhuma edita os seus arquivos.

> Regras dizem ao Continue *como trabalhar*.
> O Maguyva dá ao Continue *um mapa do código*.

## Dois fluxos de trabalho

Pergunte ao mapa primeiro, depois edite.

### 01. Achar o arquivo certo sem jogar dez no contexto

```text
continue agent> onde verificamos as assinaturas dos webhooks?

semantic_search("verify webhook signature")
  src/webhooks/verify.ts:17   verifySignature()
  docs/webhooks.md:40   ← texto

→ O agente lê verify.ts e nada mais.
[exit 0]
```

Uma busca por significado acha a implementação mesmo quando o nome dela não bate com as suas palavras.

### 02. Listar quem importa antes de aposentar um cliente

```text
continue agent> quem ainda importa o cliente de cobrança legado?

dependency_search("LegacyBillingClient", dependents)
  4 importadores em 3 pacotes

→ O agente migra os quatro e depois remove o cliente.
[exit 0]
```

A lista de importadores fica completa antes da exclusão, e não é descoberta pelo build depois.

## Configuração no Continue

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. Salve o bloco como .continue/mcpServers/maguyva.yaml

`.continue/mcpServers/maguyva.yaml`

```yaml
name: Maguyva
version: 0.0.1
schema: v1
mcpServers:
  - name: maguyva
    type: streamable-http
    url: https://maguyva.tools/mcp
    requestOptions:
      headers:
        Authorization: Bearer ${{ secrets.MAGUYVA_API_KEY }}

```

### 03. Adicione sua chave e mude para o modo agente

Escreva `MAGUYVA_API_KEY=` seguido da sua chave em `~/.continue/.env`. Mude para o modo agente e faça uma pergunta cuja resposta você já saiba.

A [documentação de MCP](https://docs.continue.dev/customize/deep-dives/mcp) do Continue cobre transportes, segredos e configurações JSON de outros clientes.

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

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