Skip to content

Expand MCP acronym to "Model Context Protocol" on first use in documentation#7931

Merged
pelikhan merged 4 commits intomainfrom
copilot/expand-mcp-acronym
Dec 27, 2025
Merged

Expand MCP acronym to "Model Context Protocol" on first use in documentation#7931
pelikhan merged 4 commits intomainfrom
copilot/expand-mcp-acronym

Conversation

Copy link
Contributor

Copilot AI commented Dec 27, 2025

The term "MCP" appeared throughout documentation without expansion, creating confusion for new users unfamiliar with the Model Context Protocol.

Changes

Updated 27 files to expand "MCP" to "Model Context Protocol (MCP)" on first occurrence per page:

  • Reference docs (11 files): tools, frontmatter, engines, sandbox, safe-outputs, compilation-process, imports, tokens, permissions, environment-variables, frontmatter-full
  • Guides (7 files): getting-started-mcp, web-search, custom-safe-outputs, packaging-imports, researchplanassign, security
  • Setup (2 files): mcp-server, cli
  • Introduction (2 files): architecture, how-it-works
  • Examples (3 files): projectops, research-planning, README
  • Troubleshooting (2 files): common-issues, errors

Subsequent uses within the same page continue using "MCP" alone for readability. Glossary entry preserved as authoritative reference.

Example

Before:

**Note:** Some engines require third-party MCP servers for web search.

After:

**Note:** Some engines require third-party Model Context Protocol (MCP) servers for web search.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

  • telemetry.astro.build
    • Triggering command: /opt/hostedtoolcache/node/24.12.0/x64/bin/node node /home/REDACTED/work/gh-aw/gh-aw/docs/node_modules/.bin/astro build (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Original prompt

This section details on the original issue you should resolve

<issue_title>[plan] Expand MCP acronym to "Model Context Protocol" on first use</issue_title>
<issue_description>## Objective

Expand the "MCP" acronym to "Model Context Protocol (MCP)" on first use throughout the documentation.

Context

The term "MCP" is used frequently without expanding the acronym, which confuses beginners who don't know what it stands for.

Implementation

On first use of "MCP" on each page, write:

Model Context Protocol (MCP)

Subsequent uses on the same page can use "MCP" alone.

Files to Update

Search for first occurrence of "MCP" in:

  • docs/src/content/docs/guides/quick-start.md
  • docs/src/content/docs/guides/agentic-authoring.mdx
  • docs/src/content/docs/reference/frontmatter.md
  • All example workflow documentation
  • Other guides that mention MCP

Approach

Use grep to find all files mentioning MCP:

grep -r "MCP" docs/src/content/docs/ --files-with-matches

Then update the first occurrence in each file.

Acceptance Criteria

  • First use of MCP on each page expands to "Model Context Protocol (MCP)"
  • Subsequent uses can use "MCP" alone
  • Glossary entry for MCP remains as the full reference
  • Change is consistent across all documentation

AI generated by Plan Command for discussion #7874

Comments on the Issue (you are @copilot in this section)


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Copilot AI self-assigned this Dec 27, 2025
Copilot AI and others added 3 commits December 27, 2025 22:02
Co-authored-by: mnkiefer <8320933+mnkiefer@users.noreply.github.com>
Co-authored-by: mnkiefer <8320933+mnkiefer@users.noreply.github.com>
Co-authored-by: mnkiefer <8320933+mnkiefer@users.noreply.github.com>
Copilot AI changed the title [WIP] Expand MCP acronym to Model Context Protocol on first use Expand MCP acronym to "Model Context Protocol" on first use in documentation Dec 27, 2025
Copilot AI requested a review from mnkiefer December 27, 2025 22:08
@pelikhan pelikhan marked this pull request as ready for review December 27, 2025 22:43
@pelikhan pelikhan merged commit b805fd0 into main Dec 27, 2025
4 checks passed
@pelikhan pelikhan deleted the copilot/expand-mcp-acronym branch December 27, 2025 22:44
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.

[plan] Expand MCP acronym to "Model Context Protocol" on first use

3 participants

Comments