インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、Tamara をワンクリックで追加して、AI クライアント(Claude、ChatGPT、Copilot、Cursor)を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
概要
Tamara の後払い(BNPL、サウジアラビア、UAE、クウェート、バーレーン、オマーン)に対応します。自社の注文番号または Tamara の ID で注文を照会し、ステータスとキャプチャ済み、返金済み、精算済みの金額を確認できます。支払い方法と顧客の利用可否も確認できます。キャプチャと返金も含まれますが、インストール時はオフです。
こう聞いてみよう
Tamara のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Tamara をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Tamara
Tamara の後払い(BNPL、サウジアラビア、UAE、クウェート、バーレーン、オマーン)に対応します。自社の注文番号または Tamara の ID で注文を照会し、ステータスとキャプチャ済み、返金済み、精算済みの金額を確認できます。支払い方法と顧客の利用可否も確認できます。キャプチャと返金も含まれますが、インストール時はオフです。
セットアップ
セットアップは約 2 分です。Tamara の加盟店アカウントと、その API トークンが必要です。
- Tamara Partners Portal にサインインして API Token Management を開くか、加盟店アカウントと一緒に Tamara から届いた API トークンを使います。サンドボックスと本番ではトークンが異なります。
- トークンを
TAMARA_API_TOKENに貼り付けます。"Bearer" やスペースは付けません。トークンはAuthorization: Bearer <token>として送られます。通知用トークンと公開キーはここでは使いません。 TAMARA_API_URLには本番ならhttps://api.tamara.co、サンドボックスならhttps://api-sandbox.tamara.coを設定します。トークンと一致している必要があります。- コネクタをインストールし、
tamara_list_payment_typesを実行します。ストアが提供する支払い方法が一覧表示され、トークンが確認できます。
自社の注文番号か Tamara の ID か: order_reference_id はチェックアウト時に送った自社の注文番号(ショップの注文番号など)で、order_id は Tamara が発行した UUID です。ほとんどの質問は自社の注文番号から始まり、tamara_get_order_by_reference を使います。
読み取れるデータ: 自社の注文番号または Tamara の注文 ID で指定した注文(ステータス、支払い方法と分割回数、顧客、住所、商品、合計、キャプチャ済み、返金済み、キャンセル済み、支払い済みの金額、精算ステータスと精算日、トランザクション(キャプチャ、返金、キャンセル))、国ごとに利用できる支払い方法(PAY_BY_INSTALMENTS や PAY_NOW など。注文金額の下限と上限、対応する分割回数付きで、金額に対して利用可能なものだけに絞ることも可能)、チェックアウト前に特定の顧客がある金額で使える支払いオプションと、Tamara が現在その顧客(電話番号、メール、またはその両方で指定)を利用可能と見なしているか、そして URL、イベント、ヘッダーを含む登録済みの Webhook です。
注文ステータス: new、approved、authorised の後、partially_captured または fully_captured、そして partially_refunded または fully_refunded となります。canceled、declined、expired は最終状態です。paid_amount は顧客がこれまでに支払った額で、settlement_status と settlement_date は Tamara があなたに支払い済みかどうかを示します。
インストール時はオフ: tamara_capture_order(発送時にオーソリ済みの注文を全額または一部キャプチャし、Tamara が精算できるようにする)と tamara_refund_order(キャプチャ済みの注文を全額または一部返金。お金は顧客に戻り、取り消せません)です。どちらもお金が動くため、管理者が意図的にオンにします。オンにした後も、AI は注文、金額、通貨を示してあなたの同意を待ちます。
金額と時刻: 金額は amount と currency を持つオブジェクトです。SAR と AED は小数 2 桁、BHD、KWD、OMR は 3 桁です。時刻は UTC の ISO 8601 です。
制限: Tamara には注文を一覧表示または検索するエンドポイントがないため、AI は自社の注文番号または Tamara の ID で注文を照会します。
よくあるエラー: 401 はトークンが間違っているか、もう一方の環境(サンドボックスまたは本番)のトークンであることを意味します。注文で 404 が返る場合、その環境にはその参照番号や ID の注文がありません。キャプチャや返金で 400 や 422 が返る場合は、Tamara が拒否した項目(キャプチャ可能額を超える金額など)が示されます。403 はトークンは有効でもこの API を使えないことを意味します。加盟店アカウントで有効にするよう Tamara に依頼してください。
このコネクタは、チェックアウトセッションの作成、注文のオーソリやキャンセル、claims API の利用、精算レポートの取得は行いません。
前提条件: TAMARA_API_URL, TAMARA_API_TOKEN
ローカルでコネクタをインストール
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
http://localhost:3000/connectors/store を開き、 Tamara を選択し、前提条件に記載された環境変数を入力します。
利用可能なツール
| Tool | What it does |
|---|---|
tamara_list_payment_types | List the Tamara payment types available to the merchant in a country (PAY_BY_INSTALMENTS, PAY_NOW...) with minimum and maximum order… |
tamara_get_order_by_reference | Get a Tamara order by your own order number (the order_reference_id sent at checkout, e.g. the shop order number): Tamara order_id, status… |
tamara_get_order | Get a Tamara order by its Tamara order_id with the same details as tamara_get_order_by_reference: status, amounts (total, captured… |
tamara_check_payment_options | Check which Tamara payment options a specific customer can use for an order amount before checkout (has_available_payment_options… |
tamara_check_customer_eligibility | Check whether Tamara currently treats a customer as eligible (is_eligible), based on active decline records, for an order amount |
tamara_get_webhook | Get a registered webhook by its id: url, subscribed events (order_approved, order_authorised, order_captured, order_refunded...) and headers |
tamara_capture_order | Capture an authorised Tamara order in full or in part when it ships, so Tamara settles it |
tamara_refund_order | Refund a captured Tamara order in full or in part (simplified refund) |
プロンプトの例
- 「注文 100245 は Tamara でどのステータスですか?Tamara からもう支払われましたか?」
- 「注文 100245 のうち、これまでにキャプチャ、返金、顧客による支払いが済んだ額はそれぞれいくらですか?」
- 「サウジアラビアで 1,200 SAR の注文に対して、当店が提供している Tamara の支払い方法は何ですか?」
- 「電話番号 +966501234567 の顧客は、Tamara で 800 SAR を支払えますか?」
- 「注文 100245 を発送しました。全額キャプチャしてください。先に注文と金額を見せてください。」
次のステップ
このガイドは役に立ちましたか?