Shopify MCP Server for Claude

Claude 向け Python Shopify MCP サーバー

Shopify ストアのデータを Claude AI がシームレスに利用できるようにする、Model Context Protocol（MCP）サーバーの Python 実装です。この連携により、Claude は商品カタログ、顧客情報、注文の詳細にアクセスし、eコマース業務において、よりインテリジェントで状況に応じたサポートを提供できます。

🌟 機能

• Claude とのシームレスな連携

  • Claude との会話中に Shopify ストアのデータへ直接アクセスできます
  • データをコピーして貼り付けたり、アプリケーションを切り替えたりする必要はありません
  • Claude はストア情報を分析し、推論できます

• 商品への完全なアクセス

  • 商品カタログ全体を検索できます
  • 詳細な商品情報、バリエーション、在庫にアクセスできます
  • 商品名、販売元、商品タイプで商品を検索できます

• 顧客インサイト

  • 顧客プロフィールと購入履歴を取得できます
  • 連絡先情報と配送先住所にアクセスできます
  • 支出パターンと注文頻度を確認できます

• 注文管理

  • 注文の詳細、明細、フルフィルメント状況にアクセスできます
  • 支払い情報と配送の詳細を確認できます
  • 注文の指標とパターンを分析できます

• ストア情報

  • Shopify ストアのメタデータにアクセスできます
  • 通貨、ロケール、タイムゾーンの設定を確認できます
  • ストアオーナーと事業の詳細を取得できます

📋 前提条件

• Python 3.10 以降（Python 3.12 を推奨）
• Admin API のアクセス認証情報を持つ Shopify ストア
• Claude Desktop がインストールされていること
• ターミナルコマンドの基本的な知識

🚀 クイックスタート

1. リポジトリをクローンする

git clone https://github.com/yourusername/shopify-mcp-server.git
cd shopify-mcp-server

2. Python 環境をセットアップする

仮想環境を作成して有効化します。

# Create virtual environment
python -m venv .venv-py312

# Activate on macOS/Linux
source .venv-py312/bin/activate

# Activate on Windows
.venv-py312\Scripts\activate

3. 依存関係をインストールする

pip install ShopifyAPI fastmcp python-dotenv

4. Shopify の認証情報を設定する

プロジェクトのルートに .env ファイルを作成します。

SHOPIFY_SHOP_URL=your-store.myshopify.com
SHOPIFY_ACCESS_TOKEN=your_access_token_here

または、API キー認証を使用します。

SHOPIFY_SHOP_URL=your-store.myshopify.com
SHOPIFY_API_KEY=your_api_key_here
SHOPIFY_PASSWORD=your_private_app_password_here

より安全に設定するには、セットアップスクリプトを使用する方法もあります。

chmod +x setup_credentials.sh
./setup_credentials.sh

5. 設定をテストする

次のコマンドを実行して、セットアップを確認します。

chmod +x test_env.sh
./test_env.sh

6. サーバーを実行可能にする

chmod +x claude_server.sh

🔧 Claude Desktop の設定

Shopify MCP サーバーを Claude Desktop に追加するには、次の手順に従います。

1. Claude Desktop を開き、設定アイコンをクリックします

2. MCP 設定セクションで、次の設定を使用して新しいサーバーを追加します。

   • Name：Shopify Store
   • Command：/full/path/to/shopify-mcp-server/claude_server.sh
   • Working Directory：/full/path/to/shopify-mcp-server

   /full/path/to/ を実際のファイルパスに置き換えてください。

3. 設定を保存し、Claude Desktop を再起動します

4. Claude が Shopify ストアのデータにアクセスできるようになります！

🧠 Claude で Shopify ツールを使う

設定が完了したら、会話の中で Claude に Shopify ツールの使用を依頼できます。以下に例を示します。

• 「ストアで人気の商品を上位 5 件表示して」
• 「100 ドル以上使った顧客をすべて見つけて」
• 「販売元 X が製造した商品を検索して」
• 「最近の注文の詳細を教えて」
• 「カタログ内の商品の平均価格はいくら？」

Claude は MCP サーバーを通じて Shopify のデータにアクセスし、実際のストア情報に基づいた有益な回答を提供します。

🔒 セキュリティのベストプラクティス

• 認証情報の保護：API 認証情報は、ファイル権限を制限して（600）保存します
• 読み取り専用アクセス：MCP サーバーはデータを取得するだけで、ストアを変更することはできません
• 最小限のアクセス：必要最小限の権限で Shopify API アクセスを設定します
• ローカルのみ：セキュリティを最大限に高めるため、サーバーはお使いのマシン上でローカルに実行されます
• 認証情報のローテーション：API キーとトークンを定期的にローテーションします

❓ トラブルシューティング

Shopify MCP サーバーで問題が発生した場合は、次の手順を確認してください。

1. 認証情報を確認する

   • .env ファイル内のShopify API認証情報が正しいことを確認してください
   • ショップのURLが正しい形式であることを確認してください（例：your-store.myshopify.com）

2. Claude Desktopの設定を確認する

   • Claude Desktopの設定にあるパスが絶対パスで、正しいことを確認してください
   • 作業ディレクトリが適切に設定されていることを確認してください
   • 設定を変更した後は、Claude Desktopを再起動してください

3. サーバーの実行状態を確認する

   • claude_server.sh に実行権限があることを確認してください
   • 権限の問題が発生した場合は、chmod +x claude_server.sh を実行してください

より詳しいセットアップ情報については、CLAUDE_SETUP.md ファイルを参照してください。

📚 利用可能なMCPツール

Shopify MCP サーバーは、Claudeに次の機能を提供します。

ツール	説明
get_products	Shopifyストアの商品一覧を取得します
get_product_details	特定の商品に関する詳細情報を取得します
get_customers	ストアの顧客一覧を取得します
get_customer_details	特定の顧客に関する詳細情報を取得します
get_orders	ストアの注文一覧を取得します
search_products	商品名、種類、または販売元で商品を検索します
get_store_info	Shopifyストアに関する情報を取得します

🏗️ プロジェクト構成

• shopify_mcp_fastmcp.py - FastMCPを使用したPython製MCPサーバーのメイン実装
• claude_server.sh - Claude向けにPython製MCPサーバーを起動するBashスクリプト
• setup_credentials.sh - 認証情報を安全に設定するためのヘルパースクリプト
• test_env.sh - 環境設定を検証する診断ツール
• .env.example - 環境変数ファイルのサンプル
• CLAUDE_SETUP.md - Claude Desktopの詳細なセットアップ手順

🧪 技術スタック

• Python：中核となる実装言語（3.10以降に対応、3.12を推奨）
• FastMCP：MCPを効率的に実装するためのPythonライブラリ
• Shopify API：Shopify API連携用の公式Pythonクライアント
• Python-dotenv：環境変数を安全に管理するためのツール

🌐 詳細情報

• Model Context Protocolのドキュメント
• Claude Desktopのドキュメント
• Shopify APIのドキュメント
• FastMCP Pythonライブラリ

📄 ライセンス

MITライセンス

🤝 コントリビューション

コントリビューションを歓迎します。お気軽にプルリクエストを送信してください。

1. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add some amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します

📬 お問い合わせ

ご質問がある場合やセットアップのサポートが必要な場合は、GitHubリポジトリでIssueを作成してください。

---

ClaudeとShopifyの愛好家のために❤️を込めて作成