文档索引与 MCP 接入

两个互补数据源

LangChain 提供两套远程 MCP：

服务	URL	职责
docs	`https://docs.langchain.com/mcp`	概念、教程、how-to、LangSmith 产品文档
reference	`https://reference.langchain.com/mcp`	类、方法、参数、签名和包级 API Reference

只接 docs 容易知道“为什么”却写错签名；只接 reference 容易知道符号却忽略架构、安全和迁移边界。官方建议同时连接，编码时仍要以项目锁定版本和测试结果为准。

https://docs.langchain.com/mcp 是协议端点，不是可阅读文档页面，因此未计入全站 2,102 个学习路由；介绍该端点的 /use-these-docs 才是站点指南页面。

其他程序化入口

每页右上角上下文菜单可复制页面、查看 Markdown、打开 llms.txt，或交给 ChatGPT/Claude 等工具。
llms.txt 是官方精选索引，但不是完整页面闭包；本学习库同时使用 sitemap 与页面内链发现隐藏教程、错误页和集成细页。
MCP 适合获取当前文档，Obsidian 笔记负责稳定心智模型、决策、风险和经验证的版本边界，二者不能互相替代。

配置作用域

Claude Code 支持 project/local 与 user/global scope；Deep Agents Code 支持项目 .mcp.json 和用户级 ~/.deepagents/.mcp.json；Codex CLI、Cursor、VS Code、Claude Desktop、Antigravity 也可配置相同 HTTP 服务。

作用域选择原则：

项目只在确实使用 LangChain 时，优先 project scope，减少无关工具暴露与上下文噪声。
user/global scope 适合多个受信项目长期共用，但升级或服务异常会影响所有项目。
配置变化后，Deep Agents Code 等客户端需要重启或重新加载，并用状态命令确认连接成功。

安全与可靠性

远程 MCP 是外部信任边界。即使服务主要提供只读文档，也应审查服务 URL、客户端权限、网络代理、日志与企业数据策略；不要向查询自动附带源码、密钥或用户数据。线上不可用时用锁定的官方 Markdown/Reference 和依赖版本继续工作，避免构建流程强依赖实时 MCP。