X Money guide

X Money ガイド

このプラグインは、https://mcp.money.x.com/mcp の X Money MCP を通じて、エージェントをユーザーの X Money アカウントに接続します。ユーザーが Grok Bot で一度接続すると、エージェントはユーザーに代わって X Money アカウントを操作します。

ユーザーが利用できる機能は、サーバーのツール一覧で確認してください。ツール一覧はアカウントごとに X Money が決定するため、ここに記載されているからといって、そのアクションが存在すると想定しないでください。すべての結果には、ユーザー向けに書かれた message が含まれます。内部の仕組みを説明するのではなく、自分の言葉でユーザーに伝えてください。

送金する前に必ず確認する

実際のお金を動かしたり、お金を使える状態にしたりするアクションがあります。送金、お金の請求、加盟店への支払いが該当します。それぞれについて、次の手順に従ってください。

1. 毎回、必ず先に確認します。 Approve と Cancel を表示した SendToUser ウィジェットを送信してください。プロンプトは、ユーザーが何を承認するのかを正確に示す一文にします。支払い先または請求先、金額、目的を明記してください。購入の場合は、商品、加盟店、合計金額を記載します。内訳（商品、送料、税金、手数料）はヘルプテキストに記載してください。金額が見積もりの場合は、その旨を伝えてください。
2. 回答を待ちます。 ユーザーが Approve を選んだ後にのみ、ツールを呼び出してください。Cancel を選んだ場合、または回答がない場合は、何もせず、その旨を伝えてください。
3. 承認は一度に1つのアクションに限ります。 複数の支払いを1回の承認でまとめて実行しないでください。以前のメッセージや以前のセッションでの承認、または「任せる」のような一般的な指示を、今回の承認として扱わないでください。
4. 変更があれば、再度確認します。 金額、受取人、加盟店、目的のいずれかが変わった場合は、新たなアクションとなるため、新たな承認が必要です。
5. 承認を偽装しないでください。 お金を動かす各ツールには承認用の入力項目があります。設定されていない場合、サーバーは呼び出しを拒否し、何も実行されなかったことを確認します。この項目を設定するのは、この会話で実際に Approve が選択された後だけにしてください。

残高や取引履歴は自由に確認できます。これらは読み取り専用です。

接続の仕組み

1. ユーザーが Grok Bot の X Money プラグインで Connect をタップします。
2. Connect Grok Bot to X Money というタイトルのページが開きます。ここに接続コードと QR コードが表示されます。
3. ユーザーは、X Money アカウントを所有する X アカウントでX Money アプリを開き、コードを入力（または QR コードをスキャン）してから、パスキーで承認します。
4. ページに Connected. You can return to Grok Bot. と表示されると、接続は自動的に完了します。

コードの有効期限は約5分です。接続は、ユーザーが取り消すか、長期間利用しなくなるまで有効です。ユーザーが扱うクライアント ID、API キー、トークンはなく、エージェントがそれらを目にすることもありません。

Connections 画面

https://x.com/i/money/settings/connections — X アプリでは、Money → Settings → Connections を開きます。

次の操作を行う場合は、ユーザーにこの画面を案内してください。

• X Money に接続されているエージェントと、それぞれが実行できる操作を確認する
• Grok Bot のアクセス権を取り消す
• 承認したばかりの接続が一覧に表示されていることを確認する

アクセス権を取り消すと、接続はただちに終了します。次回の X Money アクションは認証エラーとなり、ユーザーは再接続する必要があります。

トラブルシューティング

該当する状況を特定し、引用された内容を自分の言葉で伝えたうえで、次に行う手順を1つだけ案内してください。OAuth、トークン、接続の内部的な仕組みについて説明しないでください。

未接続、または呼び出し時に認証エラーが発生する

兆候：X Money に認証が必要と表示される、X Money のツールが一覧に表示されない、または呼び出しが 401 や invalid bearer token で失敗する。

X Money への接続が有効ではありません。Grok Bot で X Money プラグインを開いて Connect をタップし、接続コードを X Money アプリで入力してから、パスキーで承認してください。

ユーザーが何も取り消していないと言っていても、再接続してください。接続を復元する方法はほかにありません。

「This code has expired. Start again from Grok Bot.」

同意ページには、約5分が経過するとこのメッセージが表示されます。

接続コードの有効期限が切れました。Grok Bot で Connect をもう一度タップして新しいコードを取得し、すぐに X Money アプリで承認してください。

「この接続は承認されませんでした。」

ユーザーが X Money アプリで拒否しました。

接続は拒否されました。引き続き接続する場合は、Grok Bot で［接続］をもう一度タップし、新しいコードを承認してください。

「接続コードが無効であるか、有効期限が切れているか、すでに使用されています。」

別のアカウントでコードが申請された場合、すでに使用されている場合、または有効期限が切れている場合、X Money アプリにこのメッセージが表示されます。

X Money アプリでどの X アカウントにサインインしているか尋ねてください。コードは、X Money アカウントを保有している X アカウントから承認する必要があります。各コードは一度だけ使用できます。［接続］からやり直すよう伝えてください。

パスキーの手順に失敗する

X Money アプリでパスキーのチャレンジを完了できません。

エージェントの接続を承認するには、X アカウントにパスキーが必要です。X →［設定］→［セキュリティ］で設定してから、接続をもう一度承認してください。

「新規のお客様の接続は現在受け付けていません。」

接続は承認されましたが、X Money が有効化しませんでした。これは段階的な展開によるもので、アカウントの問題ではありません。

現在、お客様のアカウントでは新しいエージェント接続を受け付けていません。しばらくしてからもう一度お試しください。

回避策を提案しないでください。

「問題が発生しました。このページを更新してもう一度お試しください。」または「問題が発生しました。もう一度お試しください。」

同意ページで一時的なエラーが発生しています。

ページを更新してください。再度失敗した場合は、Grok Bot で［接続］をタップして最初からやり直してください。

「この X Money MCP ツールはまだご利用いただけません。」またはアクションが表示されない

X Money ではアカウントごとにアクションを有効にしています。ツールが表示されない場合、または呼び出し時にこのメッセージが表示される場合、そのユーザーに対してアクションが有効になっていません。

この X Money アクションはまだお客様のアカウントで有効になっていません。

利用可能なアクションを案内してください。再インストールや再接続を勧めないでください。

「ツールを呼び出す権限がありません」

共同アカウントのメンバーなど、アカウント上のユーザーの役割ではこのアクションを実行できません。

お客様の X Money アカウントでは、ここからそのアクションを実行できません。X Money アプリで実行できます。

「MCP が有効になっていません」

X Money がすべてのユーザーに対するエージェントアクセスを一時停止しています。

X Money は現在、一時的にエージェントから利用できません。しばらくしてからもう一度お試しください。

ユーザーが X Money アカウントを持っていない

同意ページまたは X Money アプリに、ユーザーは X Money を利用できないと表示されるか、ユーザーが設定したことがないと述べています。

X Money は米国の対象となるお客様にご利用いただけます。まず X アプリで X Money を設定してから、ここで接続してください。

支払い結果の確認

送金または請求を行うたびに、outcome と message が返されます。

結果	意味	対応
completed	送金が完了したか、請求が相手に届きました	メッセージを伝えてください
pending	X Money が確認中か、相手の対応が必要です	メッセージを伝えてください。再送しないでください。ユーザーは X Money アプリで状況を確認できます
refused	X Money が処理を拒否しました	メッセージを伝えてください。拒否された支払いは絶対に再試行せず、回避するために金額を変更しないでください

よくある拒否メッセージと、追加で伝える内容：

メッセージに含まれる文言	追加で伝える内容
verify this payment in the X Money app	エージェントは確認手続きを完了できません。ユーザーは X アプリから自分で送金できます。
per-payment limit for agents または Agents can't move money for this account	エージェントによる支払いには独自の制限があります。ユーザーは X Money アプリから操作できます。
sending limits または Too many transfers	時間をおいて再度試すか、X Money アプリから支払ってください。
balance is too low	残高を確認し、金額を減らすか、X アプリで資金を追加する方法を提案してください。
No X user named	@ハンドルを確認してください。ハンドルは変更されることがあるため、数値の X ユーザー ID のほうが安定しています。
isn't on X Money yet	支払いや請求を行うには、相手が先に X Money を設定する必要があります。
own X account	別の X ユーザーを選んでください。
only accepts money from people they follow	こちらでできることはありません。
different currencies または can't receive または can't send	こちらでできることはありません。X Money アプリから支払ってください。
X Money did not allow this payment	X Money によってブロックされましたが、それ以上の理由は示されていません。再試行しないでください。

結果ではなくエラーとなるケースが 2 つあります。どちらも重要です。

• X Money could not process this right now; try again later — 一時的な障害です。資金は移動していません。ユーザーに伝えてください。ユーザーが引き続き希望する場合に限り、新たな承認を得てから、後で 1 回だけ再試行してください。
• X Money accepted this payment but could not confirm it. Do not send it again — 支払いが完了している可能性があります。絶対に再送しないでください。 X Money アプリで取引を確認するようユーザーに伝えてください。

ネットワーク障害の後にまったく同じ支払いを再試行する場合は、同じ冪等性キーを再利用してください。これにより、X Money が支払いを重複して処理することを防げます。キーを再利用すると、以前の結果が返され、その旨が示されます。

カードでの購入

• 商品、加盟店、合計金額を確認して、購入そのものを承認してください。X Money が発行するカードは、ユーザーが承認する対象ではありません。
• 日次上限に達したためカードが作成されなかったと結果に示されている場合は、上限がいつリセットされるかも記載されています。ユーザーに伝えて、そこで終了してください。その日は再試行しないでください。
• failed to create card, try again は一時的なエラーです。同じ承認を得たうえであれば、1 回の再試行は問題ありません。
• カード情報は加盟店のチェックアウト画面に直接入力してください。カード番号、CVC、有効期限をチャットに表示したり、保存したりしないでください。

絶対にしてはいけないこと

• X Money のパスワード、パスキー、カード番号、銀行のログイン情報をユーザーに尋ねないでください。
• トークンやコードをチャットに貼り付けるよう、ユーザーに求めないでください。
• その操作に対する新たな承認なしに、送金、請求、カードの作成を行わないでください。
• 拒否された支払い、確認できていない支払い、上限に達した結果を再試行しないでください。
• トークンや接続の内部的な仕組みを説明しないでください。状況と次の手順を伝えてください。