Skip to content

docs: clarify MCP server Credentials dropdown requirement#2044

Open
inkeep[bot] wants to merge 2 commits intomainfrom
docs-writer-ai-update-2026-02-16T21-36-25-766Z
Open

docs: clarify MCP server Credentials dropdown requirement#2044
inkeep[bot] wants to merge 2 commits intomainfrom
docs-writer-ai-update-2026-02-16T21-36-25-766Z

Conversation

@inkeep
Copy link
Contributor

@inkeep inkeep bot commented Feb 16, 2026

Summary

This PR addresses a documentation gap identified from Zendesk support ticket #6716, where a customer reported that MCP server creation would "hang" with no feedback.

Problem

Users creating custom MCP servers were experiencing the UI appearing to hang because they didn't realize they must make an active selection in the Credentials dropdown (either "No Authentication" or a specific credential) for server creation to proceed.

Changes

agents-docs/content/visual-builder/tools/mcp-servers.mdx

  • Updated the Credential field description to clarify that users must actively select an option
  • Added a Warning callout emphasizing that the Credential dropdown requires an active selection and that server creation will not proceed without one

agents-docs/content/troubleshooting.mdx

  • Added a new troubleshooting entry under "MCP Server Connection Issues" for the scenario where MCP server creation hangs or appears unresponsive
  • Provides clear steps to resolve the issue

Related

  • Zendesk ticket #6716

cc @inkeep/docs-team for review

inkeep bot added 2 commits February 16, 2026 21:37
…ting MCP servers

Addresses user feedback from Zendesk ticket #6716 where users experienced the UI
appearing to hang during MCP server creation because they didn't realize the
Credential dropdown requires an explicit selection (either "No Authentication"
or a specific credential).
Added guidance for users experiencing MCP server creation appearing to hang
or be unresponsive. The issue is caused by not making an active selection
in the Credentials dropdown - users must explicitly select either
"No Authentication" or a specific credential.

Resolves Zendesk ticket #6716
@vercel
Copy link

vercel bot commented Feb 16, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
agents-api Ready Ready Preview, Comment Feb 16, 2026 9:41pm
agents-docs Ready Ready Preview, Comment Feb 16, 2026 9:41pm
agents-manage-ui Ready Ready Preview, Comment Feb 16, 2026 9:41pm

Request Review

@changeset-bot
Copy link

changeset-bot bot commented Feb 16, 2026

⚠️ No Changeset found

Latest commit: 1d3abe4

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

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.

0 participants