LangSmith 远程 MCP

​

端点

​

身份验证

​

OAuth

1. 客户端会在浏览器中打开授权 URL。
2. 你登录 LangSmith（或使用已有会话）并同意授权。
3. 客户端会收到访问令牌和刷新令牌。
4. 访问令牌过期后，客户端会自动刷新。

​

API 密钥

​

快速开始

​

Claude Code

{
  "mcpServers": {
    "langsmith": {
      "type": "http",
      "url": "https://api.smith.langchain.com/mcp"
    }
  }
}

​

Deep Agents Code (dcode)

{
  "mcpServers": {
    "langsmith": {
      "url": "https://api.smith.langchain.com/mcp",
      "transport": "http",
      "auth": "oauth"
    }
  }
}

• 在 Deep Agents Code TUI 中运行 /mcp，选择 langsmith，并按照登录提示操作。
• 在 shell 中运行：
  dcode mcp login langsmith
  

​

Cursor

{
  "mcpServers": {
    "LangSmith": {
      "url": "https://api.smith.langchain.com/mcp"
    }
  }
}

​

LangSmith CLI

# LangSmith Cloud
langsmith auth login

# Self-hosted (point at your instance's /api base)
langsmith auth login --api-url https://<your-langsmith-host>/api

​

AI SDK

import { createMCPClient } from "@ai-sdk/mcp";

const client = await createMCPClient({
  transport: {
    type: "http",
    url: "https://api.smith.langchain.com/mcp",
    headers: { "X-Api-Key": process.env.LANGSMITH_API_KEY! },
  },
});

const tools = await client.tools();

​

其他客户端

​

已知的客户端不兼容性

​

可用工具

• 对话和线程： get_thread_history
• 提示管理： list_prompts、get_prompt_by_name、push_prompt
• 追踪和运行： fetch_runs、list_projects
• 数据集和示例： list_datasets、list_examples、read_dataset、read_example、create_dataset、update_examples
• 实验和评估： list_experiments、run_experiment
• 计费： get_billing_usage

​

重新进行身份验证

• Claude Code： 运行 /mcp，选择 langsmith，然后选择重新进行身份验证。
• Cursor： 在 MCP 设置中禁用并重新启用服务器。
• 其他客户端： 查看客户端的 MCP 设置界面。

​

自托管 LangSmith

​

启用远程 MCP

1. 生成 Ed25519（OKP）JWKS。 RSA 密钥会被拒绝。例如，可以使用 step：
   step crypto jwk create /dev/null /tmp/jwk.json --kty OKP --crv Ed25519 --no-password --insecure -f
   jq -c '{keys:[.]}' /tmp/jwk.json   # wrap the single key in a JWKS
   
2. 将其提供给 chart，作为 config.signingJwks（存储在 chart secret 中），或作为现有 secret中的 langsmith_signing_jwks 密钥：
   config:
     hostname: "your-langsmith-host"
     signingJwks: |
       {"keys":[ ... ]}
   
   不要通过 commonEnv 或 extraEnv 直接设置 LANGSMITH_SIGNING_JWKS——chart 已经从 secret 中为其完成配置，手动复制会因重复的环境变量而导致安装失败。请改用 config.signingJwks 或 config.existingSecretName。

curl https://<your-langsmith-host>/api/.well-known/oauth-protected-resource/mcp