接入你的智能体
從發布者安裝。不是 PlugMCP 端點。
遠端 URL 還是本機指令? 兩種安裝方式的差異
Free, open-source MCP server that connects Claude to the Shopify Partner API. 25 tools for revenue analytics, churn analysis, retention cohorts, merchant health scoring, conversion funnels, revenue forecasting, and growth velocity.
Query your app business in natural language. No dashboards, no monthly fees.
Shopify's own AI Toolkit and official MCP servers (Dev MCP, Storefront MCP, Customer Account MCP, Checkout MCP) all target the Admin API and Storefront API, which cover store operations and shopping experiences. Every third-party Shopify MCP server on GitHub does the same.
None of them connect to the Partner API. If you build Shopify apps, your revenue metrics, churn data, and merchant analytics are locked behind the Partner Dashboard with no MCP-compatible way to query them.
Shopify Partner Agent is the only MCP server that gives AI tools access to Partner API analytics: MRR, churn, retention cohorts, merchant health, and 20 more computed metrics that even the raw API doesn't provide.
Ask Claude things like:
Before you start, you need:
You need three values. Log in to the Partners Dashboard first, then collect each one below.
SHOPIFY_ORG_ID
The number in your Dashboard URL. Once you are logged in, look at the address bar:
https://partners.shopify.com/1234567/...
^^^^^^^ this is your org ID
SHOPIFY_ACCESS_TOKEN
SHOPIFY_APP_IDS
One entry per app you want to query, comma-separated.
/apps/9876543.gid://partners/App/9876543. Bare numeric IDs also work.gid://partners/App/1,gid://partners/App/2.Your MCP client will install and run the server automatically the first time it launches. You don't need to download, clone, or set up anything yourself.
The config you paste below tells your MCP client to run a command called uvx. On first launch, uvx fetches the server from the Python package registry (PyPI) and stores it in a local folder on your computer. After that, startup is instant.
Where the files sit:
~/.cache/uv/%LOCALAPPDATA%\uv\cache\The installed package contains only the server code. It does not include your credentials, any test files, or anything else from your machine. The source is public on PyPI and GitHub, so you can audit exactly what runs.
Remove the installed copy later:
uv cache clean shopify-partner-agent
Update to the latest release: run the command above, then restart your MCP client. It fetches the newest version on the next launch.
Prefer a traditional install you can see on disk? Use the pip install option further down, or git clone the repo and run uv sync.
Claude Desktop is the most common path. Paste the block below into claude_desktop_config.json and swap in the three values from step 1:
{
"mcpServers": {
"shopify-partner-agent": {
"command": "uvx",
"args": ["shopify-partner-agent"],
"env": {
"SHOPIFY_ORG_ID": "your_org_id",
"SHOPIFY_ACCESS_TOKEN": "your_token",
"SHOPIFY_APP_IDS": "gid://partners/App/1234567"
}
}
}
}
Config file location:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonIf the file does not exist yet, create it with the block above exactly as shown. If it already contains other MCP servers, add shopify-partner-agent inside the existing mcpServers object.
Using a different client? Open the matching section below.
One command from your terminal:
claude mcp add shopify-partner-agent uvx shopify-partner-agent \
-e SHOPIFY_ORG_ID=your_org_id \
-e SHOPIFY_ACCESS_TOKEN=your_token \
-e SHOPIFY_APP_IDS=gid://partners/App/1234567
Same JSON as Claude Desktop. Open the MCP settings panel and paste the block below.
~/.cursor/mcp.json directly.{
"mcpServers": {
"shopify-partner-agent": {
"command": "uvx",
"args": ["shopify-partner-agent"],
"env": {
"SHOPIFY_ORG_ID": "your_org_id",
"SHOPIFY_ACCESS_TOKEN": "your_token",
"SHOPIFY_APP_IDS": "gid://partners/App/1234567"
}
}
}
}
pip install shopify-partner-agent
Then update your MCP config to call the installed command directly instead of uvx:
{
"mcpServers": {
"shopify-partner-agent": {
"command": "shopify-partner-agent",
"env": {
"SHOPIFY_ORG_ID": "your_org_id",
"SHOPIFY_ACCESS_TOKEN": "your_token",
"SHOPIFY_APP_IDS": "gid://partners/App/1234567"
}
}
}
}
Open any LLM chat and paste the prompt below. It asks which client you use and generates the exact config file path and JSON for you.
I want to install the shopify-partner-agent MCP server. It is a Python package on PyPI that connects AI assistants to the Shopify Partner API for revenue, churn, cohort, and merchant analytics.
Walk me through setup step by step:
1. Ask which MCP client I use: Claude Desktop, Claude Code, Cursor, or Windsurf.
2. Explain how to create a Shopify Partner API access token: Partners Dashboard > Settings > Partner API clients > Create API client. Required scopes: "Manage apps" and "View financials". The token is shown only once, so I need to copy it.
3. Explain how to find my app GIDs. The format is gid://partners/App/1234567 and the numeric ID is visible in the Partners Dashboard URL when I open an app.
4. Generate the MCP config for the client I picked. Use the command "uvx" with args ["shopify-partner-agent"] and these placeholder env vars: SHOPIFY_ORG_ID=<my_org_id>, SHOPIFY_ACCESS_TOKEN=<my_token>, SHOPIFY_APP_IDS=<comma_separated_app_gids>.
5. Tell me the exact config file path for my client on macOS and Windows, and where in that file the mcpServers section goes.
6. Tell me to replace the placeholders on my own machine. Do NOT ask me to paste my real token into this chat.
7. Tell me to fully quit and relaunch the MCP client, then confirm the 25 shopify-partner-agent tools appear.
Reference: https://github.com/rushikeshmore/shopify-partner-agent
Package: https://pypi.org/project/shopify-partner-agent/
Keep your access token out of chat. Generate the config with placeholders, then fill in the real token locally.
Save the config, then fully quit and relaunch your MCP client. Most clients only read config at startup, so a window reload will not pick it up. After the client restarts, look for shopify-partner-agent in the tools or MCP menu. It should appear as connected with 25 tools. If something is off, see Troubleshooting.
> Show me my Shopify apps
> What's my churn rate this month?
> Who uninstalled recently and why?
> Give me a full health check of my app business
> Score my merchants by churn risk
missing required env vars: SHOPIFY_ORG_ID, ...
Credentials aren't reaching the server. Double-check the env block in your MCP client config above, then fully restart the client.
401 Unauthorized or token errors
The access token is wrong or missing scopes. Recreate it in Partners Dashboard with Manage apps + View financials and update your config.
App ID format errors
App IDs must be GIDs: gid://partners/App/1234567. Bare numeric IDs won't work. Copy the correct format from the Partners Dashboard URL when you open the app.
Tools don't show up in Claude Desktop, Cursor, or Windsurf Fully quit and relaunch the MCP client after editing config. Most clients only read config at startup.
uvx is stuck on an old version after a release
Clear the cache and retry: uv cache clean shopify-partner-agent.
All formulas match industry-standard SaaS metrics:
partners.shopify.com, it still works..env if running from source). It never leaves your machine except to authenticate with Shopify.src/shopify_partner_agent/.MIT. See LICENSE.
MCP server for Shopify Partner API analytics - 25 tools for MRR, churn, retention, merchant health, forecasting. Free and open source.
工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Shopify Partner Agent 透過 stdio 在本機執行。
上次檢查時間:2026-10-27。 MCP server for Shopify Partner API analytics - 25 tools for MRR, churn, retention, merchant health, forecasting. Free and open source.