Para usuários do Warp

O agente do Warp vive no terminal. Dê a ele um mapa do repo.

O agente do Warp roda comandos e lê o que eles imprimem. O Maguyva indexa o repo inteiro e o entrega via MCP, então o agente pergunta onde o código fica em vez de rodar grep e cat até algo bater.

Comece grátis Ver a configuração do Warp

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

Uma entrada mcpServers no ~/.warp/.mcp.json: uma URL e um cabeçalho Authorization.

O que o Warp precisa saber

Quatro fatos específicos do Warp.

// arquivo de configuração

~/.warp/.mcp.json

O Warp inicia sozinho os servidores deste arquivo global. Você também pode colar o mesmo JSON em Settings → Agents → MCP servers → + Add.

// transporte

Remoto, por URL

Uma entrada url se conecta por Streamable HTTP ou SSE. Nada roda localmente e o Node.js não é necessário.

// chave

Um cabeçalho literal

A chave vai direto no cabeçalho Authorization. Mantenha-a no arquivo global, não no .warp/.mcp.json de um projeto que você commita.

// arquivos de projeto

Nunca iniciam sozinhos

O Warp detecta o .warp/.mcp.json em um repo clonado, mas espera você iniciar cada servidor. Ele também pode ler servidores das configurações do Claude Code e do Codex depois que você ativa essa opção.

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

# AGENTS.md
- Rode make test antes de dar uma mudança por concluída.
- Use os scripts de bin/, não comandos improvisados.

O Warp lê regras de projeto do AGENTS.md (ou do WARP.md, que prevalece se os dois existirem) e aplica as Global Rules em todo lugar. Use-as para:

Comandos de build, teste e deploy.
Convenções que o agente insiste em errar.
Comandos que o agente nunca deve rodar.

Regras dizem ao agente como trabalhar. Não dizem qual serviço ainda lê a variável de ambiente que você está prestes a remover.

Onde o grep no terminal acaba

Três coisas que uma sessão de shell não aprende de graça.

// a saída passa voando

Cada grep e cada cat que o agente roda vão parar na conversa. Uma busca que imprime duzentas linhas gasta contexto antes de o trabalho de verdade começar.

// um match não é um chamador

O grep não distingue uma chamada real de um comentário, uma fixture ou um método de mesmo nome em outra classe.

// o shell começa do zero

Uma sessão nova não sabe nada do repo. O índice do Maguyva já está pronto, então a primeira pergunta recebe uma resposta ranqueada.

Maguyva como servidor MCP no Warp

Uma entrada mcpServers dá ao agente do Warp:

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, curtas o bastante para ler num painel do terminal.
Ferramentas que só leem As ferramentas do Maguyva consultam o índice. Nenhuma edita arquivos ou roda comandos.

O Warp dá ao agente um terminal.
O Maguyva dá ao agente um mapa do código.

Dois fluxos de trabalho

Pergunte ao mapa primeiro, rode comandos depois.

// workflow 01

Rastrear um script que falha até a origem

warp agent> o deploy.sh falha: BUILD_ID não está definido. onde ele é definido?

text_pattern_search("BUILD_ID=")
  ci/env.sh:9   export BUILD_ID=...
  docs/deploy.md:31   ← texto

→ O agente carrega ci/env.sh e roda o deploy de novo.
[exit 0]

Uma busca indexada substitui um grep recursivo pelo repo inteiro e toda a saída dele.

// workflow 02

Conferir os chamadores antes de mudar uma etapa de inicialização

warp agent> dá para parar de rodar as migrações na inicialização?

dependency_search("runMigrations", dependents)
  3 chamadores: server.ts, worker.ts, scripts/seed.ts

→ O agente move os três para a etapa de release.
[exit 0]

Os chamadores chegam antes da mudança, então o worker não sobe contra um esquema antigo.

Configuração no Warp

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 ao ~/.warp/.mcp.json

~/.warp/.mcp.json

{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

// step 03

Troque o placeholder e faça uma pergunta

Troque mgv_xxxx pela sua chave de API e salve. Confira em Settings → Agents → MCP servers que o servidor está rodando e faça uma pergunta cuja resposta você já saiba.