プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説 ログイン

CartAI MCP Server

✓ 提供元 · cartai.ai

作者:TheCartAIバージョン 1.0.2i★ 1iパソコンで動く公式サイト ↗
レジストリ名ai.cartai/cartai-mcp-server

インストール方法

できること

Agentic checkout with or without a human in the loop, product catalog, and an agent wallet.

作者による原文

  • 接続方法 パソコンで動く
  • アカウントまたはキー CARTAI_API_KEY が必要
  • カテゴリ ネットショップ・決済

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気4/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア16/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

CartAI MCP Server をインストールして。https://mcp.popnx.com/i/cartai-mcp-server.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月21日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

CartAI MCP Server のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

AI にインストールしてもらう

このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude に MCP server CartAI MCP Server を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "cartai": { "command": "npx", "args": [ "-y", "cartai-mcp-server" ], "env": { "CARTAI_API_KEY": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) CARTAI_API_KEY は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、CartAI MCP Server のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. CartAI MCP Server に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    CartAI MCP Server のサイトを開く ↗

  3. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

  4. この設定を貼り付けて保存

    {
      "mcpServers": {
        "cartai": {
          "command": "npx",
          "args": [
            "-y",
            "cartai-mcp-server"
          ],
          "env": {
            "CARTAI_API_KEY": "your-value"
          }
        }
      }
    }

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  5. Claude を終了してもう一度開く

  6. 試してみる

    CartAI MCP Server を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が CartAI MCP Server を使っていると言うか、回答に CartAI MCP Server のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ CartAI MCP Server につなげません

CartAI MCP Server はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · CartAI MCP Server につなげるアプリを使う

  • CartAI MCP Server のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • CartAI MCP Server のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)
  • CartAI MCP Server のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)
  • CartAI MCP Server のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)

B · ネットショップ・決済 の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

CartAI MCP Server のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude Code に MCP server CartAI MCP Server を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user cartai --env CARTAI_API_KEY=your-value -- npx -y cartai-mcp-server 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) CARTAI_API_KEY は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、CartAI MCP Server のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. CartAI MCP Server に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    CartAI MCP Server のサイトを開く ↗

  3. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  4. このコマンドを貼り付けて Enter

    claude mcp add --scope user cartai --env CARTAI_API_KEY=your-value -- npx -y cartai-mcp-server

    Enter の前に「your-value」を自分のキーに書き換えてください

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  5. Claude Code で /mcp と入力

    CartAI MCP Server が一覧にあり、接続済みと表示されれば OK です

  6. 試してみる

    CartAI MCP Server を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が CartAI MCP Server を使っていると言うか、回答に CartAI MCP Server のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

CartAI MCP Server のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Cursor に MCP server CartAI MCP Server を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "cartai": { "command": "npx", "args": [ "-y", "cartai-mcp-server" ], "env": { "CARTAI_API_KEY": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) CARTAI_API_KEY は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、CartAI MCP Server のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. CartAI MCP Server に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    CartAI MCP Server のサイトを開く ↗

  3. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  4. キーを入力

    CartAI MCP Server の設定で CARTAI_API_KEY が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  5. Cursor の AI チャットを Agent モードで開く

  6. 試してみる

    CartAI MCP Server を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が CartAI MCP Server を使っていると言うか、回答に CartAI MCP Server のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

CartAI MCP Server のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの VS Code に MCP server CartAI MCP Server を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "cartai": { "type": "stdio", "command": "npx", "args": [ "-y", "cartai-mcp-server" ], "env": { "CARTAI_API_KEY": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) CARTAI_API_KEY は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、CartAI MCP Server のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. CartAI MCP Server に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    CartAI MCP Server のサイトを開く ↗

  3. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  4. キーを入力

    CartAI MCP Server の設定で CARTAI_API_KEY が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  5. VS Code の AI チャットを Agent モードで開く

  6. 試してみる

    CartAI MCP Server を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が CartAI MCP Server を使っていると言うか、回答に CartAI MCP Server のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?CartAI MCP Server を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

パソコンにインストール

Claude Code

claude mcp add --scope user cartai --env CARTAI_API_KEY=your-value -- npx -y cartai-mcp-server

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "cartai": {
      "command": "npx",
      "args": [
        "-y",
        "cartai-mcp-server"
      ],
      "env": {
        "CARTAI_API_KEY": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "cartai": {
      "command": "npx",
      "args": [
        "-y",
        "cartai-mcp-server"
      ],
      "env": {
        "CARTAI_API_KEY": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "cartai": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "cartai-mcp-server"
      ],
      "env": {
        "CARTAI_API_KEY": "your-value"
      }
    }
  }
}

自分で入力する値

  • CARTAI_API_KEY 秘密 必須 env
    CartAI ポータルで取得する CartAI API キー。
    英語の原文を見るCartAI API key from the CartAI portal

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
npm/PyPIにない
確認済みドメイン
✓ cartai.ai
接続方法
パソコンで動く
最新バージョンi
1.0.2
レジストリ公開日i
2026年11月21日
コードの最終更新i
2026年11月21日
作者
TheCartAI
パッケージ
npm: cartai-mcp-server
ウェブサイト
www.cartai.ai
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月21日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名はドメイン cartai.ai で確認済みです(レジストリがドメインの所有を確認しています)

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:今日

  • ✓ 合格

    ライセンスがある

    Apache-2.0を使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

まだ確認していません

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/cartai-mcp-server.svg)](https://mcp.popnx.com/en/servers/cartai-mcp-server)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

ネットショップ・決済のほかのサーバーとの比較i

  • このカテゴリのほかの3027件のうち90%よりスターが多い
  • このカテゴリのほかの3027件のうち99%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの3027件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

CartAI MCP Serverは安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

入力が必要なもの:CARTAI_API_KEY

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は今日、最新バージョン(1.0.2)がレジストリに届いたのは今日です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは?

同じカテゴリには:Stripe MCP, flightclaw, Trade It, Marketplace Ad Pros: Amazon Ads & Seller Central, idealo MCP Server

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

Stripe MCP

MCP server integrating with Stripe - tools for customers, products, payments, and more.

作者:stripe広く使われている★ 207513 か月前更新

クラウドで動く✓ 提供元 · stripe.com

flightclaw

Search ~300 airlines and book flights with a checkout link. OAuth sign-in by email code.

作者:flightclaw成長中★ 872 か月前更新

クラウドで動く✓ 提供元 · flightclaw.com

Trade It

Connect brokerage accounts to AI assistants: holdings, orders, asset lookup, and approved trading.

作者:trade-it-inc成長中★ 6236 日前更新

クラウドで動く✓ 提供元 · tradeit.app

idealo MCP Server

Search products, compare prices and discover deals across 6 European markets with your AI assistant.

作者:idealo初期★ 286 か月前更新

クラウドで動く✓ 提供元 · mcp.idealo.com
似たものと比べる
これ
CartAI MCP Server
Stripe MCPflightclawTrade ItMarketplace Ad Pros: Amazon Ads & Seller Centralidealo MCP Server
動く場所パソコンにインストールが必要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要はいいいえいいえいいえいいえいいえ
Claude で + から追加いいえはいいいえいいえいいえいいえ
基本チェック3/34/44/45/54/44/4
ライセンスApache-2.0MITMITCC0-1.0MITMIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

CartAI MCP Server

CartAI Powered MCP Server for autonomous product discovery, agentic payments, and checkout.

Sign up and try it on the CartAI Portal →

An MCP (Model Context Protocol) server that exposes the CartAI Catalog, Payments, Credentials, and Checkout APIs as tools inside Claude Desktop, Claude Code, Cursor, or any MCP-compatible AI host. Powered entirely by CartAI — search for products, fetch detailed variant and pricing info, get pre-checkout shipping and tax estimates, get a customer's card authorized for agentic payments, securely store merchant logins, and execute the entire checkout autonomously — from product URLs or just product names — asynchronously, with full status tracking and interactive MFA support.


Table of Contents

  • What is MCP?
  • What this server does
  • Prerequisites
  • Installation
  • Configuration
  • Claude Desktop
  • Cursor
  • VS Code
  • MCP Inspector
  • Tools
  • Checkout
  • Catalog
  • Payments
  • Credentials
  • Example prompts
  • How it works
  • Environment variables
  • Troubleshooting
  • Resources & Support
  • License

What is MCP?

Model Context Protocol is an open standard that lets AI assistants call external tools — APIs, databases, file systems — through a common interface. Think of it like a USB-C port for AI: one standard, any device. This server plugs CartAI's checkout capability into that port.


What this server does

ToolDescription
create_checkoutStart an async checkout for one or more product URLs
create_search_checkoutStart an async checkout from product names on a given merchant — no URLs needed
get_checkoutFetch the current state of a checkout task
cancel_checkoutCancel an in-progress checkout
get_status_historyGet the full step-by-step event log for a task
send_interactive_inputsSend an MFA/OTP code to a checkout task that is waiting for it
search_productsDiscover products by name across merchants
get_product_detailsRetrieve detailed info, variants, and pricing for a product URL
get_checkout_estimatesCompute pre-checkout shipping and tax estimates before placing an order
create_payment_sessionCreate a hosted payment session URL for the customer to authorize their card
delete_payment_sessionInvalidate a payment session
get_payment_credentialsRetrieve a scoped payment credential for an authorized payment session
create_credential_sessionCreate a secure vault URL where the customer stores their merchant login

Under the hood every tool maps 1-to-1 to a CartAI REST endpoint — the MCP server is a thin, type-safe bridge with no additional logic.


Prerequisites

RequirementVersion / Notes
Node.js>= 18.0.0 (uses native fetch and ES modules)
CartAI API keyObtain from the CartAI Admin Portal — see API Docs for full reference
MCP hostClaude Desktop, Cursor, VS Code (with MCP extension), or MCP Inspector

Installation

Run with npx (recommended)

You do not need to clone the repo. Point your MCP client at npx -y cartai-mcp-server and set CARTAI_API_KEY. See Configuration.

Local development
# 1. Clone the repo

git clone https://github.com/TheCartAI/cartai-mcp-server.git cd cartai-mcp-server

2. Install dependencies

npm install

3. Set your API key

export CARTAI_API_KEY=your_api_key_here

4. Verify it starts

npm start

→ [cartai-mcp] Running on stdio ✓

Never commit your API key. The repo ships with a .gitignore that excludes .env.


Configuration

The snippets below use npx. To run a local clone instead, set "command" to node and "args" to ["/absolute/path/to/cartai-mcp-server/src/index.js"].

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{

"mcpServers": { "cartai": { "command": "npx", "args": ["-y", "cartai-mcp-server"], "env": { "CARTAI_API_KEY": "your_api_key_here" } } } }

Restart Claude Desktop. You should see the CartAI tools in the tool picker.


Cursor

Add the following to ~/.cursor/mcp.json, or to .cursor/mcp.json in a project:

{

"mcpServers": { "cartai": { "command": "npx", "args": ["-y", "cartai-mcp-server"], "env": { "CARTAI_API_KEY": "your_api_key_here" } } } }


VS Code

Install the MCP extension for VS Code, then add the following to your .vscode/mcp.json (or user-level settings.json under "mcp.servers"):

{

"servers": { "cartai": { "type": "stdio", "command": "npx", "args": ["-y", "cartai-mcp-server"], "env": { "CARTAI_API_KEY": "your_api_key_here" } } } }

Reload the VS Code window. The CartAI tools will be available to any MCP-aware agent running in the editor.


MCP Inspector

MCP Inspector is the official browser-based tool for testing and debugging MCP servers without needing a full AI client.

# Run Inspector against this server in one command

npx @modelcontextprotocol/inspector npx -y cartai-mcp-server

Set the API key in the Environment Variables panel inside Inspector (CARTAI_API_KEY = your_api_key_here), then use the Tools tab to call create_checkout, get_checkout, etc. interactively.

MCP Inspector is the fastest way to validate tool inputs/outputs before wiring up a full client.


Tools

Checkout tools
create_checkout

Creates a new async checkout task from product page URLs. CartAI runs the checkout in the background and emits status updates via webhooks. Multi-merchant carts are split into one task per merchant.

Required inputs:

FieldTypeDescription
customerobjectCustomer contact, addresses, shipping method, and payment — see Customer object
tasks[].urlstring (URI)Full product page URL
tasks[].quantityintegerUnits to purchase (min 1)

Optional inputs:

FieldTypeDefaultDescription
tasks[].selectedVariant.colorstring—Variant color
tasks[].selectedVariant.sizestring—Variant size
optionsobject—Checkout behaviour flags — see Checkout options
addons.couponCodestring[]—Coupon / promo codes to apply, e.g. ["SUMMER15"]

Returns: a groupId and a tasks[] list — one entry per merchant with taskId, executionId, merchant, initial status (queued), and a liveUrl to watch the checkout run live.


create_search_checkout

Creates an async checkout task from product names instead of URLs. Give it the merchant website and a list of item names — the CartAI agent searches the merchant's catalog, resolves each item (and any selected variant), assembles the cart, and completes shipping, payment and order confirmation in one call.

When to use: this is the go-to tool when the user already knows what they want to buy and from which store (e.g. *"order X, Y and Z from Kylie Cosmetics"*). There's no need to call search_products first.

Required inputs:

FieldTypeDescription
customerobjectSame as create_checkout — see Customer object
merchantstring (URI)Merchant website URL, e.g. https://kyliecosmetics.com/
itemList[].namestringProduct name to search for on the merchant's site

Optional inputs:

FieldTypeDefaultDescription
itemList[].quantityinteger1Units to purchase (min 1)
itemList[].selectedVariantobject—Free-form key/value pairs using the option names shown on the merchant's site, e.g. { "Shade": "candy k" } or { "Color": "Black", "Size": "M" }
optionsobject—Same as create_checkout — see Checkout options
addons.couponCodestring[]—Coupon / promo codes to apply

Returns: same shape as create_checkout — groupId plus taskId, merchant, status, and liveUrl per task.


Customer object

Shared by create_checkout and create_search_checkout.

FieldTypeDescription
customer.contact.firstNamestring—
customer.contact.lastNamestring—
customer.contact.phonestringDigits, spaces, hyphens, leading + (7–20 chars)
customer.contact.emailstring—
customer.shippingAddress.addressLine1string—
customer.shippingAddress.addressLine2string—
customer.shippingAddress.citystring—
customer.shippingAddress.provincestringState/province code e.g. NY
customer.shippingAddress.postalCodestringZIP or postal code
customer.shippingAddress.countrystringCountry code e.g. US
customer.billingAddressobjectSame shape as shippingAddress
customer.shippingMethod.strategystringe.g. "cheapest" \"fastest" \"standard"
customer.payment.data.sessionIdstringAgentic payments: sessionId from create_payment_session, after the customer has authorized their card. No provider needed.
customer.payment.providerstringSet to "test" to pass raw card details (cardNumber, cvv, name, expiryMonth, expiryYear) in data instead of a sessionId
Checkout options

All flags default to false.

FieldDescription
options.verifyBeforePlacementAgent asks for confirmation just before placing the order
options.useSavedCredentialToLoginAgent signs in to the merchant using credentials stored via create_credential_session
options.useGuestCheckoutIfLoginFailsIf the stored credentials don't work, fall back to guest checkout when the merchant offers it
options.allowInteractionInteractive flow instead of fire-and-forget — the agent can pause and request input (e.g. an OTP via send_interactive_inputs)

| options.allowPartialCheckout | If some

冒頭だけを表示しています。続きはリポジトリで読めます