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

Canonical source: https://maguyva.ai/zh-hans/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).

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

> ~/.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 配置里的服务器。

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

```text
# 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 给智能体*一张代码地图*。

## 两种工作流

先问地图，再跑命令。

### 01. 把失败的脚本追到源头

```text
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 及其全部输出。

### 02. 改启动步骤前先查调用方

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

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

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

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

## 在 Warp 中配置

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

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

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

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

`~/.warp/.mcp.json`

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

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

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

Warp 的 [MCP 文档](https://docs.warp.dev/agents/capabilities/mcp/)介绍了基于文件的服务器、共享和认证。

## 索引一个你已经熟悉的代码仓库。

通过 MCP 连接 Warp，然后问一个你能核实的问题。