---
type: study
created: 2026-08-11
updated: 2026-08-11
sensitivity: private
status: active
tags:
  - study
  - langchain
  - documentation
  - mcp
topic: LangChain 文档的程序化索引与 MCP 接入
sources:
  - https://docs.langchain.com/use-these-docs
last_verified: 2026-08-11
---
# 文档索引与 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。