Skip to content

Confusing mcp.json label in "Manual setup" of Build with AI guide #13777

Description

@kimulaco

📚 Subject area/topic

Build with AI

📋 Page(s) affected (or suggested, for new content)

https://docs.astro.build/en/guides/build-with-ai/

📋 Description of content that is out-of-date or incorrect

In the "Manual setup" section, both example code blocks are labeled mcp.json.

This can be confusing because the section describes a generic MCP configuration object to paste into a tool's MCP settings, not a universal filename. Other sections on the same page already use MCP Configuration or tool-specific filenames such as .codex/config.toml, .gemini/settings.json, and mcp_config.json.

I'd suggest changing the label to MCP Configuration to match the other sections.

🖥️ Reproduction in StackBlitz (if reporting incorrect content or code samples)

N/A

Metadata

Metadata

Assignees

No one assigned

    Labels

    improve or update documentationEnhance / update existing documentation (e.g. add example, improve description, update for changes)

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions