Connects GPT-4 to a merchant store API, allowing AI to query and update store data for a specific merchant, including listing stores, searching for relevant stores, and adding new stores with descriptions and tags.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@AI_SYNC MCP Servershow me all stores for Tnc_Store"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
AI_SYNC Tooling with OpenAI + MCP
This project connects GPT-4 to a backend merchant store API using the Model Context Protocol (MCP). It allows querying and updating store data under a specific merchant class.
⚠️ Note: The server is currently hardcoded to work with the
Tnc_Storemerchant ID. Only data under this class is accessible to the AI.
⚙️ Setup Instructions
1. Clone the Repository
git clone https://github.com/your-org/ai_sync
cd ai_sync2. Create a .env File
Inside the project root, create a .env file containing your OpenAI API key:
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx3. Set Up the Python Environment with uv
If you haven’t installed uv, do so with:
curl -Ls https://astral.sh/uv/install.sh | shThen set up and activate the virtual environment:
uv venv .venv
source .venv/bin/activateThis will automatically install dependencies based on the uv.lock file.
4. Start the Merchant API Server
Ensure the backend server (AI_SYNC) is running locally on:
http://localhost:4001Required POST endpoints:
/MerchantStore/findAllStores/MerchantStore/findStore/MerchantStore/addNewStore
5. Run the Tooling System
To launch the client and tool server together:
uv run client.py server.pyserver.pyprovides tool definitions via MCPclient.pyconnects to GPT-4 and routes user queries
Related MCP server: Shopify MCP Server
💬 Example Queries
Query: Show me all the stores for this merchant
Query: I want to add a new store, CGV Cinemas - Vincom Nguyễn Chí Thanh, Hà Nội, with keywords: CGV, rạp chiếu phim, Hà Nội, Vincom, giải trí⚠️ For multiline input, paste it as a single line. Shift+Enter will submit prematurely in most terminals.
📁 Basic Project Structure
ai_sync/
├── client.py # MCP + OpenAI chat client
├── server.py # Tool server using FastMCP
├── .env # OpenAI API key
├── uv.lock # Dependency lock file (used by uv)✅ Available Tools
Tool Name | Description |
| List all stores for |
| Natural language search for relevant stores |
| Add a store with full description and tags |
🔒 Notes
Only data for
Tnc_Storeis accessibleRequires OpenAI GPT-4 (
gpt-4o) and a functioning backend APIRuns entirely locally using standard input/output