Meu Ecommerce

Meu Ecommerce MCP

AI エージェントを、Meu Ecommerce のストアを通じてブラジルの Correios に接続するホスト型リモート MCP サーバーです。配送見積もり（frete）、追跡（rastreio）、配送ラベル（etiqueta）を、1 つの接続で利用できます。

https://app.meuecommerce.com.br/mcp

• トランスポート： Streamable HTTP
• 認証： OAuth（Authorization Code + PKCE S256、動的クライアント登録）またはストアのシークレットキー
• ドキュメント（ポルトガル語）： dev.meuecommerce.com.br/docs/mcp
• 掲載先： Official MCP Registry（io.github.meuecommerce/meuecommerce-mcp） · Glama · Smithery

このリポジトリには、サーバーの公開説明（server.json）、ロゴ、このガイドのみが含まれています。サーバーはホスト型サービスのため、インストールするものはありません。

ツール

ツール	機能
get_shipping_rates	配送先の CEP（郵便番号）に応じた Correios の配送見積もりを取得します
track_shipment	Correios の荷物の追跡イベントを返します
generate_label	Correios の発送前登録（pré-postagem）を作成し、ラベルを生成します
get_label_pdf	生成済みのラベルの PDF をダウンロードします
recover_label_pdf	新たに発行せず、supportCode で確定済みのラベル発行試行の PDF を取得します
diagnose_label_issue	読み取り専用：ストアのラベル発行試行、その証跡、推奨される次の手順を表示します
link_label_support_ticket	サポートチケットの参照情報をラベル発行試行に関連付けます（外部へのメッセージ送信はありません）
diagnose_quote_issue	読み取り専用：再見積もりせず、ストアに記録された見積もりを一覧表示します
diagnose_contract_issue	読み取り専用：契約を保存せず、Correios の契約設定手順を一覧表示します

ストアに接続すると（OAuth またはシークレットキー）、上記のすべてのツールが利用できます。ストアの要件はツールの呼び出し時に確認されます。見積もりにはストアの発送元 CEP、配送サービス、プランの設定が必要です。ラベルにはさらに、加盟店自身が認証した Correios の契約が必要です。診断ツールはストア自身の履歴のみを読み取るため、エージェントは失敗した操作を再試行する前に確認できます。

接続

• OAuth クライアント（推奨、例：Claude）： 上記の URL を使ってリモート MCP サーバーを追加し、ブラウザーでストアにログインして認証を完了します。
• ヘッダーに対応したクライアント： Streamable HTTP を使用し、ストアのシークレットキーを Authorization: Bearer mk_YOUR_KEY として送信します。シークレット管理ツールに保管し、プロンプト、リポジトリ、ブラウザーコードには絶対に含めないでください。

OAuth の検出は https://app.meuecommerce.com.br/.well-known/oauth-protected-resource/mcp から始まります。認証前の 401 は検出プロセスの一部です。

---

Português

Servidor MCP remoto que conecta agentes de IA à sua loja Meu Ecommerce: cotação de frete, rastreamento de objetos e etiquetas dos Correios, em uma única conexão.

ツール

ツール	内容	機能
get_shipping_rates	注文の配送先郵便番号に対する送料を見積もります	送料と見積もり
track_shipment	荷物の追跡イベントを照会します	追跡
generate_label	発送準備を作成し、ラベルを生成します	ラベルと発送
get_label_pdf	生成済みラベルの PDF をダウンロードします	ラベルと発送
recover_label_pdf	supportCode で確認済みの試行から PDF を復元します。新たに発行することはありません	ラベルと発送
diagnose_label_issue	読み取り専用：店舗の発行試行と推奨される対応を表示します	ラベルと発送
link_label_support_ticket	メッセージを送信せずに、問い合わせの参照情報を試行に関連付けます	ラベルと発送
diagnose_quote_issue	読み取り専用：再実行せずに、店舗に記録された見積もりを一覧表示します	送料と見積もり
diagnose_contract_issue	読み取り専用：保存せずに、Correios 契約の設定手順を一覧表示します	Correios 契約

店舗接続（OAuth またはシークレットキー）では、上記のすべてのツールが一覧表示されます。店舗の要件は、ツールの呼び出し時に確認されます。

• 見積もり： 発送元の郵便番号、配送サービス、パネルで設定されたプランへのアクセス権。
• ラベル： これらに加えて、認証済みの独自の Correios 契約と、ラベル連携の有効化。

診断ツールは、店舗自身の履歴のみを読み取ります。失敗した操作を再実行する前に使用してください。

app.meuecommerce.com.br/start で店舗を設定してください。

接続

OAuth 対応クライアント（推奨）

1. クライアント（Claude など）のコネクターまたは MCP サーバーの画面を開きます。
2. URL https://app.meuecommerce.com.br/mcp を使用して、Meu Ecommerce という名前のリモートサーバーを追加します。
3. ブラウザーで店舗にログインし、認証を完了します。
4. クライアントに戻り、利用可能なツールを確認します。

ヘッダーに対応するクライアント

Streamable HTTP トランスポートを設定し、店舗のシークレットキーを送信します。

Authorization: Bearer mk_SUA_CHAVE

キーは環境のシークレット管理ツールに保管してください。プロンプト、リポジトリ、ブラウザーで実行されるコードには絶対に含めないでください。

最初のテスト

綿の T シャツ 1 枚（単価 R$ 89,90、単位重量 0,3 kg）の配送先郵便番号 20040-002 に対する送料を見積もってください。返されたサービス、料金、配送日数を表示してください。

完全ガイド：エージェントを接続する。

OAuth の検出

• 保護対象リソース：https://app.meuecommerce.com.br/.well-known/oauth-protected-resource/mcp
• 認可サーバー：https://app.meuecommerce.com.br/.well-known/oauth-authorization-server

認可前の 401 は検出処理の一部です。

---

ライセンス / Licença

このリポジトリのドキュメントとファイルは、MIT License の下で公開されています。サーバーのソースコードはここでは配布されていません。

このリポジトリのドキュメントとファイルは、MIT ライセンス の下で公開されています。サーバーのコードはここでは配布されていません。