[ketanyekale]

Rewrite of the MCP page for docs-mcp v0.1.7, the release that went to production on 2026-10-27. The page now describes the server as it is today: name "CometChat Docs", Streamable HTTP only, the 120-per-minute rate limit, four tools with their 0.1.7 behaviour, eleven implementation bundles compiled from the live docs pages (Angular added), and the cometchat:// resources. The client sections are rewritten from each client's current documentation: Claude now has one-click install from the connector directory with the custom-connector path as the fallback, Claude Code and Codex get their CLI commands, Cursor and VS Code get one-click install links plus the current config file formats, VS Code no longer says SSE, and the Windsurf section follows the Devin Desktop rename.

Description

• Intro and meta description: name the server "CometChat Docs", add Claude Code and Codex to the client list, say bundles are compiled from the current documentation rather than curated recipes.
• Connector URL: transport is Streamable HTTP (the page said "HTTP with Server-Sent Events" and told VS Code and Windsurf users to pick SSE, which the server does not offer); add the rate limit.
• New "One-click install" card group: Claude connector directory, Cursor install link, VS Code install redirect.
• New note: the CometChat Agent Skills installer already adds this server as cometchat-docs.
• Claude: directory listing steps, Team/Enterprise owner step, custom-connector fallback with Anthropic's guide.
• New Claude Code and Codex sections with the CLI commands and config files.
• Cursor: one-click link, ~/.cursor/mcp.json and .cursor/mcp.json.
• VS Code: one-click link, @mcp cometchat Extensions search, .vscode/mcp.json in the servers / "type": "http" format, trust prompt.
• Windsurf: renamed to Windsurf (Devin Desktop), Cascade "Open MCP config file" path and the Devin Local docs link; the old "type": "sse" snippet is gone.
• Tools: four cards rewritten to match the 0.1.7 tool descriptions, including the 50 KiB page cut and the version filter; note that every tool returns structured results.
• Bundles: "Eleven implementation bundles", each row now says which docs pages the bundle compiles and which related pages it lists; angular-uikit-quickstart added; resource URI cometchat://bundles/<bundle-name> documented.
• Source: Apache-2.0, correct repository link (the page linked cometchat-mcp), how the search index and page fetches stay current.

Second commit, after a review of the page against the live server and each client's current documentation on 2026-11-02:

• Agent Skills note scoped to what the installer does: it adds cometchat-docs only for Claude Code, Cursor, Codex and Gemini, not with --no-mcp or after a --global Claude Code install.
• Claude: directory path and custom-connector fallback follow Anthropic's current articles ("+ Add", name, Continue, Continue, "No sign in", Add; Team/Enterprise Owners from Organization settings).
• Claude Code and Codex: plugin install commands added, both run today against isolated configs.
• VS Code: the guided flow asks for a server ID and a destination and recommends Global → Copilot Global; .vscode/mcp.json stays as the workspace file and is named as the deprecated destination it now is.
• Windsurf (Devin Desktop): Cascade is retired, so the steps use the Devin Local path (Agents → Customize → MCPs) and name the .devin/mcp_config.json and ~/.config/devin/mcp_config.json files.
• Bundle table: the JavaScript, widget, presence and Android rows name the related pages the bundles really list.
• Index latency: production polls the docs repository every ten minutes, so "a few minutes" became "up to about ten minutes". Browser-origin requests are noted as refused with 403. Support links the health endpoint and the support form. Meta description trimmed to 160 characters.

Third commit: the Lovable page's "+" button is now labelled "Add custom" in Lovable's catalog, per Lovable's current docs.

Related Issue(s)

docs-mcp v0.1.7 release: https://github.com/cometchat/docs-mcp/releases/tag/v0.1.7

Type of Change

• Documentation correction/update
• New documentation
• Improvement to existing documentation
• Typo fix
• Other (please specify)

Checklist

• I have read the CONTRIBUTING document
• My branch name follows the naming convention
• My changes follow the documentation style guide
• I have checked for spelling and grammar errors
• All links in my changes are valid and working
• My changes are accurately described in this pull request

Additional Information

Checked on 2026-11-02 before opening (and again after the review commits): every external URL on the page returns 200 (the two VS Code links return the 302 that hands off to the editor), /agent-skills and /lovable exist, and https://mcp.cometchat.com/health reports version 0.1.7 with 11 bundles ready and an index built from docs commit 1246348a, the current main. tools/list on production returns the four tools named on the page and resources/list returns the 12 resources (the overview skill plus the 11 bundles).

Screenshots (if applicable)

Not applicable, text and existing components only.

🤖 Generated with Claude Code

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated
cometchat	🟢 Ready	View Preview	Nov 2, 2026, 11:29 AM

💡 Tip: Enable Automations to automatically generate PRs for you.

[raj-dubey1]

Approving. I checked the page against the live server and the clients:

• https://mcp.cometchat.com/health reports 0.1.7 with 11 bundles ready, and the index is built from the current main. tools/list returns the four tools on the page, resources/list returns 12 resources (the overview plus 11 bundles), and a request with an Origin header gets 403.
• claude mcp add --transport http …, codex mcp add cometchat --url …, and both plugin installs (claude plugin install cometchat@cometchat, codex plugin add cometchat@cometchat) work in clean configs.
• The external links (Claude directory listing, Anthropic's custom-connector guide, Devin MCP docs, the repo) all return 200.

Two notes for merging, not blockers:

• The branch is 162 commits behind main. It merges cleanly, but a rebase would help.
• #568 also edits mcp-server.mdx and conflicts with this PR, so whichever of the two merges second needs a rebase.