Skip to content

docs(ai-agents): document MCP connection timeout behavior#742

Closed
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/54761e8d
Closed

docs(ai-agents): document MCP connection timeout behavior#742
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/54761e8d

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented Jun 2, 2026

Summary

Documents the new 20-second timeout that Lightdash applies when AI agents connect to external MCP servers, and the MCP_CONNECTION_TIMEOUT_MS override for self-hosted deployments.

Changes

  • Added a Troubleshooting section to the MCP servers guide explaining the user-facing timeout error and behavior.
  • Documented the MCP_CONNECTION_TIMEOUT_MS env var (default 20000) for self-hosted admins who need to tune the timeout.

Context

Triggered by lightdash/lightdash#23788, which adds a timeout to MCP client connect and tool-discovery calls so a hanging MCP server no longer stalls admin or chat requests. On timeout, the server is marked as errored with a user-facing message, and per-server timeouts in agent runs prevent one slow server from blocking the rest.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 2, 2026

🤖 Documentation Bot

Status

⚠️ 1 broken link needs manual attention


🔗 Broken Links (Manual Fix Required)

Click to view details
   📄 timezones-draft.mdx

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented Jun 2, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
lightdash 🟢 Ready View Preview Jun 2, 2026, 2:56 PM

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant