Shopify

Integra com a API do Shopify para recuperar e manipular informações de produtos.

Documentação

Shopify Python MCP Server

Este é um servidor MCP que se integra com a API da Shopify. Usando este servidor, você pode obter e manipular informações de produtos da Shopify a partir do Claude Desktop.

Funcionalidades

Ferramentas

Este servidor fornece as seguintes ferramentas:

list_products: Obter uma lista de produtos
- limit: Número de produtos a obter (máximo 250, valor padrão é 50)
get_product: Obter informações detalhadas de um produto
- product_id: ID do produto (obrigatório)
create_product: Criar um novo produto
- title: Nome do produto (obrigatório)
- body_html: Descrição do produto (formato HTML)
- vendor: Nome do fornecedor
- product_type: Tipo do produto
- tags: Tags (separadas por vírgula)
- status: Status (active/draft/archived)
- variants: Variações
- options: Opções
- images: Imagens
update_product: Atualizar um produto
- product_id: ID do produto (obrigatório)
- title: Nome do produto
- body_html: Descrição do produto (formato HTML)
- vendor: Nome do fornecedor
- product_type: Tipo do produto
- tags: Tags (separadas por vírgula)
- status: Status (active/draft/archived)
- variants: Variações
- options: Opções
- images: Imagens
delete_product: Excluir um produto
- product_id: ID do produto (obrigatório)

Configuração

Variáveis de ambiente necessárias

Para usar este servidor, você precisa definir as seguintes variáveis de ambiente:

SHOPIFY_SHOP_URL: URL da loja Shopify (exemplo: mystore.myshopify.com)
SHOPIFY_API_KEY: Chave da API da Shopify Admin API
SHOPIFY_API_PASSWORD: Senha da API da Shopify Admin API (Secret)
SHOPIFY_API_VERSION: Versão da API da Shopify (padrão: 2023-10)

Configuração no Claude Desktop

Para usar no Claude Desktop, adicione a seguinte configuração ao claude_desktop_config.json:

macOS

Localização do arquivo de configuração: ~/Library/Application Support/Claude/claude_desktop_config.json

"mcpServers": {
  "shopify-py-mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "/your_path/shopify-py-mcp",
      "run",
      "shopify-py-mcp"
    ],
    "env": {
      "SHOPIFY_SHOP_URL": "your-store.myshopify.com",
      "SHOPIFY_API_KEY": "your-api-key",
      "SHOPIFY_API_PASSWORD": "your-api-password",
      "SHOPIFY_API_VERSION": "2023-10"
    }
  }
}

Como usar

Para usar este servidor no Claude Desktop, chame as ferramentas da seguinte forma:

Obter lista de produtos

商品一覧を取得してください。

Obter detalhes de um produto

商品ID 1234567890の詳細情報を取得してください。

Criar um novo produto

以下の情報で新しい商品を作成してください：
- 商品名: サンプル商品
- 説明: これはサンプル商品です。
- 価格: 1000円

Atualizar um produto

商品ID 1234567890を以下の情報で更新してください：
- 商品名: 更新後の商品名
- 価格: 2000円

Excluir um produto

商品ID 1234567890を削除してください。

Desenvolvimento

Instalação das dependências

cd shopify-py-mcp
uv sync --dev --all-extras

Depuração

Você pode depurar usando o MCP Inspector:

npx @modelcontextprotocol/inspector uv --directory /your_path/shopify-py-mcp run shopify-py-mcp

Build e publicação

Para preparar o pacote para distribuição:

Sincronize as dependências e atualize o arquivo de lock:

uv sync

Faça o build do pacote:

uv build

Publique no PyPI:

uv publish

Observação: Você precisa configurar as credenciais do PyPI via variáveis de ambiente ou flags de comando:

Token: --token ou UV_PUBLISH_TOKEN
Ou nome de usuário/senha: --username/UV_PUBLISH_USERNAME e --password/UV_PUBLISH_PASSWORD