Skip to content

Update MCP install links and tooling list - #3171

Merged
adityaoberai merged 2 commits into
mainfrom
fix-mcp-links
Aug 19, 2026
Merged

Update MCP install links and tooling list#3171
adityaoberai merged 2 commits into
mainfrom
fix-mcp-links

Conversation

@adityaoberai

Copy link
Copy Markdown
Contributor

What does this PR do?

Point the generic docs links in both MCP cards at the MCP servers page instead of the docs root.

Refresh the one-click install list:

  • Cursor and VS Code now use their protocol/install handlers
  • Claude Desktop becomes Claude Code, linking to its agent docs page
  • Windsurf becomes Codex, linking to its agent docs page
  • Fix "VS code" casing

Claude Code and Codex have no URL-scheme install, so they link to docs. Soften the "One-click install" heading to "Quick install" to match.

Replace the Windsurf icon with an OpenAI mark for Codex, reusing the same asset the docs site ships.

Test Plan

Visit the MCP Install section in the settings of a project

Related PRs and Issues

appwrite/website#3188

Have you read the Contributing Guidelines on issues?

Yes

Point the generic docs links in both MCP cards at the MCP servers page
instead of the docs root.

Refresh the one-click install list:
- Cursor and VS Code now use their protocol/install handlers
- Claude Desktop becomes Claude Code, linking to its agent docs page
- Windsurf becomes Codex, linking to its agent docs page
- Fix "VS code" casing

Claude Code and Codex have no URL-scheme install, so they link to docs.
Soften the "One-click install" heading to "Quick install" to match.

Replace the Windsurf icon with an OpenAI mark for Codex, reusing the
same asset the docs site ships.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@appwrite

appwrite Bot commented Aug 19, 2026

Copy link
Copy Markdown

Console (appwrite/console)

Project ID: 688b7bf400350cbd60e9

Sites (1)
Site Status Logs Preview QR
 console-stage
688b7cf6003b1842c9dc
Ready Ready View Logs Preview URL QR Code

Tip

Custom domains work with both CNAME for subdomains and NS records for apex domains

@greptile-apps

greptile-apps Bot commented Aug 19, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

The PR refreshes the MCP tooling choices, install handlers, documentation destinations, labels, and Codex branding.

  • Adds direct installation links for Cursor and VS Code.
  • Replaces Claude Desktop and Windsurf with Claude Code and Codex.
  • Points MCP documentation links to the dedicated MCP servers page.
  • Adds light and dark OpenAI assets for the Codex icon.

Confidence Score: 5/5

The PR appears safe to merge because no blocking failure remains.

No blocking failure remains.

Important Files Changed

Filename Overview
src/routes/(console)/project-[region]-[project]/store.ts Updates the shared MCP tool metadata with the new tools, labels, links, and Codex icon.
src/routes/(console)/project-[region]-[project]/overview/onboard.svelte Updates the onboarding MCP documentation destination and changes the section heading to “Quick install.”
src/routes/(console)/project-[region]-[project]/settings/updateInstallations.svelte Points the settings installation card at the dedicated MCP servers documentation.
src/routes/(console)/project-[region]-[project]/overview/components/CodexIcon.svelte Replaces the Windsurf icon component with a theme-aware Codex icon using the new OpenAI assets.

Reviews (2): Last reviewed commit: "Merge pull request #3172 from appwrite/m..." | Re-trigger Greptile

},
{
href: 'https://appwrite.io/docs/tooling/mcp/claude',
href: 'https://appwrite.io/docs/tooling/ai/agents/claude-code',

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Docs links resemble installers

Claude Code and Codex now open documentation, but both MCP cards render them identically to direct installers while promising deployment “with a single click.” This makes users expecting installation navigate to setup documentation without any label or external-link treatment that distinguishes the action.

Knowledge Base Used: Project overview and miscellaneous console pages

Prompt To Fix With AI
This is a comment left during a code review.
Path: src/routes/(console)/project-[region]-[project]/store.ts
Line: 88

Comment:
**Docs links resemble installers**

Claude Code and Codex now open documentation, but both MCP cards render them identically to direct installers while promising deployment “with a single click.” This makes users expecting installation navigate to setup documentation without any label or external-link treatment that distinguishes the action.

**Knowledge Base Used:** [Project overview and miscellaneous console pages](https://app.greptile.com/appwrite/-/custom-context/knowledge-base/appwrite/console/-/docs/project-overview-misc.md)

---

For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

Fix in Claude Code Fix in Codex

sync main into fix-mcp-links
@adityaoberai

Copy link
Copy Markdown
Contributor Author

Verified on staging
image

@adityaoberai
adityaoberai merged commit 95d2265 into main Aug 19, 2026
6 checks passed
@adityaoberai
adityaoberai deleted the fix-mcp-links branch August 19, 2026 17:37
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