Skip to content

docs: make local MCP server warning more visible#349

Merged
rwjblue-glean merged 1 commit into
mainfrom
rwjblue/docs-readme-warning-admonition
Apr 6, 2026
Merged

docs: make local MCP server warning more visible#349
rwjblue-glean merged 1 commit into
mainfrom
rwjblue/docs-readme-warning-admonition

Conversation

@rwjblue-glean

@rwjblue-glean rwjblue-glean commented Apr 6, 2026

Copy link
Copy Markdown
Member

Description

Use GitHub's > [!WARNING] blockquote alert syntax to make the "use the remote MCP server" recommendation visually prominent in both READMEs. Also adds the same warning to the top-level repo README, which previously lacked it.

Here's how it renders:

Warning

We recommend using the remote MCP server integrated directly in Glean instead of this local MCP server. The remote server provides a more seamless experience with automatic updates, better performance, and simplified configuration. This local MCP server is primarily intended for experimental and testing purposes.

Type of Change

  • Documentation update

How Has This Been Tested?

  • Manual testing — verified the alert renders correctly on GitHub

Checklist

  • My code follows the code style of this project
  • I have updated the documentation accordingly

Stack

  1. docs: make local MCP server warning more visible (this PR)
  2. docs: link to Glean CLI as alternative for local usage #350

Use GitHub's blockquote alert syntax (> [!WARNING]) to make the
recommendation to use the remote MCP server more visually prominent.
Also add the same warning to the top-level repo README.
@rwjblue-glean rwjblue-glean force-pushed the rwjblue/docs-readme-warning-admonition branch from 26c7c58 to 2ebada8 Compare April 6, 2026 21:26
@rwjblue-glean rwjblue-glean changed the title docs: use GitHub warning admonition in READMEs docs: make local MCP server warning more visible Apr 6, 2026
@rwjblue-glean rwjblue-glean marked this pull request as ready for review April 6, 2026 21:27
@rwjblue-glean rwjblue-glean requested a review from a team as a code owner April 6, 2026 21:27
@rwjblue-glean rwjblue-glean merged commit dbdac93 into main Apr 6, 2026
4 checks passed
@rwjblue-glean rwjblue-glean deleted the rwjblue/docs-readme-warning-admonition branch April 6, 2026 21:53
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.

2 participants