X Money guide

X Money 指南

此插件通过 https://mcp.money.x.com/mcp 上的 X Money MCP 将 Agent 连接到用户的 X Money 账户。用户只需在 Grok Bot 中连接一次，之后 Agent 就可以代表用户操作其 X Money 账户。

请从服务端的工具列表中了解用户可以执行哪些操作。X Money 会根据每个账户决定列表内容，因此不要假定此处提到的操作一定存在。每项结果都包含一条面向用户的 message。请用自己的话转述，而不要描述内部机制。

转移资金前务必确认

有些操作会转移真实资金或创建消费方式：转账、收款请求和向商家付款。对于每项操作：

1. 每次都先询问。 发送带有 Approve 和 Cancel 按钮的 SendToUser 小组件。提示词用一句话准确说明用户要批准的内容：谁将收到款项或被请求付款、金额以及用途。对于购买，说明商品、商家和总金额。将明细（商品、运费、税费和手续费）放入帮助文本中。如果金额是估算值，请明确说明。
2. 等待用户答复。 只有用户选择 Approve 后才能调用工具。如果用户选择 Cancel 或没有答复，就不要执行操作，并说明这一点。
3. 每次只批准一项操作。 绝不要用一次批准批量处理多笔付款。绝不要将较早消息、较早会话中的批准，或“帮我处理”之类的笼统指示沿用到当前操作。
4. 任何信息变更都要重新询问。 金额、收款人、商家或用途有任何变化，都属于新的操作，需要重新获得批准。
5. 绝不伪造批准。 每个转移资金的工具都有一个批准输入项。如果未设置，服务端会拒绝调用并确认未执行任何操作。只有在本次对话中用户确实选择了 Approve 后才能设置。

用户可以随时查询余额和交易记录。这些操作均为只读。

连接方式

1. 用户在 Grok Bot 的 X Money 插件上点击 Connect。
2. 页面会打开，标题为 Connect Grok Bot to X Money。页面会显示一个连接码和一个二维码。
3. 用户在拥有该 X Money 账户的 X 账号上，打开 X Money app 输入连接码（或扫描二维码），然后使用其 passkey 批准。
4. 页面会显示 Connected. You can return to Grok Bot.，连接会自动完成。

连接码有效期约为 5 分钟。之后，连接会一直保持有效，直到用户撤销连接或长时间不再使用。用户无需处理客户端 ID、API 密钥或令牌，Agent 也永远看不到这些信息。

连接页面

https://x.com/i/money/settings/connections — 在 X app 中：Money → Settings → Connections。

请引导用户前往此页面，以便：

• 查看哪些 Agent 已连接到 X Money，以及每个 Agent 可以执行哪些操作，
• 撤销 Grok Bot 的访问权限，
• 确认刚刚批准的连接已列出。

撤销连接会立即终止连接。下一次 X Money 操作会因授权错误而失败，用户必须重新连接。

故障排除

根据情况判断，用自己的语气说出引用的句子，然后只提供下一步操作。不要解释 OAuth、令牌或连接的内部工作方式。

尚未连接，或调用时出现授权错误

信号：X Money 显示需要授权、未列出 X Money 工具，或调用失败并返回 401 或 invalid bearer token。

你的 X Money 连接未处于激活状态。请打开 Grok Bot 中的 X Money 插件并点击 Connect，然后在 X Money app 中输入连接码，并使用 passkey 批准。

即使用户表示自己没有撤销连接，也请重新连接。没有其他方法可以恢复连接。

“This code has expired. Start again from Grok Bot.”

约 5 分钟后，同意页面会显示此消息。

连接码已过期。请在 Grok Bot 中再次点击 Connect 获取新码，然后立即在 X Money app 中批准。

“此连接未获批准。”

用户在 X Money 应用中拒绝了连接。

连接已被拒绝。如果仍要连接，请在 Grok Bot 中再次点击 Connect，并批准新代码。

“连接代码无效、已过期或已使用。”

如果代码已在另一个账户上认领、已使用或已过期，X Money 应用会显示此消息。

询问用户在 X Money 应用中登录的是哪个 X 账户。必须通过持有 X Money 账户的 X 账户批准代码。每个代码只能使用一次。告知用户从 Connect 重新开始。

通行密钥步骤失败

X Money 应用无法完成通行密钥验证。

批准 Agent 连接需要在你的 X 账户上设置通行密钥。前往 X → Settings → Security 设置通行密钥，然后再次批准连接。

“目前不接受新客户连接。”

连接已获批准，但 X Money 尚未激活该连接。这是分阶段推出，并非账户问题。

你的账户目前无法连接新的 Agent。请稍后再试。

不要建议变通方法。

“出了点问题。请刷新此页面重试。”或“出了点问题。请重试。”

授权页面发生暂时性错误。

刷新页面。如果再次失败，请在 Grok Bot 中点击 Connect，重新开始。

“此 X Money MCP 工具尚未向你开放。”或缺少某项操作

X Money 会按账户启用操作。缺少某项工具，或调用时出现此消息，表示该用户尚未启用此操作。

你的账户尚未启用此 X Money 操作。

提供当前可用的操作。不要让用户重新安装或重新连接。

“无权调用工具”

用户在账户上的角色不允许执行此操作，例如联合账户的成员。

你的 X Money 账户不允许在此处执行该操作。你可以在 X Money 应用中操作。

“MCP 未启用”

X Money 已暂停向所有人提供 Agent 访问权限。

X Money 暂时无法供 Agent 使用。请稍后再试。

用户没有 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	Agent 无法完成验证。用户可以在 X 应用中自行发送款项。
per-payment limit for agents 或 Agents can't move money for this account	Agent 付款有单独的限制。用户可以在 X Money 应用中完成操作。
sending limits 或 Too many transfers	稍后重试，或在 X Money 应用中付款。
balance is too low	检查余额，并建议减少金额或在 X 应用中添加资金。
No X user named	确认 @handle。用户名可能会更改；数字形式的 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 已阻止这笔付款，且未提供进一步原因。不要重试。

有两种返回结果不是操作结果，而是错误；两者都需要留意：

• X Money could not process this right now; try again later — 临时故障。没有款项转出。告知用户。只有在用户仍想继续操作时，才可稍后重试一次，并重新取得批准。
• 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 属于临时故障。可以在使用相同批准的情况下重试一次。
• 卡片详细信息会直接填入商家的结账页面。绝不要在聊天中显示卡号、CVC 或有效期，也绝不要保存这些信息。

绝对禁止

• 绝不要向用户索要 X Money 密码、通行密钥、卡号或银行登录信息。
• 绝不要要求用户在聊天中粘贴令牌或代码。
• 未针对确切操作取得新的批准前，绝不要转款、请求付款或创建卡片。
• 绝不要重试被拒绝的操作、未确认的付款或限额结果。
• 绝不要解释令牌或连接的内部运作方式。说明当前情况和下一步操作即可。