# O agente do Warp vive no terminal. Dê a ele um mapa do repo. Canonical source: https://maguyva.ai/pt-br/for-warp 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 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. > 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. ### ~/.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. ### Remoto, por URL Uma entrada `url` se conecta por Streamable HTTP ou SSE. Nada roda localmente e o Node.js não é necessário. ### 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. ### 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. ```text # 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. ### 01. Rastrear um script que falha até a origem ```text 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. ### 02. Conferir os chamadores antes de mudar uma etapa de inicialização ```text 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. ### 01. Indexe um repositório em maguyva.ai Escolha um que você já conheça, para poder avaliar as respostas. ### 02. Adicione o Maguyva ao ~/.warp/.mcp.json `~/.warp/.mcp.json` ```json { "mcpServers": { "maguyva": { "url": "https://maguyva.tools/mcp", "headers": { "Authorization": "Bearer mgv_xxxx" } } } } ``` ### 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. A [documentação de MCP](https://docs.warp.dev/agents/capabilities/mcp/) do Warp cobre servidores definidos em arquivos, compartilhamento e autenticação. ## Indexe um repositório que você já conhece. Conecte o Warp via MCP e faça uma pergunta que você consiga conferir.