Pular para o conteúdo

Para usuários do Continue

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

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.

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

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.

// arquivo de configuração

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.

// transporte

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.

// chave

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.

// modo

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.

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

// workflow 01

Achar o arquivo certo sem jogar dez no contexto

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.

// workflow 02

Listar quem importa antes de aposentar um cliente

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.

  1. // step 01

    Indexe um repositório em maguyva.ai

    Escolha um que você já conheça, para poder avaliar as respostas.

  2. // step 02

    Salve o bloco como .continue/mcpServers/maguyva.yaml

    .continue/mcpServers/maguyva.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 }}
    
  3. // step 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.