跳转到内容

快速入门

从零到得到一个已验证答案的最快路径：获取一个密钥，对一个你已经熟悉的仓库建立索引，连接你的客户端，然后问一个你自己就能判断对错的问题。

1. 获取 API 密钥#

免费开始——无需信用卡。你的 API 密钥（以 mgv_ 开头）保存在 app.maguyva.ai。

2. 对一个你已经熟悉的仓库建立索引#

从门户网站连接一个 GitHub 仓库，让它完成索引。选一个你能快速核实结果的小仓库——这样一眼就能看出 Maguyva 是否真的在为模型提供依据，而不是一上来就试图把你们公司的所有代码都索引一遍。

3. 连接你的客户端#

对于 Claude Code，从插件市场安装 Maguyva 插件——在 Claude Code 内运行以下每条命令：

/plugin marketplace add maguyva/claude-code-plugin
/plugin install maguyva@maguyva

该插件会使用 MAGUYVA_API_KEY 环境变量中的密钥进行身份验证。请在你的 shell 中设置它（由于密钥是按仓库划分范围的，建议按项目使用 direnv）：

export MAGUYVA_API_KEY=mgv_xxxx

在团队中协作？在两条 /plugin 命令中都加上 --scope project，把插件提交到仓库的 .claude/settings.json 中，这样队友就能自动获得它。

大多数其他客户端（Cursor、VS Code、Windsurf、Zed 等）会直接连接到远程服务器——只需用一个 Bearer 请求头指向该端点，无需任何桥接程序。例如，Cursor 的 .cursor/mcp.json：

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

具体格式因客户端而略有不同（VS Code 嵌套在 servers 下并使用 type: "http"，Windsurf 使用 serverUrl，Zed 使用 context_servers）。把 mgv_xxxx 替换成你的 API 密钥，然后重启你的客户端。全部 24 个已记录客户端的精确配置，都在 安装指南 中。

4. 问一个你自己就能判断对错的问题#

先问 "我连接了哪些仓库？" 来确认连接是否成功，然后问一个你已经知道答案的、关于你仓库的真实问题——比如 "这个代码库中的身份验证是如何处理的？"

你应该会得到带有文件路径和行号的答案。打开引用的文件，检查这个答案在真实仓库面前是否站得住脚。这一个被你验证过的答案，比任何功能列表都更能说明问题——让这个工具先赢得信任，再让它加入你的默认工作流。

没有结果，或者出现连接错误？前往 故障排查——大多数故障都是因为没设置 API 密钥、缺少 npx，或者仓库还没索引完成。

后续步骤#