# O Cline planeja antes de agir. Dê um mapa ao plano.

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

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 Cline lê arquivos, roda comandos e pergunta antes de mudar qualquer coisa. O Maguyva indexa o repositório inteiro e devolve tudo via MCP, então o modo Plan começa por pontos de chamada reais em vez de uma listagem de diretórios.

> Use .clinerules para como trabalhar. Use o Maguyva para o que o código diz agora.

## O que você precisa saber sobre o Cline

Quatro fatos específicos do Cline.

### cline_mcp_settings.json

Abra pelo ícone MCP Servers no painel do Cline: aba Configure e depois Configure MCP Servers. Os servidores ficam em `mcpServers`.

### Remoto, por URL

O Cline se conecta ao endpoint do Maguyva por Streamable HTTP. Sem processo local, sem Node.js.

### Um cabeçalho literal

A chave vai direto no cabeçalho `Authorization`, como nos exemplos do próprio Cline. O arquivo de configurações fica no armazenamento de usuário do seu editor, não no seu repo.

### streamableHttp, não SSE

Mantenha `"type": "streamableHttp"` na entrada: sem tipo, o Cline assume o SSE legado. Liste em `autoApprove` as ferramentas em que você confia para pular o pedido de aprovação delas.

## As regras do Cline são um acordo de trabalho. Use-as.

```text
# .clinerules/testing.md
- Rode a suíte de testes antes de marcar uma tarefa como concluída.
- Pergunte antes de adicionar uma dependência.
```

As regras do workspace são arquivos Markdown em `.clinerules/` ou `.cline/rules/`; o Cline também lê `AGENTS.md`, `.cursorrules` e `.windsurfrules`. As regras são o lugar certo para:

- Comandos que o Cline deve rodar.
- Proteções limitadas a um caminho com um glob no frontmatter.
- Convenções do time que você cansou de repetir.

As regras dizem ao Cline como se comportar. Elas não dizem quais serviços leem a tabela que ele está prestes a migrar.

## Onde regras e leitura de arquivos não dão conta

Três lacunas que o Cline preenche lendo mais arquivos, uma requisição por vez.

### // um plano feito a partir de uma listagem

O modo Plan raciocina com o que o Cline leu até agora. Num repositório grande, isso é uma árvore de diretórios e meia dúzia de arquivos, e o plano herda as lacunas.

### // cada leitura é uma ida e volta

Cada arquivo que o Cline abre para se orientar custa tokens e uma requisição ao modelo. Se orientar num pacote desconhecido pode consumir boa parte da janela de contexto antes da primeira edição.

### // busca de texto acha strings, não chamadores

“Quem mais chama isso?” é uma pergunta de grafo. Uma busca de texto acha a string, mas não separa os chamadores reais de um comentário, de um mock e de um método com o mesmo nome.

## O Maguyva como servidor MCP no Cline

Uma entrada em mcpServers dá ao Cline:

- **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 um plano cite arquivos reais.
- **Ferramentas que só leem**: As ferramentas do Maguyva consultam o índice. Nenhuma edita os seus arquivos.

> As regras do Cline dizem a ele *como trabalhar*.
> O Maguyva dá ao Cline *um mapa para planejar*.

## Dois fluxos de trabalho

Planeje com o mapa, depois aja.

### 01. Planejar uma mudança a partir de pontos de chamada reais

```text
cline plan> mova a renovação de sessão para o pacote auth

dependency_search("refreshSession", dependents)
  src/api/middleware.ts:58
  src/jobs/renew.ts:12
  src/web/hooks/useSession.ts:30

→ O plano lista três pontos de chamada antes de o modo Act começar.
[exit 0]
```

O plano nomeia cada arquivo que vai tocar, então você aprova uma lista, não um palpite.

### 02. Achar a implementação real, não a fixture de teste

```text
cline> como calculamos o pro rata?

semantic_search("proration calculation")
  src/billing/proration.ts:22   prorate()   ← implementação
  test/billing/proration.spec.ts:7   ← fixture

→ O Cline lê um arquivo em vez de seis.
[exit 0]
```

Resultados priorizados colocam a implementação acima da fixture que tem o mesmo nome.

## Configuração no Cline

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 às configurações de MCP do Cline

`cline_mcp_settings.json`

```json
{
  "mcpServers": {
    "maguyva": {
      "type": "streamableHttp",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

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

Troque `mgv_xxxx` pela sua chave de API e salve o arquivo. Faça uma pergunta cuja resposta você já saiba e depois abra o arquivo citado.

A [documentação de MCP](https://docs.cline.bot/mcp/mcp-overview) do Cline cobre servidores remotos, timeouts e aprovação automática.

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

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