Para usuários do Cline

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

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.

Comece grátis Leia a configuração do Cline

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

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.

// arquivo de configuração

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.

// transporte

Remoto, por URL

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

// chave

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.

// tipo

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.

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

// workflow 01

Planejar uma mudança a partir de pontos de chamada reais

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.

// workflow 02

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

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.

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

cline_mcp_settings.json

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

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