使用说明
n8n节点doku mcp客户端
官方n8n社区节点用于集成 DOKU支付服务 通过 模型上下文协议（MCP）.
将您的n8n AI代理连接到DOKU MCP服务器，让它自主创建支付链接、管理交易、生成QRIS代码等，所有这些都可以通过自然语言完成。
目录
安装
通过n8n UI安装(设置→ 社区节点→ 安装)或者直接使用npm：
npm install n8n-nodes-doku-mcp-client
有关完整说明，请参阅 n8n社区节点安装指南.
凭证
你需要一个 DOKU商户账户.注册地址： 博客.com 以获取您的凭据。
| 字段 | 描述 | 示例 |
|---|---|---|
| 端点URL | 您的DOKU MCP服务器的URL | https://mcp.doku.com/mcp |
| 服务器传输 | 连接协议 | HTTP Streamable （推荐） |
| 客户端ID | 您的DOKU商户客户ID | MCH-0106-XXXXXXXXX |
| API密钥 | 您的DOKU API密钥（加密存储） | doku_key_test_... |
该节点自动处理身份验证：
- 将API密钥编码为
Authorization: Basic <base64(apiKey:)> - 通过以下方式传递您的客户ID
Client-Id头球
API密钥是从 DOKU商户仪表板.
用法
1.将节点添加到AI Agent工作流中
这 DOKU MCP客户端工具 节点是一个 工具类型节点 --它必须连接到 AI 代理 节点通过 Tools 输出端口。
[Chat Trigger] → [AI Agent] ← [DOKU MCP Client Tool]
2.配置凭据
创建新 DOKU MCP服务器API 带有终结点URL、客户端ID和API密钥的凭据。
3.选择要曝光的工具
使用 要包含的工具 设置以控制代理可以做什么：
| 模式 | 描述 |
|---|---|
| 全部 | 公开MCP服务器提供的每个工具 |
| 已选 | 仅显示您选择的工具 |
| 除了 | 显示除您排除的工具之外的所有内容 |
4.运行您的工作流程
AI Agent将自动发现可用的DOKU工具，并在相关时调用它们。不需要额外的配置。
可用工具
DOKU MCP服务器公开 30工具 分为四类。工具在运行时动态加载——确切的集合取决于您的服务器配置。
结账付款（2个工具）
| 工具 | 说明 |
|---|---|
create_payment_link |
生成无需预先填写客户数据的付款链接 |
create_checkout_link |
生成具有指定客户数据的结账链接 |
直接支付（18种工具）
| 工具 | 说明 |
|---|---|
get_merchant_payment_methods |
为您的商家帐户检索已激活的付款方式 |
generate_payment_virtual_account |
生成银行转账的虚拟账号 |
update_payment_virtual_account |
修改现有虚拟帐户的详细信息 |
delete_payment_virtual_account |
关闭或禁用现有虚拟帐户的付款 |
generate_payment_qris |
为直接付款生成QRIS代码 |
generate_payment_card_auth |
对信用卡/借记卡执行3D安全（3DS）身份验证 |
generate_payment_card_capture |
捕获以前授权的卡交易 |
generate_payment_card_charge |
3DS身份验证成功后，对卡交易进行充值 |
generate_payment_ovo_auth |
付款前验证OVO帐户 |
generate_payment_ovo |
使用authCode生成OVO电子钱包付款 |
generate_payment_doku_ewallet_auth |
付款前验证或绑定DOKU电子钱包帐户 |
generate_payment_doku_ewallet |
成功验证后为DOKU电子钱包账户充值 |
generate_payment_dana |
生成DANA电子钱包付款 |
generate_payment_shopeepay |
生成ShopeePay电子钱包付款 |
generate_payment_akulaku |
生成Akulaku PayLater或分期付款交易 |
generate_payment_kredivo |
生成Kredivo PayLater或分期付款交易 |
generate_payment_alfagroup |
在Alfamart/Alfamidi生成现金支付的支付代码 |
generate_payment_indomaret |
在Indomaret生成现金支付的支付代码 |
交易实用程序（3个工具）
| 工具 | 说明 |
|---|---|
get_transaction_by_invoice_number |
使用发票号检索交易详细信息 |
get_transaction_by_customer_name |
使用客户名称检索交易详细信息 |
get_transaction_by_date_range |
检索指定日期范围内的交易 |
客户管理（7个工具）
| 工具 | 说明 |
|---|---|
add_customer |
使用姓名、电子邮件和电话创建新客户 |
update_customer |
更新现有客户详细信息（例如电话、电子邮件） |
delete_customer |
从您的记录中删除客户 |
get_customer_by_id |
使用客户的唯一客户ID检索客户详细信息 |
get_customer_by_name |
使用全名或部分姓名检索客户详细信息 |
get_customer_by_email |
使用注册的电子邮件地址检索客户详细信息 |
get_all_customers |
检索与您的商家帐户链接的所有客户 |
工具选择
当使用 已选 或 除了 模式、工具名称从MCP服务器动态加载。点击 刷新 在下拉菜单中，每当服务器的工具集发生变化时，都可以重新加载列表。
兼容性
| 要求 | 版本 |
|---|---|
| n8n | ≥1.82.0 |
| Node.js | ≥18.x（建议使用20.x） |
| MCP SDK | ≥1.25.x |
| 用n8n | 1.97.1测试 |
