Quickchat AI MCP Server

What is Quickchat AI MCP Server about?

Quickchat AI MCP Server enables developers to make a Quickchat AI Agent reachable from any AI client that supports the Model Context Protocol, such as Claude Desktop, Cursor, VS Code, Windsurf, and many others.

How to use Quickchat AI MCP Server?

Create a Quickchat AI account and start a trial or paid plan.
Configure your agent in the Quickchat dashboard (knowledge base, capabilities, settings).
Activate the MCP on the MCP page – give it a name, description and optional command.
Install the uv package manager (curl -LsSf https://astral.sh/uv/install.sh | sh).
Add the server configuration to the AI client (Claude Desktop, Cursor, etc.) using the JSON snippet shown in the README, inserting your SCENARIO_ID and API_KEY.
Run the server with uvx quickchat-ai-mcp (or the equivalent uv run … command for debugging).
Test the integration from the client; conversations will appear in the Quickchat inbox.

Key features of Quickchat AI MCP Server

One‑click deployment of name, description, and command directly from the Quickchat dashboard.
Secure handling of API keys with an optional “Require API key” toggle.
Full conversation transcript stored in Quickchat Inbox for monitoring and analytics.
Works with any MCP‑compatible client, not limited to a single tool.
Open‑ended, allowing dynamic interaction with any Quickchat AI Agent you create.

Use cases of Quickchat AI MCP Server

IDE assistance – integrate a custom tutoring or code‑review agent into VS Code or Cursor.
Desktop assistants – expose a personal knowledge base agent to Claude Desktop for natural‑language queries.
Customer support bots – let support agents invoke a Quickchat AI from within internal tools.
Prototype AI services – rapidly test new agents across multiple client applications without writing separate connectors.

FAQ from the Quickchat AI MCP Server

Q: Do I need to expose my API key to end users? A: No. Turn off the Require API key toggle on the MCP page and share a configuration that only contains SCENARIO_ID.

Q: Which command should I use to run the server? A: The recommended command is uvx quickchat-ai-mcp. For debugging you can also use uv run mcp dev src/__main__.py.

Q: Can I use the server with non‑Python clients? A: Yes. As long as the client supports MCP, you only need to provide the JSON snippet with the command and environment variables.

Q: How do I update the agent’s behaviour after deployment? A: Changes made in the Quickchat dashboard (name, description, capabilities) are deployed instantly; clients just need to refresh the MCP connection.

Q: What testing tools are available? A: The repository includes ruff for linting and pytest for unit tests. Use uv run pytest to run the test suite.

The Quickchat AI MCP (Model Context Protocol) server allows you to let anyone plug in your Quickchat AI Agent into their favourite AI app such as Claude Desktop, Cursor, VS Code, Windsurf and more.

Quickstart

Create a Quickchat AI account and start a 7-day trial of any plan.
Set up your AI's Knowledge Base, capabilities and settings.
Go to the MCP page to activate your MCP. Give it Name, Description and (optional) Command. They are important - AI apps need to understand when to contact your AI, what its capabilities and knowledge are.
That's it! Now you're ready to test your Quickchat AI via any AI app and show it to the world!

Useful links

Quickstart video youtube.com/watch?v=JE3dNiyZO8w
Quickstart blog post: quickchat.ai/post/how-to-launch-your-quickchat-ai-mcp
MCP (Model Context Protocol) explained: quickchat.ai/post/mcp-explained
The Quickchat AI MCP package on PyPI: pypi.org/project/quickchat-ai-mcp
The Quickchat AI MCP GitHub repo: github.com/quickchatai/quickchat-ai-mcp

Prerequisite

Install uv using:

curl -LsSf https://astral.sh/uv/install.sh | sh

or read more here.

Test with Claude Desktop

Configuration

Go to Settings > Developer > Edit Config. Open the claude_desktop_config.json file in a text editor. If you're just starting out, the file is going to look like this:

{
  "mcpServers": {}
}

This is where you can define all the MCPs your Claude Desktop has access to. Here is how you add your Quickchat AI MCP:

{
  "mcpServers": {
    "< QUICKCHAT AI MCP NAME >": {
      "command": "uvx",
      "args": ["quickchat-ai-mcp"],
      "env": {
        "SCENARIO_ID": "< QUICKCHAT AI SCENARIO ID >",
        "API_KEY": "< QUICKCHAT AI API KEY >"
      }
    }
  }
}

Go to the Quickchat AI app > MCP > Integration to find the above snippet with the values of MCP Name, SCENARIO_ID and API_KEY filled out.

Test with Cursor

Configuration

Go to Settings > Cursor Settings > MCP > Add new global MCP server and include the Quickchat AI MCP snippet:

{
  "mcpServers": {
    "< QUICKCHAT AI MCP NAME >": {
      "command": "uvx",
      "args": ["quickchat-ai-mcp"],
      "env": {
        "SCENARIO_ID": "< QUICKCHAT AI SCENARIO ID >",
        "API_KEY": "< QUICKCHAT AI API KEY >"
      }
    }
  }
}

As before, you can find values for MCP Name, SCENARIO_ID and API_KEY at Quickchat AI app > MCP > Integration.

Test with other AI apps

Other AI apps will most likely require the same configuration but the actual steps to include it in the App itself will be different. We will be expanding this README as we go along.

Launch your Quickchat AI MCP to the world!

⛔️ Do not publish your Quickchat API key to your users!

Once you're ready to let other users connect your Quickchat AI MCP to their AI apps, share configuration snippet with them! However, you need to make sure they can use your Quickchat AI MCP without your Quickchat API key. Here is how to do that:

On the Quickchat App MCP page, turn the Require API key toggle OFF.
Share the configuration snippet without the API key:

{
  "mcpServers": {
    "< QUICKCHAT AI MCP NAME >": {
      "command": "uvx",
      "args": ["quickchat-ai-mcp"],
      "env": {
        "SCENARIO_ID": "< QUICKCHAT AI SCENARIO ID >"
      }
    }
  }
}

Cool features

You can control all aspects of your MCP from the Quickchat AI dashboard. One click and your change is deployed. That includes the MCP name and description - all your users need to do is refresh their MCP connection.
View all conversations in the Quickchat Inbox. Remember: those won't be the exact messages your users send to their AI app but rather the transcript of the AI <> AI interaction between their AI app and your Quickchat AI. 🤯
Unlike most MCP implementations, this isn't a static tool handed to an AI. It's an open-ended way to send messages to Quickchat AI Agents you create. 🙌

Running from source

Debugging with the MCP inspector

uv run mcp dev src/__main__.py

Debugging with Claude Desktop, Cursor or other AI apps

Use the following JSON configuration:

{
  "mcpServers": {
    "< QUICKCHAT AI MCP NAME >": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "requests",
        "mcp",
        "run",
        "< YOUR PATH>/quickchat-ai-mcp/src/__main__.py"
      ],
      "env": {
        "SCENARIO_ID": "< QUICKCHAT AI SCENARIO ID >",
        "API_KEY": "< QUICKCHAT AI API KEY >"
      }
    }
  }
}

Testing

Make sure your code is properly formatted and all tests are passing:

ruff check --fix
ruff format
uv run pytest

GitHub Star History

{ "mcpServers": { "quickchat-ai-mcp": { "command": "uvx", "args": [ "quickchat-ai-mcp" ], "env": { "SCENARIO_ID": "<YOUR_SCENARIO_ID>", "API_KEY": "<YOUR_API_KEY>" } } } }

Quickchat AI MCP Server