Frequently Asked Questions about UBOS MCP Server for Shopify

Q: What is an MCP Server? A: MCP (Model Context Protocol) is an open protocol that standardizes how applications provide context to Large Language Models (LLMs). An MCP server acts as a bridge, allowing AI models to access and interact with external data sources and tools.

Q: What does the UBOS MCP Server for Shopify do? A: It allows AI agents to seamlessly interact with your Shopify store data (products, customers, orders, etc.) via GraphQL, enabling automation and insights.

Q: What are the prerequisites for using the MCP Server? A: You’ll need Node.js (v16+), a Shopify Custom App with Admin API access, and the access token for that app.

Q: How do I install the MCP Server? A: Clone the repository, navigate to the directory, and run npm install followed by npm run build.

Q: How do I configure the Shopify Custom App? A: In your Shopify admin, go to Settings > Apps and sales channels > Develop apps > Create an app. Configure read/write permissions for products, customers, and orders. Install the app and copy the Admin API access token.

Q: How do I configure the .env file? A: Create a .env file in the project root and add your Shopify access token and domain in the following format:

SHOPIFY_ACCESS_TOKEN=your_access_token MYSHOPIFY_DOMAIN=your-store.myshopify.com

Q: What are some common debugging issues? A: Check for authentication problems (token, domain format, API scopes) and API errors (rate limits, input formats, required fields).

Q: Can I use this with Claude Desktop? A: Yes, the documentation provides configuration instructions for integrating this MCP Server with Claude Desktop, including setting the correct path and storing your token securely.

Q: What kind of tools are available for product management? A: Tools like findProducts, listProductsInCollection, and getProductsByIds are available to retrieve and manage product information.

Q: What can I do with customer management tools? A: You can use listCustomers to retrieve customer data and addCustomerTags to segment customers for targeted marketing.

Q: What order management tools are included? A: Tools include findOrders, getOrderById, createDraftOrder, and completeDraftOrder for managing orders.

Q: Can I manage discounts with this MCP Server? A: Yes, you can use the createDiscountCode tool to create various types of discounts.

Q: What about collection management? A: The listCollections tool allows you to list all collections in your Shopify store.

Q: What kind of shop information can I retrieve? A: You can retrieve basic shop details using getShopDetails and extended shop details using getExtendedShopDetails.

Q: How can I manage webhooks? A: Use the manageWebhooks tool to subscribe to, find, or unsubscribe from webhooks.

**Q: Is there any tools for developers? A: Yes, introspect_admin_schema and search_dev_docs are provided to help developers.

Q: Where can I check Claude Desktop MCP logs? A: Check the logs using tail -n 20 -f ~/Library/Logs/Claude/mcp*.log (macOS).