Continente MCP

Continente MCP

AI アシスタントがContinente.ptで買い物をできるようにするMCPサーバーです。商品の検索、価格やセール条件の確認、お気に入りや過去の注文の参照、カートへの追加ができます。注文手続きと支払いは常にウェブサイト上で行います。

非公式です。 このプロジェクトは Continente または MC Sonae と提携、承認、支援を受けていません。ヘッドレスブラウザーで公開ウェブサイトを自動操作するため、サイトの変更により動作しなくなる可能性があります。また、ウェブサイトの利用規約に従ってご使用ください。カートに追加したものについては、お客様ご自身が責任を負います。

機能

• カタログ検索と商品詳細：重量販売商品や量り売り商品の正確な価格、単価、在庫状況、セール条件を確認できます。
• 安全なカート変更。 変更のたびにカートを読み直して確認します。変更を確認できない場合は、その旨を結果に表示し、再試行するのではなくカートを確認するようアシスタントに伝えます。
• アカウント情報：お気に入り、注文履歴、購入頻度の高い商品のランキングを利用できます。
• stdio 経由でローカル実行します。認証情報とセッションはお使いのコンピューターに保存され、Continente.pt にのみ送信されます。
• 組み込みのガイダンス。 サーバーは接続時にカートのルールをアシスタントに伝え、買い物のワークフロー全体をまとめた basket-planner プロンプトを提供します。追加のインストールは不要です。同じガイドはスキルとしても提供されています。

必要条件

• アカウント機能の利用には Continente.pt のアカウントが必要です（検索と商品詳細の確認はアカウントなしで利用できます）。
• ワンクリックインストールには macOS または Windows の Claude Desktop、それ以外の MCP クライアントには Node.js 22 以降が必要です。

サーバーは Chromium を使ってウェブサイトを操作します。必要になった初回に自動でダウンロードします（約 150 MB、1 回のみ）。

Claude Desktop にインストール（ワンクリック）

1. 最新リリースからcontinente-mcp.mcpbをダウンロードします。
2. ファイルを開きます。Claude Desktop にインストール画面が表示されたら、Install をクリックします。
3. 求められたら Continente のメールアドレスとパスワードを入力します。Claude Desktop はパスワードを安全な設定ストレージに保存します。

これで完了です。サーバーはMCP Registryにも io.github.andredelgado/continente-mcp として登録されているため、レジストリを参照するクライアントから見つけることができます。Claude Desktop にパスワードを保存せず、代わりに 1Password を使う場合は、以下の手動セットアップを行ってください。

更新

サーバーは 1 日に 1 回 npm を確認し、新しいリリースがあるか調べます。新しいリリースがある場合はアシスタントに通知するため、Claude から案内できます。また、get_session_status にも表示されます。

• 拡張機能： 新しい continente-mcp.mcpb をダウンロードして開きます。Claude Desktop はメールアドレスとパスワードを保持したまま、拡張機能をその場で更新します。
• npx のセットアップ： continentept-mcp@latest を使用すると、クライアントの再起動時に新しいバージョンが適用されます。
• リリースメール： GitHubで、Watch → Custom → Releases を選択します。

手動セットアップ（任意の MCP クライアント）

1. 認証情報を ~/.continentept-mcp/credentials.env に保存します（ほかの方法については 設定をご覧ください）。

mkdir -p ~/.continentept-mcp && chmod 700 ~/.continentept-mcp
printf '[email protected]\nCONTINENTE_PASSWORD=your-password\n' > ~/.continentept-mcp/credentials.env
chmod 600 ~/.continentept-mcp/credentials.env

1Password をお使いですか？ ファイルは使わず、代わりに op run でシークレット参照を渡してください。詳しくは 1Password の使用をご覧ください。

必要に応じて、ログインできることを確認します。

npx -y continentept-mcp login

2. MCP クライアントにサーバーを追加します。

Claude Code：

claude mcp add continente -- npx -y continentept-mcp

Claude Desktop、Cursor などのクライアント（claude_desktop_config.json、mcp.json、...）：

{
  "mcpServers": {
    "continente": {
      "command": "npx",
      "args": ["-y", "continentept-mcp"]
    }
  }
}

認証情報ファイルを別の場所に置く場合は、 "env": { "CONTINENTE_CREDENTIALS_FILE": "/absolute/path/to/credentials.env" } を追加します。

Chromium は初回使用時に自動でダウンロードされます。事前に取得するには、 npx -y continentept-mcp install-browser を実行します（Linux では、必要なシステムライブラリもインストールするために --with-deps を追加してください）。

その後、アシスタントに 「低脂肪乳と卵を1ダース、Continente のカートに追加して」 や 「普段は何を買っている？ 今週分のリストを作って」 などと頼んでください。

ツール

ツール	機能
search_products	カタログを関連度順に検索します。お気に入りをマークし、続きを取得するためのカーソルを返します
get_product	1つの商品について、価格、容量、在庫状況、セール条件を取得します
get_product_labels	ラベルに記載された原材料、アレルゲン、栄養情報を取得します
choose_products	クライアントが対応している場合は写真を表示し、ユーザーが商品を選べるようにします
list_favorites	保存済みのお気に入りを一覧表示します（refresh: true を指定すると最新情報を取得します）
get_cart	カートの商品、数量、袋、合計金額を取得します
preview_cart_changes	カートを変更せずに、変更内容と費用を確認します
add_cart_item	カート内の数量に追加します
set_cart_item_quantity	カート内の数量を指定した数量に設定します。ゼロにすると削除されます
remove_cart_item	カートから商品を削除します
clear_cart	確認を1回行って、カート全体を空にします
list_orders	商品の明細を含む最近の注文を一覧表示します
get_order	1件の注文の商品明細を取得します
list_frequently_bought_products	注文頻度の高い順に商品を表示します
get_session_status	ローカルのログイン、Cookie、キャッシュの状態を取得します（ネットワーク通信なし）

入力、出力、エラーコード、制限については、ツールリファレンスをご覧ください。

不確実なカート変更について

たとえばタイムアウトなどにより、リクエストがウェブサイトに到達した後にカートの変更が失敗することがあります。 その場合、結果には mutation.outcome: "unknown" が含まれ、クライアントに対して、ほかの操作を行う前に get_cart を呼び出すよう求めます。サーバーはこのような変更を独自に再試行することはなく、 クライアントも再試行しないでください。add_cart_item を繰り返すと、商品が二重に追加される可能性があります。

アシスタント向けガイダンス

クライアントが接続すると、サーバーはカートのルールに関する簡潔な指示を送信するため、 セットアップなしでアシスタントがそのルールに従います。買い物リストを作成する場合は、 クライアントのプロンプトまたは添付ファイルのメニューから basket-planner プロンプトを選択してください。 必要に応じて、「2人分の今週の買い物リスト」のようなリクエストも添えられます。

同じガイドは skills/basket-planner のスキルとしても利用できます。Claude Desktop（設定 → 機能 → スキル）や Claude Code（~/.claude/skills/）など、 スキルに対応するクライアントでは、食料品について尋ねるたびに自動で適用されます。

コマンドライン

continentept-mcp                    Start the MCP server on stdio
continentept-mcp login              Sign in and save the session (--show-browser to watch)
continentept-mcp install-browser    Download Chromium now instead of on first use (extra arguments go to Playwright)
continentept-mcp --version

制限事項

• サーバープロセスごとに使用できるアカウントは1つです。
• 検索では最大5ページ、注文一覧では最大10ページまで読み取ります。そのため、範囲が広すぎる検索や長い注文履歴は、すべてを読み取らず、不完全であることが示されます。
• ログインでは、標準的なメールアドレスとパスワードによるフローに対応しています。ウェブサイトで追加の認証を求められた場合は、continentept-mcp login --show-browser を実行して、ブラウザーウィンドウで認証を完了してください。
• 注文確定、支払い、配送枠、お気に入りの編集を行うツールはありません。

ドキュメント

• ツールリファレンス
• 安定性：1.0 以降の破壊的変更に該当する内容
• 設定
• トラブルシューティング
• コントリビューション
• セキュリティポリシー
• 変更履歴

ライセンス

MIT