/mcp 处可用。 您可以设置自定义身份验证中间件,以使用 MCP 服务器对用户进行身份验证,从而访问 LangSmith 部署中的用户范围工具。 此流程的示例架构:
要求
要使用 MCP,请确保您已安装以下依赖项langgraph-api >= 0.2.3langgraph-sdk >= 0.1.61
使用概览
启用 MCP- 升级到 langgraph-api>=0.2.3。如果您正在部署 LangSmith,如果您创建新修订版,这将自动完成。
- MCP 工具(代理)将自动公开。
- 连接到任何支持可流式 HTTP 的 MCP 兼容客户端。
客户端
使用 MCP 兼容客户端连接到 LangGraph 服务器。以下示例展示了如何使用不同的编程语言进行连接。- JavaScript/TypeScript
- Python
注意 将 serverUrl 替换为您的 LangGraph 服务器 URL,并根据需要配置身份验证标头。
将代理公开为 MCP 工具
部署后,您的代理将以这种配置作为工具出现在 MCP 端点中- 工具名称:代理的名称。
- 工具描述:代理的描述。
- 工具输入模式:代理的输入模式。
设置名称和描述
您可以在langgraph.json 中设置代理的名称和描述
Schema
定义清晰、最小的输入和输出模式,以避免向 LLM 暴露不必要的内部复杂性。 默认的 MessagesState 使用AnyMessage,它支持许多消息类型,但对于直接 LLM 暴露来说过于通用。 相反,定义使用显式类型输入和输出结构的自定义代理或工作流。 例如,一个回答文档问题的工作流可能如下所示:在部署中使用用户范围的 MCP 工具
先决条件 您已添加自己的自定义身份验证中间件,该中间件填充
langgraph_auth_user 对象,使其可以通过图中的每个节点的配置上下文进行访问。- MCP 仅支持向
streamable_http和ssetransport服务器发出的请求添加标头。 - 您的 MCP 服务器 URL。
- 从您的 MCP 服务器获取可用工具。
会话行为
当前的 LangGraph MCP 实现不支持会话。每个/mcp 请求都是无状态且独立的。
身份验证
/mcp 端点使用与 LangGraph API 其余部分相同的身份验证。有关设置详细信息,请参阅身份验证指南。
禁用 MCP
要禁用 MCP 端点,请在您的langgraph.json 配置文件中将 disable_mcp 设置为 true
/mcp 端点。
以编程方式连接这些文档到 Claude、VSCode 等,通过 MCP 获取实时答案。