Chatway MCP Server: Connect AI Agents to Customer Support

Let ChatGPT, Claude, Gemini, Cursor, and other AI agents read and manage your Chatway live chat conversations, support tickets, and contacts.

Create a free Chatway account · Setup guides · Documentation · MCP Registry

The Chatway MCP server connects AI agents to your Chatway inbox over the
Model Context Protocol. Ask your assistant to find
conversations, summarize customer issues, reply to customers, assign agents, add private notes,
search your knowledge base, and organize contacts, all in plain language.

Available on every Chatway plan, including Free. There is nothing to install or host and no
API key to manage: add the server URL to your AI client and sign in with your Chatway account.

Chatway Live Chat is an AI-powered customer support platform for live chat,
AI chatbots, WhatsApp, Facebook Messenger, Instagram, and more, with a shared team inbox,
automation, knowledge base, and mobile apps for iOS and Android.

Quick start

1. Create a free Chatway account if you don't have one.
2. Add https://mcp.chatway.app/mcp as a custom (remote) MCP connector in your AI client.
3. Sign in to Chatway when prompted and choose the widgets, channels, and permissions to share.
4. Ask your assistant something like "Show my latest unresolved Chatway conversations."

Supported clients

Tested by Chatway

Works with any client that supports remote MCP servers with OAuth

Claude, ChatGPT, Codex, Grok, Devin, Goose, OpenCode, and others. See the
step-by-step setup guides
for each client.

What you can do

See the tool reference for
every tool and its parameters.

Example prompts

• "Summarize today's unresolved support conversations."
• "Find customers waiting more than 2 hours for a reply."
• "Draft replies for all pricing questions, but don't send them yet."
• "Assign today's billing conversations to Alex."
• "Find conversations about refund issues this week."
• "Search the knowledge base for our refund policy and draft an answer for this customer."
• "Summarize the conversation with [email protected] and add a private note with next steps."
• "Tag this visitor as vip and resolve the conversation."

Client setup

Gemini CLI

Install the Chatway extension in Gemini CLI:

gemini extensions install https://github.com/Chatway-app/chatway-mcp-server

Then start gemini and sign in to Chatway:

/mcp auth chatway

A browser window opens to sign in to Chatway and approve access. Once connected, /mcp list
shows the chatway server and its tools.

Gemini CLI receives the OAuth callback on localhost, so sign in on the same machine where
Gemini CLI is running.

Cursor

Install the Chatway plugin from the Cursor Marketplace.
The plugin adds the Chatway MCP server and a Chatway rule that guides the agent to confirm before
sending replies or making destructive changes.

1. Install the plugin, then open Cursor Settings → MCP (or Tools & MCP).
2. Next to the chatway server, click Connect (or Needs login) and sign in to Chatway.
3. Once connected, the Chatway tools are listed under the server and available to the agent.

If you previously added Chatway manually in ~/.cursor/mcp.json, remove that entry so only the
plugin's server is used.

GitHub Copilot (VS Code)

Chatway works with GitHub Copilot Chat in VS Code in Agent mode.

1. Open the Command Palette (Cmd/Ctrl + Shift + P) and run MCP: Add Server.
2. Choose HTTP, then Workspace or Global.
3. Paste https://mcp.chatway.app/mcp and name the server chatway.
4. Trust the server when VS Code asks, then sign in to Chatway in the browser window that opens.
5. In Copilot Chat, switch to Agent mode. The Chatway tools appear in the tools picker.

Or add it to mcp.json yourself (.vscode/mcp.json for a workspace, or MCP: Open User
Configuration for all workspaces):

{
  "servers": {
    "chatway": {
      "type": "http",
      "url": "https://mcp.chatway.app/mcp"
    }
  }
}

The root key is servers (not mcpServers), and "type": "http" is required.

One-click install from the GitHub MCP Registry (searching @mcp Chatway in VS Code
Extensions) will be available once Chatway is accepted into the curated
GitHub MCP Registry. Until then, use the steps above.

Cline

Ask Cline: "Set up the Chatway MCP server from https://github.com/Chatway-app/chatway-mcp-server".
Cline follows llms-install.md to add the server.

To add it yourself, open MCP Servers → Remote Servers, enter chatway as the name, paste
https://mcp.chatway.app/mcp, choose Streamable HTTP, click Add Server, and sign in to
Chatway when prompted. Or add this to Cline's MCP settings JSON:

{
  "mcpServers": {
    "chatway": {
      "type": "streamableHttp",
      "url": "https://mcp.chatway.app/mcp",
      "disabled": false
    }
  }
}

"type": "streamableHttp" is required. Without it, Cline uses the legacy SSE transport and the
connection fails with HTTP 400.

Other clients

Add https://mcp.chatway.app/mcp as a remote MCP server using the Streamable HTTP transport and
complete the Chatway sign-in. Client-specific steps for Claude, ChatGPT, and others are in the
setup guides.

Troubleshooting

• Tools missing or 401 errors: reconnect or re-authenticate the chatway server in your
  client. Tokens are revoked when the connection is disconnected in Chatway.
• Can't approve access: only Chatway workspace owners and admins can connect an assistant.
• A tool isn't available: that permission wasn't granted, or the tool requires a paid plan.
  Change permissions under AI → External AI in Chatway, or reconnect.

Security and data protection

• You choose what to share. During sign-in you pick which widgets, channels, and permissions
  the connection gets. Tools without a granted permission are not offered to the assistant.
• Role-checked. Only workspace owners and admins can connect an assistant, and every action
  is limited by the authorizing user's Chatway role.
• Server-side confirmation for sensitive actions. Resolving or reopening a conversation,
  assigning it, and removing tags or custom data are not performed on the first call. The server
  returns a one-time confirmation token tied to the exact request, and the action only runs when
  the tool is called again with that token. How the confirmation is shown to you depends on your
  AI client.
• No passwords or API keys shared. Connections use OAuth 2.1; your AI client never sees your
  Chatway password.
• Revocable at any time. Owners and admins can change permissions or disconnect from
  AI → External AI in Chatway; disconnecting revokes the token immediately.
• Hosted by Chatway. The server runs on Chatway's infrastructure over HTTPS. This repository
  contains no server code or secrets.

Details: Permissions & access ·
Manage connections ·
Security policy

About this repository

This repository holds Chatway's public listings for the
official MCP Registry, the
Gemini CLI extension gallery, the
Cursor Marketplace, and the
Cline MCP Marketplace: manifests, logos, and setup
guides. Maintainers: see MAINTAINING.md.

Support

Visit the Chatway Help Center or contact the support team through
live chat on chatway.app.

License

The manifests, configuration, and documentation in this repository are available under the
MIT License. The Chatway name and logos are trademarks of Chatway and are not covered by
this license. The hosted Chatway service and MCP server are proprietary.