mp-test-setup

mp-test-setup

このスキルは、テストユーザーを作成する唯一の場所です。テストの仕組みは混乱の原因になりやすく、接頭辞の異なる2種類のテスト認証情報があるため、このスキルが用意されています。

---

事前確認 — テストユーザーを作成する前に準備状況を確認する

統合の手順のステップ4/7です： 1. アプリを作成 · 2. TEST 認証情報を取得 · 3. スキャフォールドを作成 · 4. テストユーザーを作成 ← 現在 · 5. E2E · 6. /mp-review · 7. 本番

テストユーザーを作成する前に、AskUserQuestion で基本事項を確認します（最大3つの質問 — .mp-integrate-progress.md ですでに確認済みの項目は省略します）。

1. アカウント — .mp-integrate-progress.md ですでに確認済みの場合は省略します。それ以外の場合：「Mercado Pago の開発者アカウントをお持ちですか？」→ Yes / No
2. 認証情報 — 「APP_USR- アクセストークンをお持ちですか？」→ Yes / No
3. 認証情報の種類 — 「{test_tab} タブから取得した TEST 認証情報を使用していますか？」→ Yes, test credentials / No, production credentials / I don't know

• アカウントがない場合 → 国別のダッシュボードを案内します（Chile：https://www.mercadopago.cl/developers — .com ではありません。それ以外：https://www.mercadopago.com.{cc}/developers）。

• 認証情報がない場合 → 開発者がインポートを選択した場合は、application_list の直前に Step 0 のオンデマンド手順を適用し、AskUserQuestion で 「どのアプリを使用しますか？」 と尋ねた後、選択された application_id を指定して mcp__plugin_mercadopago_mcp__get_credentials を呼び出し、認証情報をインラインで表示します。ファイルへの書き込みやコミットは絶対に行わないでください。 手動でのダッシュボード案内に MCP は必要ありません。

• 認証情報の種類 — No, production credentials または I don't know → 次のブロッキング警告を表示し、テストユーザーを作成しないでください：

  ⛔ 警告 — 本番認証情報が検出されました 本番環境に対してテストすると、実際にカードへ請求が発生する場合があります。まず、開発者ダッシュボードの {test_tab} タブに切り替えてください。 👉 https://{DOMAIN}/developers/panel/app → 認証情報 → {test_tab} タブ

  開発者が「Yes, test credentials」と確認するまで質問3を再表示します。この確認にはスキップの選択肢はありません。確認が取れない限り、Step 2（テストユーザーの作成）に進まないでください。

テストユーザーの作成または入金には MCP が必要ですが、準備状況の案内や同梱のテストカードには必要ありません。開発者が MCP を使う操作に進む場合にのみ接続してください。

---

現在のテストの仕組み — 最初にお読みください

• 認証情報の接頭辞 — 2種類あります：
  • APP_USR- → create_test_user で作成したテストユーザーの認証情報、本番認証情報、Orders API、Checkout Pro、Point、QR
  • TEST- → {test_tab} タブにある静的テスト認証情報、Checkout API / Bricks / Payments API どちらも有効です。get_credentials は正しい形式を自動的に返します。開発者に接頭辞を変更するよう伝えてはいけません。
• テストユーザーの認証情報には APP_USR- 接頭辞が付き、本番 API に対して動作します。テストユーザーは独自の残高（このスキルで入金）を持ち、実際のアカウントと同じように動作します。
• テストユーザーを作成せずに静的テスト認証情報を使用する場合：開発者ダッシュボードでアプリに移動し、認証情報を開いて {test_tab} タブをクリックします。

---

ステップ 0 — 選択した MCP ツールを呼び出す直前にのみ接続する

このスキルの開始時に MCP を調査しないでください。application_list、get_credentials、create_test_user、add_money_test_user、または search_documentation のフォールバックを呼び出す直前に、次の手順を実行してください。

1. 呼び出し可能な場合は、目的のツールを直接呼び出します。汎用的な接続確認として application_list を使用しないでください。
2. 利用できない場合、または認証エラーが返された場合は、mcp__plugin_mercadopago_mcp__authenticate を呼び出し、開発者の言語で OAuth リンクを表示します。
3. URL を外部ブラウザーにコピーせず、Cmd+クリック（Mac）または Ctrl+クリック（Windows/Linux）するよう開発者に案内します。
4. 開発者が戻ったら、目的のツールを直接再試行します。実際の操作でアプリを選択する場合、または認証情報をインポートする場合にのみ application_list を呼び出してください。
5. コールバック URL を尋ねないでください。認証に 2 回失敗した後は、再試行するか、オフラインのガイダンス／テストカードで続行するか、MCP を利用する操作をキャンセルするかを選べるよう案内します。

---

ステップ 1 — 質問する前に site_id を解決する

MCP は現在 site_id を返しません（application_list が返すのは AppID／AppName／AppDescription のみであり、/users/me の呼び出しに必要な OAuth アクセストークンはプラグインクライアントに公開されていません）。次の順で解決してください。

1. エージェントがすでに country= として渡した国を使用する — エージェントによってすでに解決されています（永続化された状態またはウィザード）。
2. プロジェクトのルートにある .mp-integrate-progress.md を読み取る — 前回の実行で国が保存されている場合は、それを再利用します。
3. 最終手段：AskUserQuestion を使って尋ねます（選択式にし、番号付きのテキストブロックは使わないでください）。回答を .mp-integrate-progress.md に保存します。

リポジトリ内で currency_id／site_id のリテラルやロケール文字列を grep しないでください。クリーンなリポジトリでは信頼できず、トークンを浪費します。

ステップ 2 — テストユーザーを作成する

次の MCP 呼び出しの直前に、ステップ 0 を適用してください。

次のパラメーターを指定して mcp__plugin_mercadopago_mcp__create_test_user を呼び出します。

Param	Required	Values
site_id	yes	MLA（アルゼンチン）、MLB（ブラジル）、MLM（メキシコ）、MLC（チリ）、MCO（コロンビア）、MPE（ペルー）、MLU（ウルグアイ）
description	yes	ユーザーを識別する自由記述（例："buyer for checkout-pro tests"）
profile	yes	seller または buyer — シミュレートする役割を選択します
amount	optional	その国の通貨での初期残高

このツールは、ユーザー ID、メールアドレス、パスワード、APP_USR- 認証情報を返します。

⚠️ 重要な違い — 2 種類の認証情報：

• テストユーザーのメールアドレスとパスワード → テスト中に購入者／販売者としてチェックアウトページにログインするために使用します。.env には使用しません。
• テストユーザーの APP_USR- 認証情報 → テストユーザー自身の API 認証情報です。そのテストユーザーとして API 呼び出しを行う必要がある場合（例：マーケットプレイスの販売者向け OAuth フロー）にのみ使用します。アプリの MP_ACCESS_TOKEN ではありません。
• アプリの MP_ACCESS_TOKEN → DevPanel → アプリ → {test_tab} タブから取得します。.env に設定するのはこちらです。create_test_user ではなく、mp-integrate が作成します。

開発者が取引の両側を必要とする場合（マーケットプレイス、サブスクリプション、P2P で一般的）は、seller を 1 人、buyer を 1 人作成します。

---

ステップ 3 — 資金を追加する（必要な場合）

セッションがすでに認証済みでない場合は、次の MCP 呼び出しの直前にステップ 0 を適用してください。

次のパラメーターを指定して mcp__plugin_mercadopago_mcp__add_money_test_user を呼び出します。

Param	Required
test_user_id	yes — create_test_user が返した ID
amount	yes — ユーザーの通貨での金額

国ごとの上限が適用されます。上限エラーで呼び出しが失敗した場合は、金額を減らすよう依頼し、1 回だけ再試行します。

---

Step 4 — テストカード

カードのテストには、カード番号を決して作り出さないでください。

1. まず、${CLAUDE_PLUGIN_ROOT}/skills/mp-integrate/references/products.md を読みます。ここには、AR、BR、MX、CO、CL 用の厳選されたバージョン固定のテストカード（番号、CVV、有効期限、および APRO／OTHE／FUND／… のステータスコード表）が記載されています。Claude Code はこれをアクティブなプラグインのバージョンに解決します。他のマーケットプレイスやインストールキャッシュは決して検索しないでください。この5か国については、MCP の呼び出しは不要です。
2. その国が一覧にない場合に限り（例：PE、UY）、Step 0 を適用し、MCP の search_documentation に "test cards {country}"（例："test cards peru"）を指定してフォールバックします。

---

Step 5 — 認証情報を開発者に渡す

出力テンプレート：

## Test user created

**Country**: {country}
**Profile**: {seller | buyer}
**User id**: {id}
**Initial balance**: {amount} {currency}

### 🔑 Login credentials (to simulate the buyer/seller at checkout)

Use these to **log in at the Mercado Pago checkout page** during a test purchase:

- **Email**: {email}
- **Password**: {password}

> These are NOT your MP_ACCESS_TOKEN. Do NOT put these in your `.env`.

---

### 📋 Your app's test credentials (for your `.env`)

These come from **DevPanel → your app → {test_tab} tab** — NOT from the test user.

MP_ACCESS_TOKEN=APP_USR-... ← アプリのテスト用アクセストークン（DevPanel から取得） MP_PUBLIC_KEY=APP_USR-... ← アプリのテスト用公開鍵（DevPanel から取得）

> Both types of credentials use the `APP_USR-` prefix — what matters is WHERE they come from:
> - Your `.env`: from DevPanel → your app → {test_tab} tab
> - Checkout login: the test user's email + password above

### Next steps
- Use the test user **email + password** to log in at the checkout when making a test purchase.
- Use your app's **MP_ACCESS_TOKEN** (from DevPanel) in your backend to create orders/payments.
- For card payments, use the test cards in `references/products.md`.
- Smoke test with `mp-webhooks` → trigger a real test payment to fire the webhook.
- Run `mp-review` after a successful test payment.

---

注意点

• テストユーザーの認証情報は、本番環境の認証情報と見分けがつきません。.env ファイルが漏えいすると、購入者と販売者の両方の残高が露出します。
• テストユーザーのメールアドレスとパスワードは、mercadopago.com.{tld} へのログインに使用できます。開発者はサインインして取引を確認できます。
• テストユーザーは site_id で指定された国に属します。アルゼンチンのテスト用認証情報をブラジルのサイトで使用しようとすると、not_found の支払いが発生し、エラーは表示されません。
• チャージには国ごとの1日あたりの上限があります。上限に達した場合は、上限を引き上げるのではなく、新しいテストユーザーを作成してください。

---

このスキルが行わないこと

• 実際の本番用認証情報は発行しません。それらは Developer Dashboard から取得してください。
• Webhook の検証（mp-webhooks を使用）や、連携コードのひな形作成（mp-integrate を使用）は行いません。