面向 Warp 用户

Warp 的智能体住在终端里。给它一张仓库地图。

Warp 的智能体运行命令并读取输出。Maguyva 为整个仓库建立索引并通过 MCP 提供，所以智能体会直接问代码在哪里，而不是反复跑 grep 和 cat 直到碰上匹配。

Free 层级：3 个代码仓库, 最多 5 万行索引代码，无需信用卡。

~/.warp/.mcp.json 里一条 mcpServers 条目：一个 URL，一个 Authorization 头。

Warp 需要知道的事

Warp 特有的四件事。

// 配置文件

~/.warp/.mcp.json

Warp 会自动启动这个全局文件里的服务器。你也可以把同样的 JSON 粘贴到 Settings → Agents → MCP servers → + Add。

// 传输通道

远程，按 URL 连接

url 条目通过 Streamable HTTP 或 SSE 连接。本地什么都不运行，也不需要 Node.js。

// 密钥

直接写进请求头

密钥直接写进 Authorization 请求头。把它放在全局文件里，不要放进你会提交的项目 .warp/.mcp.json。

// 项目文件

从不自动启动

Warp 能发现克隆下来的仓库里的 .warp/.mcp.json，但每个服务器都要等你手动启动。打开相应选项后，它还能读取 Claude Code 和 Codex 配置里的服务器。

项目规则是一份工作约定。用起来。

# AGENTS.md
- 宣布改动完成前先运行 make test。
- 用 bin/ 里的脚本，不要临时拼命令。

Warp 从 AGENTS.md（两者都在时以 WARP.md 为准）读取项目规则，并在所有地方应用全局规则。用它们来写：

构建、测试和部署命令。
智能体反复弄错的约定。
智能体绝不能运行的命令。

规则告诉智能体怎么干活。它没法告诉智能体：你马上要删掉的那个环境变量，还有哪个服务在读。

终端里 grep 的尽头

shell 会话没法廉价学到的三件事。

// 输出一闪而过

智能体运行的每条 grep 和 cat 都会进入对话。一次打印两百行的搜索，在正事开始前就烧掉了上下文。

// 匹配不等于调用方

grep 分不清真正的调用和注释、fixture，或另一个类里的同名方法。

// shell 从零开始

新会话对仓库一无所知。Maguyva 的索引早已建好，所以第一个问题就能拿到排序后的答案。

Maguyva 作为 Warp 中的 MCP 服务器

一条 mcpServers 条目为 Warp 的智能体带来：

面向已索引仓库的 11 个工具 语义、结构（AST）、图和文本搜索，外加符号查找、依赖方和文件检索。
带文件路径和行号的答案 覆盖 285+ 种语言，短到能在终端窗格里读完。
只读的工具 Maguyva 的工具只查询索引，既不修改文件，也不运行命令。

Warp 给智能体一个终端。
Maguyva 给智能体一张代码地图。

两种工作流

先问地图，再跑命令。

// workflow 01

把失败的脚本追到源头

warp agent> deploy.sh 失败：BUILD_ID 未设置。它在哪里设置？

text_pattern_search("BUILD_ID=")
  ci/env.sh:9   export BUILD_ID=...
  docs/deploy.md:31   ← 文档说明

→ 智能体 source ci/env.sh，然后重新部署。
[exit 0]

一次索引搜索，取代对整个仓库的递归 grep 及其全部输出。

// workflow 02

改启动步骤前先查调用方

warp agent> 能不能不在启动时跑迁移了？

dependency_search("runMigrations", dependents)
  3 个调用方：server.ts、worker.ts、scripts/seed.ts

→ 智能体把这三处都移到发布步骤。
[exit 0]

调用方在改动之前就已到手，worker 不会对着旧 schema 启动。

在 Warp 中配置

三个步骤。Free 层级：3 个代码仓库, 最多 5 万行索引代码，无需信用卡。

// step 01

在 maguyva.ai 索引一个代码仓库

挑一个你已经熟悉的，这样你能给答案打分。

// step 02

把 Maguyva 加入 ~/.warp/.mcp.json

~/.warp/.mcp.json

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

// step 03

替换占位符，然后问一个问题

把 mgv_xxxx 换成你的 API 密钥并保存。在 Settings → Agents → MCP servers 里确认服务器正在运行，然后问一个你已经知道答案的问题。