货币开发工具包

其他 社区

技能解读

当前原文的自动摘译,尚未人工审校。

1. 获取凭证

选项 A — MCP:有两个 MCP 服务器: 未经身份验证 (/mcp/) — 用于创建新帐户并生成凭证 经过身份验证 (/mcp/account/) — 用于在设置后管理您的帐户(需要 OAuth) 要创建新帐户:

2. 选择一个框架并遵循其指南

Next.js → 阅读references/nextjs.md Replit (Express + Vite) → 阅读references/replit.md

3. 创建产品(可选)

对于固定目录项,通过仪表板或 MCP 创建产品:然后使用带有产品 ID 的type: 'PRODUCTS' 结账。对于动态金额(小费、捐款、发票),请跳过产品并直接使用type: 'AMOUNT'。

4. 部署

部署到 Vercel (Next.js) 或 Replit。确保在生产环境中设置了MDK_ACCESS_TOKEN和MDK_MNEMONIC。 ⚠️ 在管道环境变量时使用 printf 而不是 echo — 尾随换行符会导致静默身份验证失败。

结帐类型

类型 · 使用案例 · 必填字段 AMOUNT · 动态金额、小费、发票 · amount、currency PRODUCTS · 销售仪表板产品 · product(产品 ID)

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
通用
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@diegosouzapw · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
需要 · Vendor-specific
兼容的系统
macOS · Linux · Windows
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 读取环境变量
网络行为
允许外网请求
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

作者说明文件(原文) SKILL.md

# moneydevkit

Add payments to any web app in under 5 minutes. Two supported frameworks: Next.js and Replit (Express + Vite).

## Workflow

### 1. Get credentials

**Option A — MCP:**

There are two MCP servers:
- **Unauthenticated** (`/mcp/`) — for creating a new account and minting credentials
- **Authenticated** (`/mcp/account/`) — for managing your account after setup (requires OAuth)

To create a new account:
```
claude mcp add moneydevkit --transport http https://mcp.moneydevkit.com/mcp/
```

After you have credentials, switch to the authenticated MCP for full account control:
```
claude mcp add moneydevkit --transport http https://mcp.moneydevkit.com/mcp/account/
```

**Option B — CLI:**
```bash
npx @moneydevkit/create
```

**Option C — Dashboard:**
Sign up at [moneydevkit.com](https://moneydevkit.com) and create an app.

All options produce two values:
- `MDK_ACCESS_TOKEN` — API key
- `MDK_MNEMONIC` — wallet seed phrase

Add both to `.env` (or Replit Secrets, Vercel env vars, etc.). Both are required.

### 2. Pick a framework and follow its guide

- **Next.js** → read [references/nextjs.md](references/nextjs.md)
- **Replit (Express + Vite)** → read [references/replit.md](references/replit.md)

### 3. Create products (optional)

For fixed catalog items, create products via the dashboard or MCP:
```
mcporter call moneydevkit.create-product name="T-Shirt" priceAmount=2500 currency=USD
```
Then use `type: 'PRODUCTS'` checkouts with the product ID.

For dynamic amounts (tips, donations, invoices), skip products and use `type: 'AMOUNT'` directly.

### 4. Deploy

Deploy to Vercel (Next.js) or Replit. Ensure `MDK_ACCESS_TOKEN` and `MDK_MNEMONIC` are set in the production environment.

⚠️ Use `printf` not `echo` when piping env vars — trailing newlines cause silent auth failures.

## Checkout types

| Type | Use case | Required fields |
|------|----------|----------------|
| `AMOUNT` | Dynamic amounts, tips, invoices | `amount`, `currency` |
| `PRODUCTS` | Sell dashboard products | `product` (product ID) |

## Pricing options

- **Fixed price** — set specific amount (USD cents or whole sats)
- **Pay what you want** — customer chooses amount (set `amountType: 'CUSTOM'` on product)

## Currency

- `USD` — amounts in cents (e.g. 500 = $5.00)
- `SAT` — amounts in whole satoshis

## Customers

Collect customer info to track purchases and enable refunds:
```ts
await createCheckout({
  // ...checkout fields
  customer: { email: 'jane@example.com', name: 'Jane', externalId: 'user-123' },
  requireCustomerData: ['email', 'name'] // show form for missing fields
})
```

## MCP tools

If the [moneydevkit MCP server](https://mcp.moneydevkit.com/mcp/account/) is connected (authenticated), these tools are available:

- `create-app` / `list-apps` / `update-app` / `rotate-api-key` — manage apps
- `create-product` / `list-products` / `get-product` / `update-product` / `delete-product`
- `create-customer` / `list-customers` / `get-customer` / `update-customer` / `delete-customer`
- `list-checkouts` / `get-checkout` — view checkout sessions
- `list-orders` / `get-order` — view completed payments
- `search-docs` — search moneydevkit documentation

## Docs

Full documentation: [docs.moneydevkit.com](https://docs.moneydevkit.com)

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。