langchain-ai/docs
1
0
Fork 0
mirror of https://github.com/langchain-ai/docs.git synced 2026-07-21 20:05:30 -04:00
Code Issues 490 Packages Projects Releases Wiki Activity

[PR #4216] [MERGED] docs(mda): update to with CLI experience and mcp oauth capability #4204

New Issue
Closed
opened 2026-06-05 19:13:08 -04:00 by yindo · 0 comments
yindo commented 2026-06-05 19:13:08 -04:00
Owner
Copy Link
Copy Source

📋 Pull Request Information

Original PR: https://github.com/langchain-ai/docs/pull/4216
Author: @victorm-lc
Created: 5/29/2026
Status: ✅ Merged
Merged: 6/1/2026
Merged by: @victorm-lc

Base: main ← Head: vic/mda-cli-update

📝 Commits (10+)

  • a30a494 docs(mda): add support for cli and oauth mcp tools
  • 4a1b91a docs(mda): fix MCP-tool referencing, agent limits, and deploy output
  • 0b34042 docs(mda): restructure flow of page
  • 4f241ac docs(mda): create a group and split out large deploy guide into subpages
  • 5c24a61 docs(mda): add more context about sandboxes
  • e5a8705 docs(mda): fix CLI reference anchor
  • c11debd Merge branch 'main' into vic/mda-cli-update
  • 917354a docs(mda): update sidebar title
  • a8c2150 docs(mda): use model shorthand in examples
  • 19d792f Merge branch 'main' into vic/mda-cli-update

📊 Changes

9 files changed (+1933 additions, -856 deletions)

View changed files

📝 src/docs.json (+12 -1)
📝 src/langsmith/deploy-managed-deep-agent.mdx (+75 -810)
📝 src/langsmith/managed-deep-agents-api.mdx (+72 -22)
➕ src/langsmith/managed-deep-agents-cli.mdx (+438 -0)
➕ src/langsmith/managed-deep-agents-deploy.mdx (+271 -0)
➕ src/langsmith/managed-deep-agents-invoke.mdx (+242 -0)
➕ src/langsmith/managed-deep-agents-mcp.mdx (+215 -0)
📝 src/langsmith/managed-deep-agents-openapi.json (+425 -23)
➕ src/langsmith/managed-deep-agents-quickstart.mdx (+183 -0)

📄 Description

Overview

Reconciles the Managed Deep Agents documentation with the actual behavior of the deepagents deploy CLI (0.2.0) after running the flow end to end. The headline fix: the guide documented referencing MCP servers via agent.json tools.mcp_servers, a shape that exists in neither the CLI nor the OpenAPI spec — following it deploys an agent with no tools. This PR makes tools.json the canonical, documented path and corrects several other mismatches.

Changes to src/langsmith/deploy-managed-deep-agent.mdx:

  • Reference MCP servers: removed the non-working agent.json tools.mcp_servers example; tools.json (tools[].mcp_server_url) is now the single documented mechanism, with the correct interrupt_config key format ({mcp_server_url}::{tool_name}::{mcp_server_name}: true).
  • Create-a-project flow: added an explicit step to register the MCP server and add tools.json before deploy (since deepagents init does not scaffold it).
  • Scaffold table: reframed tools.json from "advanced compatibility" to the actual tool-configuration file.
  • Deploy section: documented the real success output (agent_id, revision, agent URL, and the MCP health check) and noted that every deploy creates a new agent
    revision even when managed files are unchanged.
  • Agent limits: corrected the quota section — free workspaces are capped at 1 Managed Deep Agent (HTTP 409 on overflow); paid plans are unlimited (previously stated there were no per-workspace limits).
  • Install: added a note that a previously installed stable deepagents can shadow the beta on PATH (verify with deepagents --version).

src/langsmith/managed-deep-agents-api.mdx: added "agent limits" to the operational
topics it defers to the deploy guide. The OpenAPI spec was already correct and is
unchanged.

Type of change

Type: Update existing documentation

Related issues/PRs

Checklist

  • I have read the contributing guidelines, including the language policy
  • I have tested my changes locally using docs dev
  • All code examples have been tested and work correctly
  • I have used root relative paths for internal links
  • I have updated navigation in src/docs.json if needed

Additional notes

All edits were verified against the shipping CLI: markdownlint reports no new warnings (pre-existing MD046 hits are in untouched REST <Tab> examples), make check-cross-refs passes, and every JSON snippet parses. The documented tools.json shape was confirmed by running deepagents deploy --dry-run and checking the emitted payload contains the tools key — the exact check that exposed the original bug. No new pages were added, so src/docs.json needs no changes.

One follow-up worth flagging: confirm with the backend team whether the bare tool-name interrupt_config form is honored at runtime, or only the {url}::{tool}::{server} key format documented here.

🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/langchain-ai/docs/pull/4216 **Author:** [@victorm-lc](https://github.com/victorm-lc) **Created:** 5/29/2026 **Status:** ✅ Merged **Merged:** 6/1/2026 **Merged by:** [@victorm-lc](https://github.com/victorm-lc) **Base:** `main` ← **Head:** `vic/mda-cli-update` --- ### 📝 Commits (10+) - [`a30a494`](https://github.com/langchain-ai/docs/commit/a30a494ede029982665cb459af2443f3bc09736e) docs(mda): add support for cli and oauth mcp tools - [`4a1b91a`](https://github.com/langchain-ai/docs/commit/4a1b91aecea418a6e26ddcebbf1df4aba55cd450) docs(mda): fix MCP-tool referencing, agent limits, and deploy output - [`0b34042`](https://github.com/langchain-ai/docs/commit/0b34042d6ae4f1da282aa2ab72d1e43ad8edd8da) docs(mda): restructure flow of page - [`4f241ac`](https://github.com/langchain-ai/docs/commit/4f241ac47e0e530c5348073d888a5ffec456b09b) docs(mda): create a group and split out large deploy guide into subpages - [`5c24a61`](https://github.com/langchain-ai/docs/commit/5c24a613b80f9245e68d66cecfc261626fce79e9) docs(mda): add more context about sandboxes - [`e5a8705`](https://github.com/langchain-ai/docs/commit/e5a8705e2a3dbc505f4408e0a29ba400cd32648a) docs(mda): fix CLI reference anchor - [`c11debd`](https://github.com/langchain-ai/docs/commit/c11debd173c6bce839523890f3ea48ef969603c2) Merge branch 'main' into vic/mda-cli-update - [`917354a`](https://github.com/langchain-ai/docs/commit/917354abf35012f64e979bac2108a3466d26b5ff) docs(mda): update sidebar title - [`a8c2150`](https://github.com/langchain-ai/docs/commit/a8c21506ea8b64d30b0721ef14db1f075f532808) docs(mda): use model shorthand in examples - [`19d792f`](https://github.com/langchain-ai/docs/commit/19d792f3db6c10fc3592e925deabaa5f76b02ee8) Merge branch 'main' into vic/mda-cli-update ### 📊 Changes **9 files changed** (+1933 additions, -856 deletions) <details> <summary>View changed files</summary> 📝 `src/docs.json` (+12 -1) 📝 `src/langsmith/deploy-managed-deep-agent.mdx` (+75 -810) 📝 `src/langsmith/managed-deep-agents-api.mdx` (+72 -22) ➕ `src/langsmith/managed-deep-agents-cli.mdx` (+438 -0) ➕ `src/langsmith/managed-deep-agents-deploy.mdx` (+271 -0) ➕ `src/langsmith/managed-deep-agents-invoke.mdx` (+242 -0) ➕ `src/langsmith/managed-deep-agents-mcp.mdx` (+215 -0) 📝 `src/langsmith/managed-deep-agents-openapi.json` (+425 -23) ➕ `src/langsmith/managed-deep-agents-quickstart.mdx` (+183 -0) </details> ### 📄 Description ## Overview Reconciles the Managed Deep Agents documentation with the actual behavior of the `deepagents` deploy CLI (0.2.0) after running the flow end to end. The headline fix: the guide documented referencing MCP servers via `agent.json` `tools.mcp_servers`, a shape that exists in neither the CLI nor the OpenAPI spec — following it deploys an agent with **no tools**. This PR makes `tools.json` the canonical, documented path and corrects several other mismatches. Changes to `src/langsmith/deploy-managed-deep-agent.mdx`: - **Reference MCP servers:** removed the non-working `agent.json` `tools.mcp_servers` example; `tools.json` (`tools[].mcp_server_url`) is now the single documented mechanism, with the correct `interrupt_config` key format (`{mcp_server_url}::{tool_name}::{mcp_server_name}: true`). - **Create-a-project flow:** added an explicit step to register the MCP server and add `tools.json` before deploy (since `deepagents init` does not scaffold it). - **Scaffold table:** reframed `tools.json` from "advanced compatibility" to the actual tool-configuration file. - **Deploy section:** documented the real success output (agent_id, revision, agent URL, and the MCP `health` check) and noted that every deploy creates a new agent revision even when managed files are unchanged. - **Agent limits:** corrected the quota section — free workspaces are capped at 1 Managed Deep Agent (HTTP 409 on overflow); paid plans are unlimited (previously stated there were no per-workspace limits). - **Install:** added a note that a previously installed stable `deepagents` can shadow the beta on `PATH` (verify with `deepagents --version`). `src/langsmith/managed-deep-agents-api.mdx`: added "agent limits" to the operational topics it defers to the deploy guide. The OpenAPI spec was already correct and is unchanged. ## Type of change **Type:** Update existing documentation ## Related issues/PRs - Feature PR: https://github.com/langchain-ai/deepagents/pull/3609 - Linear issue: https://linear.app/langchain/issue/AB-2470/mda-wrap-apis-in-deepagents-deploy and https://linear.app/langchain/issue/AB-2485/mda-enable-oauth-on-mcp-servers ## Checklist - [x] I have read the [contributing guidelines](README.md), including the [language policy](https://docs.langchain.com/oss/python/contributing/overview#language-policy) - [x] I have tested my changes locally using `docs dev` - [x] All code examples have been tested and work correctly - [x] I have used **root relative** paths for internal links - [x] I have updated navigation in `src/docs.json` if needed ## Additional notes All edits were verified against the shipping CLI: `markdownlint` reports no new warnings (pre-existing MD046 hits are in untouched REST `<Tab>` examples), `make check-cross-refs` passes, and every JSON snippet parses. The documented `tools.json` shape was confirmed by running `deepagents deploy --dry-run` and checking the emitted payload contains the `tools` key — the exact check that exposed the original bug. No new pages were added, so `src/docs.json` needs no changes. One follow-up worth flagging: confirm with the backend team whether the bare tool-name `interrupt_config` form is honored at runtime, or only the `{url}::{tool}::{server}` key format documented here. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
yindo added the pull-request label 2026-06-05 19:13:08 -04:00
yindo closed this issue 2026-06-05 19:13:08 -04:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
bug
deepagents
docs-infra
external
external
help wanted
integration
internal
internal
javascript
js/ts
langchain
langgraph
langsmith
needs-title
pull-request
Mirrored from GitHub Pull Request
 python
reference
No Label pull-request
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
yindo
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: langchain-ai/docs#4204
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?