Open-source B2B and marketplace ecommerce; new stores include an MCP server for AI agents.
MCP Nupay
ภาพรวม
คำอธิบายจากผู้ทำ (ภาษาอังกฤษตามต้นฉบับ)
MCP server for NuPay — Nubank merchant checkout: Pix + wallet one-click for 100M+ BR users
สามเสาของ PopNx MCP
สามเรื่องนี้ไม่รวมเป็นคะแนนเดียว เพราะความเห็น การวัด และความนิยม เป็นคนละเรื่องกัน
- เสียงผู้ใช้iยังไม่มีรีวิวรีวิวเปิดพร้อมระบบบัญชีในขั้นถัดไป
- ผลตรวจเบื้องต้นของเราiผ่าน 1 จาก 1 ข้อตรวจจากข้อมูลที่เปิดอยู่ ยังไม่ได้สแกนโค้ด
- การใช้งานiยังไม่ได้วัด★ –
ใช้ทำอะไรได้
ตัวนี้ยังไม่ได้เรียบเรียงเป็นภาษาไทย ด้านล่างคือข้อเท็จจริงที่เราอ่านจาก registry
- การเชื่อมต่อ: รันบนเครื่อง
- ช่องทาง (transport): stdio
- หมวด: ร้านค้าออนไลน์และรับเงิน
- ต้องใส่ค่าเหล่านี้: NUPAY_MERCHANT_KEY, NUPAY_MERCHANT_TOKEN, NUPAY_CLIENT_SECRET
ติดตั้ง
เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง
ก่อนติดตั้ง
- ผลตรวจเบื้องต้น: ผ่าน 1 จาก 1 ข้อ
- รันในเครื่องคุณด้วยสิทธิ์ของผู้ใช้คุณ (ไฟล์ อินเทอร์เน็ต แอปต่าง ๆ)
- ค่าที่คุณต้องใส่เอง:
NUPAY_MERCHANT_KEY,NUPAY_MERCHANT_TOKEN,NUPAY_CLIENT_ID,NUPAY_CLIENT_SECRET,NUPAY_ENV
ค่าที่ติดป้ายความลับคือกุญแจของบัญชีคุณ อย่าส่งให้ใคร และอย่าวางในแชต
ต้องเตรียมก่อน
- npmติดตั้ง Node.js (มีคำสั่ง npx) ในเครื่อง
คุณใช้แอปไหน
เลือกแอปด้านบน เราจำไว้ให้ ครั้งหน้าปุ่มจะขึ้นว่า “ติดตั้งลง …”
เปิด Claude Desktop → Settings → Developer → Edit Config แล้ววางค่านี้ในไฟล์ claude_desktop_config.json
{
"mcpServers": {
"nupay": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-nupay"
],
"env": {
"NUPAY_MERCHANT_KEY": "ใส่ค่าของคุณ",
"NUPAY_MERCHANT_TOKEN": "ใส่ค่าของคุณ",
"NUPAY_CLIENT_ID": "ใส่ค่าของคุณ",
"NUPAY_CLIENT_SECRET": "ใส่ค่าของคุณ",
"NUPAY_ENV": "ใส่ค่าของคุณ"
}
}
}
}พิมพ์คำสั่งนี้ใน Terminal
claude mcp add nupay --env NUPAY_MERCHANT_KEY='ใส่ค่าของคุณ' --env NUPAY_MERCHANT_TOKEN='ใส่ค่าของคุณ' --env NUPAY_CLIENT_ID='ใส่ค่าของคุณ' --env NUPAY_CLIENT_SECRET='ใส่ค่าของคุณ' --env NUPAY_ENV='ใส่ค่าของคุณ' -- npx -y @codespar/mcp-nupayเติมค่าที่เว้นว่างไว้ก่อนรัน
หรือคัดลอกค่าตั้งเอง
วางในไฟล์ .cursor/mcp.json ของโปรเจกต์ หรือ ~/.cursor/mcp.json
{
"mcpServers": {
"nupay": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-nupay"
],
"env": {
"NUPAY_MERCHANT_KEY": "ใส่ค่าของคุณ",
"NUPAY_MERCHANT_TOKEN": "ใส่ค่าของคุณ",
"NUPAY_CLIENT_ID": "ใส่ค่าของคุณ",
"NUPAY_CLIENT_SECRET": "ใส่ค่าของคุณ",
"NUPAY_ENV": "ใส่ค่าของคุณ"
}
}
}
}เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง
หรือคัดลอกค่าตั้งเอง
วางในไฟล์ .vscode/mcp.json ของโปรเจกต์
{
"servers": {
"nupay": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-nupay"
],
"env": {
"NUPAY_MERCHANT_KEY": "ใส่ค่าของคุณ",
"NUPAY_MERCHANT_TOKEN": "ใส่ค่าของคุณ",
"NUPAY_CLIENT_ID": "ใส่ค่าของคุณ",
"NUPAY_CLIENT_SECRET": "ใส่ค่าของคุณ",
"NUPAY_ENV": "ใส่ค่าของคุณ"
}
}
}
}เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง
ตัวนี้รันในเครื่องคุณ แต่ ChatGPT ต่อได้เฉพาะ server บนอินเทอร์เน็ต ลองเลือกแอปอื่น
ตัวเลือกเก็บในคุกกี้บนเครื่องนี้ ไม่ต้องมีบัญชี
ค่าที่ต้องใส่เอง
- NuPay X-Merchant-Key issued to your merchant
- NuPay X-Merchant-Token issued to your merchant
NUPAY_CLIENT_IDenvOAuth2/CIBA client_id for pre-authorized (recurrence) flows. Optional unless using backchannel_start / backchannel_complete.- OAuth2/CIBA client_secret for pre-authorized flows. Optional unless using backchannel_* tools.
NUPAY_ENVenvsandbox | production. Defaults to sandbox. Drives both checkout API and auth base URLs.
ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README
ทำอะไรได้บ้าง
รันในเครื่องคุณ รายการเครื่องมือจะขึ้นในแอป AI หลังติดตั้ง
ผลตรวจเบื้องต้นi
เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 6 พ.ย. 2569
- ✓ ผ่าน
ตัวตนผู้ทำตรงกับ repo
ชื่อใน registry ยืนยันด้วยบัญชี GitHub codespar ซึ่งเป็นเจ้าของ repo
- … ยังไม่ตรวจ
ยังมีคนดูแล
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
- … ยังไม่ตรวจ
มีสัญญาอนุญาต (license)
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
- – ไม่เกี่ยว
endpoint ตอบ
ตัวนี้รันบนเครื่องคุณ ไม่มี endpoint บนอินเทอร์เน็ต
- – ไม่เกี่ยว
ล็อกอินแบบ OAuth
ตัวนี้รันบนเครื่อง ใช้ค่าที่ตั้งในเครื่องแทน
- … ยังไม่ตรวจ
คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง
รันในเครื่องคุณ เราอ่านรายการเครื่องมือได้เฉพาะตัวที่มี endpoint บนอินเทอร์เน็ต
เทียบกับตัวอื่นในหมวด ร้านค้าออนไลน์และรับเงินi
- ดาวมากกว่า 0% ของอีก 1745 ตัวในหมวดนี้
- ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 14% ของอีก 1745 ตัวในหมวดนี้
- ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 100% ของอีก 1745 ตัวในหมวดนี้
เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo
คำถามที่พบบ่อย
MCP Nupay ปลอดภัยไหม?
จากการตรวจเบื้องต้นของเรา ผ่าน 1 จาก 1 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น
ต้องใช้กุญแจหรือรหัสอะไรบ้าง?
ต้องใส่ค่าเหล่านี้: NUPAY_MERCHANT_KEY, NUPAY_MERCHANT_TOKEN, NUPAY_CLIENT_SECRET
ตัวนี้รันบนเครื่องหรือบนคลาวด์?
รันบนเครื่องของคุณ โปรแกรม AI จะเปิด server ขึ้นมาเองเมื่อใช้ ข้อมูลไม่ต้องผ่านเซิร์ฟเวอร์ของผู้ทำ (ยกเว้นตัวที่ไปเรียกบริการออนไลน์ต่อ)
ยังมีคนดูแลอยู่ไหม?
repo บน GitHub มีการแก้โค้ดล่าสุด – และส่งรุ่นล่าสุด (0.2.2) เข้า registry 5 เดือนที่ผ่านมา
ใช้กับโปรแกรมไหนได้บ้าง?
โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต้องมี Node.js ในเครื่องด้วย
มีตัวไหนใช้แทนได้บ้าง?
ในหมวดเดียวกันมี Spree Commerce: open-source B2B and marketplace ecommerce, Stripe MCP, MCP Cn Commerce
ตัวที่ใช้แทนได้
server หมวดเดียวกันจากผู้ทำคนอื่น เรียงตามดาว
อ่านการ์ด:★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi
Stripe MCP
server ทางการของ Stripe ให้ AI ดูและจัดการลูกค้า สินค้า การชำระเงิน และใบแจ้งหนี้ ต่อผ่านคลาวด์ของ Stripe และล็อกอินแบบ OAuth
MCP Cn Commerce
8 read-only MCP platform entries; support is operation-specific; merchant live acceptance pending
README จากผู้ทำ
เปิดอ่าน README
ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ
@codespar/mcp-nupay
MCP server for NuPay — Nubank's merchant checkout rail.
NuPay is Nubank's answer to PayPal / Shop Pay for Brazil: a wallet-backed checkout that leverages Nubank's 100M+ BR customer distribution. Agents create a payment, the shopper confirms inside the Nubank app (push + biometric) or via Pix, and funds settle to the merchant. Pre-authorized flows (CIBA / OTP) unlock recurrence and true one-click for repeat buyers.
Tools (22)
| Tool | Purpose |
|---|---|
create_payment | Create a NuPay checkout payment. |
get_payment | Retrieve full payment details (amount, shopper, items, current status, timestamps) by pspReferenceId. |
get_payment_status | Retrieve a payment's status by pspReferenceId. |
list_payments_by_date | List payments created within a date range. |
cancel_payment | Cancel a payment that has not yet been captured/settled. |
create_refund | Refund a settled payment (full or partial). |
get_refund | Retrieve refund status by pspReferenceId + refundId. |
list_refunds | List all refunds issued against a given payment. |
create_recipient | Register a final beneficiary (required for regulatory split payments). |
get_recipient | Retrieve a registered recipient by referenceId. |
update_recipient | Update a registered final beneficiary (name, document, country, type). |
delete_recipient | Remove a registered recipient. |
list_recipients | List registered recipients (final beneficiaries) for the merchant. |
list_settlements | List settlement reports (payouts to the merchant bank account) within a date range. |
get_settlement | Retrieve a single settlement (payout batch) including the list of underlying transactions. |
query_payment_conditions | Query available installment/payment conditions for a given amount and (optionally) shopper CPF. |
create_preauth_payment | Create a NuPay payment using a pre-authorized Bearer access_token (pre-auth / recurrence flow). |
backchannel_start | Start a CIBA / OTP pre-authorization for a shopper. |
backchannel_complete | Complete a CIBA/OTP flow by submitting the OTP the shopper received. |
backchannel_resend_otp | Resend the OTP to the shopper for an in-flight authorization ticket. |
exchange_token | Exchange an authorization_code or refresh_token at POST /v1/token. |
revoke_token | Revoke an issued access_token or refresh_token at POST /v1/token/revoke. |
Install
npm install @codespar/mcp-nupay
Environment
NUPAY_MERCHANT_KEY="..." # X-Merchant-Key issued to your merchant
NUPAY_MERCHANT_TOKEN="..." # X-Merchant-Token (secret) NUPAY_CLIENT_ID="..." # Optional — OAuth client_id for pre-auth / recurrence NUPAY_CLIENT_SECRET="..." # Optional — OAuth client_secret NUPAY_ENV="sandbox" # sandbox (default) | production
Authentication
Two flows:
- Standard merchant API (payments, refunds, recipients, payment-conditions) uses
X-Merchant-Key+X-Merchant-Tokenheaders. No token exchange. - Pre-authorized / recurrence uses OAuth2 + CIBA / OTP. Start with
backchannel_start, validate viabackchannel_complete, then callcreate_preauth_paymentwith the returned Beareraccess_token. Refresh withexchange_token(grant_type=refresh_token). Access tokens expire in 5 minutes; refresh tokens should be stored long-term for recurrence.
Base URLs are derived from NUPAY_ENV:
| Sandbox | Production | |
|---|---|---|
| API | https://sandbox-api.spinpay.com.br | https://api.spinpay.com.br |
| Auth | https://sandbox-authentication.spinpay.com.br/api | https://authentication.spinpay.com.br/api |
JWT client_assertion signing is the caller's responsibility — exchange_token expects an already-signed assertion with client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer.
Run
# stdio (default)
npx @codespar/mcp-nupay
HTTP
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-nupay
Enterprise
Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.
License
MIT