# 把 Maguyva 接入你的智能体

Canonical source: https://maguyva.ai/zh-hans/docs

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).

你的智能体每次会话开始时都是盲目的。Maguyva 通过 MCP 提供代码库搜索、符号查找和依赖关系上下文，来解决这个问题。

最短路径很简单：免费开始，索引一个有代表性的小型仓库集合，连接你的客户端，然后问一个你已经知道如何验证的真实问题。

## 让智能体不再盲目、回答有据可查，只需四步。

最短的路径依然是最好的路径：连接一个小型仓库集合，接入你的客户端，然后问一个你已经知道如何验证的问题。

- **免费开始**: 无需信用卡。用一个小型的、有代表性的仓库集合，而不是一上来就试图索引你们公司的所有代码。
- **索引一个你已经熟悉的仓库**: 选择你能快速核实的代码。这样一眼就能看出，Maguyva 是否真的比通用搜索更能让模型有据可依。
- **连接你的 MCP 客户端**
- **问一个关于真实仓库的问题**: 直接跳转到符号、调用方、定义和依赖关系——每条结果都标注了文件路径，搜索命中还带有行号——而不是指望模型瞎猜对了。

## 文档概览

- [快速入门](https://maguyva.ai/zh-hans/docs/quickstart): 几分钟内从零到得到第一个已验证的答案
- [安装](https://maguyva.ai/zh-hans/docs/installation): 几分钟内把 Maguyva 接入你的 MCP 客户端
- [工作原理](https://maguyva.ai/zh-hans/docs/how-it-works): 了解索引、搜索、符号和依赖关系图谱是如何协同运作的
- [MCP API 参考](https://maguyva.ai/zh-hans/docs/mcp-api): 针对 Maguyva MCP 接口的逐工具参考文档
- [兼容性](https://maguyva.ai/zh-hans/docs/compatibility): 支持的语言、仓库限制和文件覆盖范围
- [实用手册](https://maguyva.ai/zh-hans/docs/cookbook): 涵盖安装、编辑前搜索、空结果和多仓库工作的简明操作指南
- [故障排查](https://maguyva.ai/zh-hans/docs/troubleshooting): 解决 API 密钥、桥接程序和仓库连接方面的问题

## 更多资源

- [语言指南](https://maguyva.ai/zh-hans/languages): 了解 Maguyva 如何处理你的语言技术栈
- [博客](https://maguyva.ai/zh-hans/blog): 架构决策和技术深度解析
- [定价](https://maguyva.ai/zh-hans/pricing): 按工作区定价，可免费开始

## 用一个你自己就能判断对错的问题来验证。

当你把 Maguyva 用在自己已经理解的代码上时，它的表现最能说明问题。从一个仓库开始，问一个真实的问题，检查文件路径，让这个工具先赢得信任，再让它成为你默认工作流的一部分。

- 问题: 哪段代码处理登录和会话过期？
- 检查: 打开引用的文件，顺着符号追踪下去，验证这个答案在真实仓库面前是否站得住脚。
- 信号: 更小的上下文，更少的盲点，模型第一次就改对文件的概率也更高。

### 你能得到什么

- 有据可查的答案，附带文件路径和行号。
- 符号查找、调用方、定义和依赖路径，集于一个界面。
- 一个远程 MCP 服务器，适配多个客户端，而不必为每个编辑器单独维护一套工作流。