Skip to content

[WIP] (docs) make landing MCP doc root more actionable#414

Open
ronan-apollo wants to merge 7 commits intomainfrom
docs-mcp-landing-cards
Open

[WIP] (docs) make landing MCP doc root more actionable#414
ronan-apollo wants to merge 7 commits intomainfrom
docs-mcp-landing-cards

Conversation

@ronan-apollo
Copy link
Contributor

Opening this as a local branch PR to replace #402 (fork based).

This PR modifies the MCP docs homepage, to try and replicate the card-type structure seen on Router and other Docs landing pages.

  • uses card layout to highlight main actions / features
  • moves 'what is mcp' / 'what is apollo mcp' to a new sub page called 'how it works'

Note: I'm not 100% on whether the card-layout works in these MDX centeric parts of the Docs structure, the templating here may be more restrictive (seems like those pages are Astro based landing pages in docs-rewrite) but I want to get a deploy preview up to test what's possible with the formatting here.

* uses card layout to focus MCP docs root on start
* moves what is mcp / what is apollo mcp to a new page

Signed-off-by: Ronan Flynn-Curran <ronan.flynn-curran@apollographql.com>
@ronan-apollo ronan-apollo requested review from a team as code owners October 2, 2025 22:02
@apollo-librarian
Copy link

apollo-librarian bot commented Oct 2, 2025

✅ Docs preview ready

The preview is ready to be viewed. View the preview

File Changes

1 new, 5 changed, 2 removed
+ (developer-tools)/apollo-mcp-server/(latest)/how-it-works.mdx
* (developer-tools)/apollo-mcp-server/(latest)/config-file.mdx
* (developer-tools)/apollo-mcp-server/(latest)/define-tools.mdx
* (developer-tools)/apollo-mcp-server/(latest)/deploy.mdx
* (developer-tools)/apollo-mcp-server/(latest)/index.mdx
* (developer-tools)/apollo-mcp-server/(latest)/_sidebar.yaml
- (developer-tools)/apollo-mcp-server/(latest)/cors.mdx
- (developer-tools)/apollo-mcp-server/(latest)/telemetry.mdx

Build ID: b3301c128e2c46d797acbcb8
Build Logs: View logs

URL: https://www.apollographql.com/docs/deploy-preview/b3301c128e2c46d797acbcb8

Signed-off-by: Ronan Flynn-Curran <ronan.flynn-curran@apollographql.com>

close tags to fix deploy preview

Signed-off-by: Ronan Flynn-Curran <ronan.flynn-curran@apollographql.com>

close tags

Signed-off-by: Ronan Flynn-Curran <ronan.flynn-curran@apollographql.com>
@ronan-apollo ronan-apollo force-pushed the docs-mcp-landing-cards branch from d72c02f to e813e86 Compare October 2, 2025 22:21
Signed-off-by: Ronan Flynn-Curran <ronan.flynn-curran@apollographql.com>
Signed-off-by: Ronan Flynn-Curran <ronan.flynn-curran@apollographql.com>
Signed-off-by: Ronan Flynn-Curran <ronan.flynn-curran@apollographql.com>
Signed-off-by: Ronan Flynn-Curran <ronan.flynn-curran@apollographql.com>
@DaleSeo
Copy link
Member

DaleSeo commented Jan 14, 2026

Hey @ronan-apollo, are you still working on this PR?

@ronan-apollo
Copy link
Contributor Author

@DaleSeo sorry this has been neglected, will update and resolve asap today

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