From 8a6f4bbc0e4bd960cdf9b8d3d4bfbb2d8fbca3e8 Mon Sep 17 00:00:00 2001 From: Kiro Agent Date: Thu, 14 May 2026 15:52:27 +0530 Subject: [PATCH 1/3] Update mcp-server.mdx --- mcp-server.mdx | 208 ++++++++++++++++++++++++++++++------------------- 1 file changed, 130 insertions(+), 78 deletions(-) diff --git a/mcp-server.mdx b/mcp-server.mdx index 5ee2a78ca..046fa2b03 100644 --- a/mcp-server.mdx +++ b/mcp-server.mdx @@ -1,89 +1,141 @@ --- -title: "MCP Server" -description: "Connect AI tools like Claude and Cursor to CometChat documentation with the MCP server to improve integration speed and developer productivity." -canonical: "https://www.cometchat.com/docs/mcp" +title: "Use CometChat with AI Coding Agents (MCP)" +sidebarTitle: "MCP Integration" +description: "Connect CometChat to Claude, Cursor, Windsurf, VS Code, and any other Model Context Protocol–compatible agent. Search docs, fetch reference pages, and pull implementation bundles from inside the conversation." +canonical: "https://www.cometchat.com/docs/mcp-server" --- -## Using the CometChat MCP Server +The **CometChat MCP server** lets Claude, Cursor, Windsurf, VS Code, and any +other Model Context Protocol–compatible agent integrate CometChat into your +app from natural-language prompts. Ask the agent to *"add a chat tab where +users can DM each other"* and it uses the MCP to read CometChat's docs, +pick the right components for your stack, and write the integration code. -### Claude +The server is **read-only** and **needs no account or API key** — it surfaces +CometChat's public documentation and curated implementation recipes. -1. **Add MCP server to Claude** - 1. Navigate to the [Connectors](https://claude.ai) page in Claude’s settings. - 2. Select **Add custom connector**, name it e.g. `CometChat Docs`, and enter the URL: - ``` - https://www.cometchat.com/docs/mcp - ``` - 3. Click **Add**. -2. **Query with context** - 1. In Claude, click the attachments (➕) button. - 2. Select **CometChat Docs**. - 3. Ask your questions—Claude will use your CometChat docs as context. +## Connector URL + +``` +https://mcp.cometchat.com/mcp +``` + +Transport: HTTP with Server-Sent Events. No authentication required. + +## Connect from your agent + +### Claude (Desktop or claude.ai) + +1. Open **Settings → Connectors**. +2. Click **Add custom connector**. +3. Name it `CometChat`, paste the URL `https://mcp.cometchat.com/mcp`, and click **Add**. +4. In a new conversation, attach **CometChat** from the connectors picker and prompt away. ### Cursor -1. **Open MCP settings** - - Press `Cmd+Shift+P` (macOS) / `Ctrl+Shift+P` (Windows) → **Open MCP settings**. - - Select **Add custom MCP** to open your `mcp.json`. -2. **Configure** - ```json - { - "mcpServers": { - "cometchat-docs": { - "url": "https://www.cometchat.com/docs/mcp" - } - } - } - ``` -3. **Verify** - - In Cursor’s chat, ask: - > “How do I integrate CometChat in my React app?” - -{/* ### Lovable.dev - -1. **Open your Lovable project** - - Log in at [Lovable.dev](https://lovable.dev) and select your project. -2. **Add a custom MCP server** - - Go to **Settings** → **Developer Tools** → **MCP Servers**. - - Click **Add custom server**, then: - - **Name:** `CometChat Docs` - - **URL:** `https://www.cometchat.com/docs/mcp` - - Click **Save**. -3. **Use the tools** - - Invoke the CometChat tools in your conversations with Lovable’s AI assistant. */} +1. `Cmd+Shift+P` (macOS) / `Ctrl+Shift+P` (Windows) → **Open MCP settings**. +2. Click **Add custom MCP** and paste: + +```json +{ + "mcpServers": { + "cometchat": { + "url": "https://mcp.cometchat.com/mcp" + } + } +} +``` ### Windsurf -1. **Open Windsurf** - - Launch Windsurf and click the **Plugins** (hammer) icon. -2. **Add or configure** - - In **Manage plugins**, click **Add Custom Server +** or **View raw config**. - - Paste the following into your `mcp_config.json`: - ```json - { - "mcpServers": { - "cometchat-docs": { - "type": "sse", - "serverUrl": "https://www.cometchat.com/docs/mcp" - } - } - } - ``` - - Save and click **Refresh**. -3. **Invoke within Windsurf** - - In the Composer, ask prompts like: - > “Show me how to use CometChat in my app.” - -### Visual Studio Code - -1. **Prerequisites** - - Latest VS Code with Copilot (agent mode) enabled. -2. **Add the server** - - `Cmd+Shift+P` (macOS) / `Ctrl+Shift+P` (Windows) → **MCP: Add MCP Server**. - - Enter: - - **Server Name:** `CometChat Docs` - - **Server URL:** `https://www.cometchat.com/docs/mcp` - - **Transport:** `SSE` (or HTTP stream) - - Confirm. -3. **Use in Copilot agent** - - In a Copilot chat session, your CometChat tools will now be listed and available. +1. Click the **Plugins** (hammer) icon → **Manage plugins** → **View raw config**. +2. Paste: + +```json +{ + "mcpServers": { + "cometchat": { + "type": "sse", + "serverUrl": "https://mcp.cometchat.com/mcp" + } + } +} +``` + +3. Save and click **Refresh**. + +### Visual Studio Code (Copilot Agent) + +1. `Cmd+Shift+P` / `Ctrl+Shift+P` → **MCP: Add MCP Server**. +2. Enter: + - **Server Name:** `CometChat` + - **Server URL:** `https://mcp.cometchat.com/mcp` + - **Transport:** SSE +3. Confirm. + +## Example prompts + +Once connected, try these in a fresh agent conversation: + +- *"Add a chat tab where users can DM each other in my React app."* +- *"Let project members talk in a group chat with file sharing."* +- *"Add video calling between two users with a click-to-call button."* +- *"Set up content moderation so banned words are blocked before delivery."* +- *"Build a multi-tenant SaaS chat where each workspace's users are isolated."* +- *"Add presence indicators and typing dots to my conversation list."* + +The agent will search the docs, pull the matching implementation bundle, +and write the code into your project. + +## What the connector exposes + +### Three tools (all read-only) + + + + Search SDK guides, UI Kit references, REST API docs, and OpenAPI + specs. Returns ranked snippets with direct links. + + + Fetch the full content of any documentation page as markdown by URL + or relative path. + + + Return a curated implementation recipe — prerequisites, install, + configuration, working code — for a named scenario. + + + +### Ten curated implementation bundles + +| Bundle | What it covers | +| --- | --- | +| `react-uikit-quickstart` | React UI Kit install, init, login, conversations list, chat window | +| `react-native-uikit-quickstart` | React Native UI Kit install, navigation, basic chat screen | +| `flutter-uikit-quickstart` | Flutter UI Kit install, init, login, basic chat | +| `ios-uikit-quickstart` | iOS UI Kit (SwiftUI) install, init, login, chat view | +| `android-uikit-quickstart` | Android UI Kit (Compose) install, init, login, chat screen | +| `js-sdk-messaging-basics` | Vanilla JS SDK install, send/receive text and media messages | +| `widget-embed` | No-code widget embed for an existing site | +| `moderation-setup` | AI moderation, profanity filter, image moderation, webhooks | +| `multi-tenant-chat` | Multi-tenant SaaS chat — auth, isolation, tenant-scoped users | +| `presence-and-typing` | Online presence, typing indicators, read receipts | + +### Orientation skill resource + +The MCP also exposes a `cometchat://skills/overview` resource — a structured +markdown document the agent reads once to orient itself on CometChat's +products, decision tree, and common pitfalls. + +## Source + +The MCP server is open-source at +[`github.com/cometchat/cometchat-mcp`](https://github.com/cometchat/docs-mcp). +Built from this very documentation repository, so the content it surfaces +is always in sync with what you see on the docs site. + +## Support + +Questions, feedback, or feature requests: open an issue on the +[GitHub repository](https://github.com/cometchat/docs-mcp/issues) +or contact the team at . From 5ad393a8453e94d2ed2cee88f96545c0e699d4e8 Mon Sep 17 00:00:00 2001 From: Kiro Agent Date: Thu, 14 May 2026 16:22:42 +0530 Subject: [PATCH 2/3] Update mcp-server.mdx --- mcp-server.mdx | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/mcp-server.mdx b/mcp-server.mdx index 046fa2b03..901293132 100644 --- a/mcp-server.mdx +++ b/mcp-server.mdx @@ -137,5 +137,4 @@ is always in sync with what you see on the docs site. ## Support Questions, feedback, or feature requests: open an issue on the -[GitHub repository](https://github.com/cometchat/docs-mcp/issues) -or contact the team at . +[GitHub repository](https://github.com/cometchat/docs-mcp/issues) \ No newline at end of file From 03e1414240b6249375620e4e8be7f2ad063008e1 Mon Sep 17 00:00:00 2001 From: Kiro Agent Date: Thu, 14 May 2026 16:44:55 +0530 Subject: [PATCH 3/3] Update docs.json --- docs.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs.json b/docs.json index 09004b758..70bf39e23 100644 --- a/docs.json +++ b/docs.json @@ -18,9 +18,9 @@ }, "contextual": { "options": [ - "chatgpt", "claude", "cursor", + "chatgpt", "vscode", "perplexity", "mcp",