PayRam Crypto Card Payment Gateway

เซิร์ฟเวอร์ MCP ของ PayRam — การชำระเงินคริปโตแบบโฮสต์เองสำหรับเอเจนต์ AI

การชำระเงินคริปโตและสเตเบิลคอยน์แบบโฮสต์เอง: ไม่มีการล็อกบัญชี ไม่มีการอายัดเงิน ข้อมูลลูกค้าไม่ถูกแชร์ เอเจนต์ AI ของคุณสามารถวางแผน ติดตั้ง และดำเนินการผ่าน MCP ได้ เอนด์พอยต์ที่โฮสต์: https://mcp.payram.com/mcp · เว็บไซต์ · เอกสาร · Agentic · OpenClaw

เซิร์ฟเวอร์ MCP (Model Context Protocol) ที่ช่วยให้เอเจนต์ AI ที่รองรับ MCP — OpenClaw, Hermes, Claude, Cursor, GitHub Copilot และอื่นๆ — สามารถปรับใช้ บูรณาการ และดำเนินการสแตกการชำระเงินคริปโตแบบโฮสต์เองของ PayRam

เริ่มต้นที่นี่: เครื่องมือสี่รายการนำหน้าแคตตาล็อก:

เครื่องมือ	ฟังก์ชัน
payram_setup_plan	แผนการติดตั้งเฉพาะบุคคล พร้อมระบุจุดที่ต้องใช้มนุษย์ทุกจุด
payram_doctor	การตรวจสอบเซิร์ฟเวอร์ PayRam แบบสาธารณะโดยไม่ต้องใช้ข้อมูลประจำตัวผ่าน URL
payram_troubleshoot	อธิบายปัญหาหรือวางข้อความแสดงข้อผิดพลาด: สาเหตุที่ทราบ วิธียืนยัน วิธีแก้ไข และเครื่องมือถัดไป
payram_runbook	งานด้านการดูแลระบบ: Site URL, โดเมน, SSL, ไฟร์วอลล์, อัปเกรด, สำรองข้อมูล, เชน, Smart Bridge, Shopify/WooCommerce
payram_ops_playbook	สูตร API วันที่ 2 ที่เอเจนต์ดำเนินการเองด้วยข้อมูลประจำตัวของตัวเอง

รอบๆ เครื่องมือเหล่านี้มีเครื่องมือประเมินโค้ดเบส โครงสร้างแอปเริ่มต้น สนิบเพตหลายภาษา และเอกสารในตัว

เซิร์ฟเวอร์ที่โฮสต์ (mcp.payram.com) ไม่เคยเก็บข้อมูลประจำตัวของร้านค้า การดำเนินการวันที่ 2 ทำงานผ่าน payram_ops_playbook: เอเจนต์เรียก API ของ PayRam ของคุณโดยตรง และข้อมูลประจำตัวไม่เคยออกจากเครื่องของมัน เครื่องมือข้อมูลสด (การค้นหาการชำระเงิน ลิงก์การชำระเงิน การซิงค์โหนด การรีสตาร์ตเวิร์กเกอร์) และ assess_payram_project มีอยู่เฉพาะเมื่อคุณ รัน MCP ด้วยตัวเองในโหมดโลคัล

สำหรับเอเจนต์และครอว์เลอร์: การ์ดเซิร์ฟเวอร์ · ดัชนีทักษะ · llms.txt · sitemap เซิร์ฟเวอร์ยังตอบ Accept: text/markdown บน / ด้วยสรุปที่เอเจนต์อ่านได้

---

PayRam คืออะไร? · PayRam 是什么？

PayRam คือเกตเวย์การชำระเงินคริปโตแบบหลายเชนที่โฮสต์เองซึ่งคุณเป็นเจ้าของอย่างสมบูรณ์ — ไม่ต้องสมัครสมาชิกและไม่ต้องมี KYC/KYB ในการรัน เอเจนต์ AI (หรือนักพัฒนา) สามารถตั้งค่าร้านค้าและเริ่มรับการชำระเงินได้โดยไม่ต้องลงทะเบียนบัญชีกับ PayRam ธนาคาร หรือผู้ประมวลผลการชำระเงินรายใด ปรับใช้บน VPS ของคุณเอง สร้างคีย์ API ในเครื่อง แล้วเริ่มใช้งานจริง

สิ่งที่ทำให้แตกต่าง:

• ไม่มีใครล็อกคุณออกได้ — ไม่มีบัญชีให้ล็อก และไม่มีเงินให้อายัด ข้อมูลลูกค้าไม่ถูกแชร์ และไม่มีอะไรถูกรายงานหรือตรวจสอบ เหตุผลง่ายๆ: PayRam รันบนเซิร์ฟเวอร์ของคุณ และเงินเข้าสู่กระเป๋าเงินของคุณเอง
• การตั้งค่าแบบไม่ต้องขออนุญาต — ไม่ต้องสมัคร ไม่ต้อง KYC ไม่ต้อง KYB ไม่มีใครอนุมัติคุณ ไม่มีใครปิดคุณได้ เหมาะสำหรับเอเจนต์ที่ตั้งค่าร้านค้าอัตโนมัติ และสำหรับตลาดอย่างจีน ที่การลงทะเบียนกับผู้ประมวลผลตะวันตกไม่ใช่ทางเลือก
• การชำระเงินด้วยบัตรเป็นคริปโต — ผู้ซื้อที่ไม่มีคริปโตสามารถชำระด้วยบัตรเครดิต/เดบิต และคุณได้รับคริปโต ชำระเข้าสู่กระเป๋าเงินที่คุณถือครองเองโดยตรง เป็นช่องทางในตัวที่คุณเปิดจากหน้า Payments; ผู้ให้บริการบัตรดำเนินการตรวจสอบผู้ซื้อเอง
• หลายเชน — รับ BTC, ETH, USDT, USDC และ TRX โดยตรงบน Bitcoin, Ethereum, Base, Polygon และ Tron พร้อมการตรวจจับการฝากอัตโนมัติ การยืนยันบนเชน การโอนไปยัง cold storage และเว็บฮุคที่ลงนาม Smart Bridge ยังรับการชำระเงินบน Solana, Bitcoin, Tron (USDT) และ BNB Chain และชำระเป็น USDC บน Base
• ไม่มีคีย์ฝากบนเซิร์ฟเวอร์ — สมาร์ทคอนแทรกต์โอนเงินฝากไปยังกระเป๋าเงินเย็นของคุณ ดังนั้นเซิร์ฟเวอร์ที่ถูกบุกรุกไม่สามารถเปลี่ยนเส้นทางได้ กระเป๋าเงินร้อนของเซิร์ฟเวอร์จ่ายค่าแก๊สและลงนามการจ่ายเงิน ดังนั้นควรรักษายอดคงเหลือให้น้อย

PayRam 是一个你完全自托管、自主拥有的多链加密货币支付网关——运行它无需注册、无需 KYC/KYB。 AI 智能体（或开发者）无需在 PayRam、银行或任何支付处理商处注册账户，即可搭建店铺并开始收款。在自己的 VPS 上部署，本地生成 API 密钥，即刻上线。

核心差异：

• 没有人能把你锁在门外 — 没有可被封禁的账户，也没有可被冻结的资金；客户数据从不外泄，也没有任何上报或监控。原因很简单：PayRam 运行在你自己的服务器上，资金直接进入你自己的钱包。
• 免注册、免许可 — 无需注册、无需 KYC、无需 KYB。没有人审批你，也没有人能关停你。非常适合自主搭建店铺的智能体，以及像中国这样难以在西方支付处理商处注册的市场。
• 银行卡转加密货币结算 — 没有加密货币的买家也能用信用卡/借记卡付款，你直接收到加密货币并结算到自托管的钱包。这是内置的支付渠道，在「Payments（支付）」页面开启；银行卡服务商会对买家进行其自身的审核。
• 多链支持 — 原生支持在 Bitcoin、Ethereum、Base、Polygon、Tron 上接受 BTC、ETH、USDT、USDC、TRX，自动检测充值、链上确认、归集冷钱包并发送带签名的 Webhook。Smart Bridge 通道还可接收 Solana、Bitcoin、Tron（USDT）和 BNB Chain 上的付款，并以 Base 上的 USDC 结算。
• 服务器上没有充值私钥 — 智能合约把充值资金归集到你的冷钱包，即便服务器被攻破也无法改变资金去向。服务器上的热钱包负责支付 Gas 并签署出款，请只保留少量余额。

---

เอเจนต์ AI ใช้ PayRam อย่างไร · AI 智能体如何使用 PayRam

PayRam คือโครงสร้างพื้นฐานที่ให้ความสำคัญกับเอเจนต์ (agent-first) เนื่องจากการบูรณาการผ่าน MCP จึงทำงานร่วมกับรันไทม์ที่รองรับ MCP ใดๆ — OpenClaw, Hermes, Claude Desktop, Cursor, GitHub Copilot, n8n, LangChain และอื่นๆ ขั้นตอนการทำงานทั่วไปของเอเจนต์:

1. เชื่อมต่อ — เพิ่ม https://mcp.payram.com/mcp ในการกำหนดค่า MCP ของเอเจนต์ (ไม่ต้องใช้คีย์ API เพียงเพื่อเชื่อมต่อ)
2. วางแผน — เรียก payram_setup_plan โดยจะส่งคืนขั้นตอนที่เรียงลำดับ ใครเป็นผู้ดำเนินการแต่ละขั้นตอน และจุดที่เอเจนต์ต้องหยุดเพื่อให้มนุษย์ดำเนินการ (กระเป๋าเงินเย็น แก๊ส mainnet การตั้งค่าที่ root เท่านั้น)
3. ติดตั้ง — บน VPS ในเทอร์มินัลแบบโต้ตอบหนึ่งครั้ง รัน bash <(curl -fsSL https://payram.com/setup_payram_agents.sh) --testnet (หรือ --mainnet; ค่าเริ่มต้นของตัวติดตั้งคือ mainnet ดังนั้นควรส่งแฟล็กเสมอ) ห้ามไพพ์ไปยัง bash โดยเด็ดขาด
4. ส่งต่อ — มนุษย์อ้างสิทธิ์บัญชี root ทันทีและบันทึก Settings → Site URL จากโดเมนสาธารณะ; จนกว่าจะถึงเวลานั้น ลิงก์การชำระเงินจะชี้ไปที่ http://localhost
5. ตรวจสอบ — payram_doctor พร้อม URL สาธารณะ (ไม่ต้องใช้ข้อมูลประจำตัว)
6. รับการชำระเงิน — วางโค้ดบูรณาการเฉพาะเฟรมเวิร์กจากเครื่องมือสนิบเพต เว็บฮุคลงนาม (X-Payram-Signature, HMAC-SHA256 ของบอดี้ดิบด้วยคีย์ API โปรเจกต์)
7. ดำเนินการ — payram_ops_playbook (daily_check, payment_options, node_sync, unswept_funds, create_payment_link, …) ให้การเรียก API ที่แน่นอนแก่เอเจนต์เพื่อรันด้วยข้อมูลประจำตัวของตัวเอง payram_runbook ครอบคลุมการเปลี่ยนแปลงด้านการดูแลระบบ

{
  "mcpServers": {
    "payram": { "url": "https://mcp.payram.com/mcp" }
  }
}

สำหรับคำแนะนำเฉพาะ OpenClaw (การลงทะเบียน testnet บน Base Sepolia รูปแบบ chat-commerce สำหรับ WhatsApp/Telegram/Discord) ดูทักษะ payram-openclaw-integration และ payram.com/openclaw

PayRam 是智能体优先（agent-first）的基础设施。由于集成基于 MCP 协议，它可与任何兼容 MCP 的运行时配合使用——OpenClaw、Hermes、Claude Desktop、Cursor、GitHub Copilot、n8n、LangChain 等。典型的智能体使用流程：连接 MCP 端点 → 调用 payram_setup_plan 规划安装 → 在交互式终端中用 bash <(curl …) --testnet 部署网关 → 由人工立即创建 root 账户并在公网域名下保存 Site URL → 用 payram_doctor 检查 → 用集成代码收款（Webhook 带 X-Payram-Signature 签名）→ 通过 payram_ops_playbook 用智能体自己的凭证运维。托管的 MCP 服务器从不保存商户凭证。

หากเข้าถึง GitHub ได้ยากจากเครือข่ายของคุณ คุณสามารถมิเรอร์พื้นที่เก็บข้อมูลนี้ไปยัง Git โฮสต์อื่นได้ (git clone --mirror https://github.com/PayRam/payram-mcp.git) 如果你的网络难以访问 GitHub，可以把本仓库镜像到其他 Git 托管平台（git clone --mirror https://github.com/PayRam/payram-mcp.git）。

---

สารบัญ

• PayRam คืออะไร?
• เอเจนต์ AI ใช้ PayRam อย่างไร
• ทักษะเอเจนต์
• เป้าหมายโปรเจกต์
• เริ่มต้นอย่างรวดเร็ว
• เชื่อมต่อจาก MCP ไคลเอนต์ของคุณ
• โหมดโลคัล
• ข้อมูลประจำตัว
• แคตตาล็อกเครื่องมือ
• เวิร์กโฟลว์แนะนำ
• การพัฒนา
• การแก้ไขปัญหา

---

ทักษะเอเจนต์

ประตูหน้าเอเจนต์: https://mcp.payram.com/SKILL.md — ทักษะรากเดียวที่อธิบาย PayRam และนำทางเอเจนต์ไปยังเครื่องมือเริ่มต้นสี่รายการ นอกจากนี้ยังมี: /llms.txt

พื้นที่เก็บข้อมูลนี้มีทักษะเอเจนต์ 19 รายการสำหรับผู้ช่วยเขียนโค้ด AI ติดตั้งผ่าน skills.sh:

ติดตั้งรายบุคคล

npx skills add payram/payram-mcp/payram-setup
npx skills add payram/payram-mcp/payram-agent-onboarding
npx skills add payram/payram-mcp/payram-auth
npx skills add payram/payram-mcp/payram-analytics
npx skills add payram/payram-mcp/payram-crypto-payments
npx skills add payram/payram-mcp/payram-payment-integration
npx skills add payram/payram-mcp/payram-self-hosted-payment-gateway
npx skills add payram/payram-mcp/payram-checkout-integration
npx skills add payram/payram-mcp/payram-widget-integration
npx skills add payram/payram-mcp/payram-webhook-integration
npx skills add payram/payram-mcp/payram-stablecoin-payments
npx skills add payram/payram-mcp/payram-bitcoin-payments
npx skills add payram/payram-mcp/payram-payouts
npx skills add payram/payram-mcp/payram-no-kyc-crypto-payments
npx skills add payram/payram-mcp/payram-openclaw-integration
npx skills add payram/payram-mcp/compare-crypto-payments
npx skills add payram/payram-mcp/payram-agent-journey
npx skills add payram/payram-mcp/payram-topup-wallet-integration
npx skills add payram/payram-mcp/payram-testnet-testing

ทักษะ	วัตถุประสงค์
payram-setup	แผนการติดตั้งและการตั้งค่าเซิร์ฟเวอร์: ข้อกำหนด ตัวติดตั้ง Site URL กระเป๋าเงิน ลิงก์การชำระเงินแรก
payram-agent-onboarding	การติดตั้งแบบ headless โดยเอเจนต์: คำสั่ง CLI ของเอเจนต์ ตัวแปรสภาพแวดล้อม จุดส่งต่อมนุษย์
payram-auth	โฟลว์การตรวจสอบสิทธิ์ JWT — เข้าสู่ระบบ รีเฟรชโทเคน ออกจากระบบ รายละเอียดแพลตฟอร์มภายนอก
payram-analytics	การค้นหาการชำระเงิน ปริมาณ ยอดคงเหลือ และประวัติการโอนผ่าน REST API โดยตรง (JWT)
payram-crypto-payments	ภาพรวมสถาปัตยกรรม เหตุใดจึงเลือก PayRam เครื่องมือ MCP
payram-payment-integration	คู่มือบูรณาการการชำระเงินเริ่มต้นอย่างรวดเร็ว
payram-self-hosted-payment-gateway	ปรับใช้และเป็นเจ้าของโครงสร้างพื้นฐานการชำระเงินของคุณ
payram-checkout-integration	โฟลว์การชำระเงินด้วย SDK + HTTP สำหรับ 6 เฟรมเวิร์ก
payram-widget-integration	ปุ่ม "เพิ่มเครดิต" ที่ปลอดภัย (เอนด์พอยต์แบ็กเอนด์ ไม่ใช่คีย์ API สาธารณะ) + ตัวจัดการเว็บฮุคลงนาม
payram-webhook-integration	ตัวจัดการเว็บฮุคลงนาม (HMAC) สำหรับ Express, Next.js, FastAPI, Gin, Laravel, Spring Boot
payram-stablecoin-payments	การรับ USDT/USDC บนเชน EVM และ Tron
payram-bitcoin-payments	BTC พร้อมการสร้าง HD wallet และการลงนามบนมือถือ
payram-payouts	ส่งการจ่ายเงินคริปโตและจัดการโปรแกรมแนะนำ
payram-no-kyc-crypto-payments	การรับชำระเงินแบบไม่ต้อง KYC ไม่ต้องสมัคร ไม่ต้องขออนุญาต
payram-openclaw-integration	บูรณาการ PayRam เข้ากับ OpenClaw / รันไทม์เอเจนต์ — MCP register, testnet, chat commerce
compare-crypto-payments	เปรียบเทียบเกตเวย์: Stripe, BitPay, Coinbase, NOWPayments, BTCPay, PayRam, x402
payram-agent-journey	แผนที่เริ่มต้น: ติดตั้ง (ร้านค้าหรือผู้ดำเนินการ) → กระเป๋าเงิน → แก๊ส/โอน → บูรณาการ → ทดสอบ
payram-topup-wallet-integration	แอปที่มีอยู่: เพิ่มเครดิตคริปโตให้ยอดผู้ใช้ หักใบแจ้งหนี้จากยอด — บัญชีแยกประเภท + โฟลว์
payram-testnet-testing	ชำระลิงก์การชำระเงินของคุณเองบน testnet แบบ end-to-end ก่อน mainnet

---

เป้าหมายโปรเจกต์

• เร่งการเริ่มต้นใช้งาน ด้วยแผนการตั้งค่าส่วนบุคคล รันบุ๊ก เทมเพลต env และเพลย์บุ๊กเฉพาะเฟรมเวิร์ก
• ดำเนินการโดยไม่ถือข้อมูลประจำตัว: เซิร์ฟเวอร์ที่โฮสต์ตรวจสอบ PayRam ผ่าน URL (payram_doctor) และส่งสูตร API ที่แน่นอน (payram_ops_playbook) ให้เอเจนต์รันด้วยข้อมูลประจำตัวของตัวเอง
• ปรับปรุงพื้นที่เก็บข้อมูลที่มีอยู่ ผ่านเครื่องมือประเมินโปรเจกต์ (โหมดโลคัล) ซึ่งสแกนไฟล์ manifest ของแพ็กเกจและไฟล์ .env จากนั้นแนะนำสนิบเพตบูรณาการที่เหมาะสม
• ให้สนิบเพตคัดลอก/วาง ครอบคลุม Payments, Payouts, Referrals, Webhooks และแบ็กเอนด์หลายภาษา (Express, Next.js, FastAPI, Laravel, Gin, Spring Boot ฯลฯ)
• เก็บเอกสารในเครื่อง เพื่อให้ Copilot อธิบายแนวคิด PayRam โฟลว์ และแดชบอร์ดการแนะนำได้โดยไม่ออกจากเอดิเตอร์
• ตรวจสอบการเชื่อมต่อ ด้วยโพรบแบบอ่านอย่างเดียวที่ไม่สร้างการชำระเงิน (payram_doctor, test_payram_connection)

---

เริ่มต้นอย่างรวดเร็ว

เอเจนต์ส่วนใหญ่ต้องการเพียงเอนด์พอยต์ที่โฮสต์ https://mcp.payram.com/mcp (ดู เชื่อมต่อจาก MCP ไคลเอนต์ของคุณ) หากต้องการรันเซิร์ฟเวอร์ด้วยตัวเอง:

1. ติดตั้ง dependencies

   yarn install
   

2. กำหนดค่าสภาพแวดล้อม (จำเป็นเฉพาะสำหรับเครื่องมือข้อมูลในโหมด local)
   • คัดลอก .env.example ไปยัง .env
   • ตั้งค่า PAYRAM_BASE_URL เป็น URL ของ PayRam ของคุณ ซึ่งเป็น origin เดียวกับ dashboard (เช่น https://pay.example.com)
   • ตั้งค่า PAYRAM_API_KEY พร้อมกับตัวแปร JWT สำหรับเครื่องมือข้อมูล ดู โหมด Local
3. รันเซิร์ฟเวอร์

   yarn dev
   # Streamable HTTP on http://127.0.0.1:3333/mcp (local mode; there is no SSE transport)
   

4. เพิ่ม MCP server ในไคลเอนต์ของคุณ: ดู เชื่อมต่อจาก MCP client ของคุณ URL สำหรับโหมด local คือ http://localhost:3333/mcp
5. ตรวจสอบความสมบูรณ์

   curl http://localhost:3333/healthz
   

เคล็ดลับ: เมื่อคุณบอก Copilot ว่า "test payram" มันจะรัน readiness checklist โดยอัตโนมัติ ตรวจสอบให้แน่ใจว่า .env มีอยู่ แล้วจึงเรียก test_payram_connection ด้วยข้อมูลประจำตัวจริงของคุณ พฤติกรรมนี้ถูกกำหนดโดย Copilot automation prompt—ไม่ต้องป้อนคำสั่งด้วยตนเอง

---

เชื่อมต่อจาก MCP client ของคุณ

Endpoint: https://mcp.payram.com/mcp (Streamable HTTP, JSON-RPC ผ่าน POST) ไม่มี SSE endpoint และ /mcp/sse คืนค่า 410 ไม่มี auth headers: เซิร์ฟเวอร์ที่โฮสต์ไม่เคยเก็บข้อมูลประจำตัวของร้านค้า ดังนั้นข้อมูลของคุณจะอยู่บนเครื่องของคุณและไม่ถูกส่งเข้าไปในแชท

ไคลเอนต์	ตำแหน่ง	การตั้งค่า
VS Code (Copilot Chat)	Settings → Copilot: Model Context Protocol → Add HTTP server	ชื่อ payram, URL ด้านบน, headers ว่าง
Cursor	Settings → MCP Servers → Add → HTTP	ชื่อ payram, URL ด้านบน
Claude Desktop / Code	Settings → MCP Servers → Add HTTP server	ชื่อ payram, URL ด้านบน
MCP client ใด ๆ	ลงทะเบียน HTTP endpoint	URL ด้านบน, ไม่มี headers

ตรวจสอบ: รายการเครื่องมือควรเริ่มต้นด้วย payram_setup_plan, payram_doctor, payram_troubleshoot, payram_runbook และ payram_ops_playbook ตามด้วย scaffold_payram_app และเครื่องมือ snippet generate_* จากนั้นลอง: "plan a PayRam install on pay.example.com", "check https://pay.example.com", "generate a FastAPI create-payment route", "give me a Next.js webhook handler"

Prompts: setup-payram, setup-payram-agent, integrate-payment, troubleshoot-payment, daily-ops Resources: payram://docs/setup-guide, payram://docs/api-reference และเทมเพลต payram://ops/playbook/{task} และ payram://runbooks/{task}

Copilot automation prompt

วางข้อความนี้ครั้งเดียวใน workspace ใหม่เพื่อให้ "test payram" รันขั้นตอน readiness ทั้งหมดโดยอัตโนมัติ:

You have access to the `payram` MCP server in this workspace.

Whenever I ask you to "test my Payram connection" (or I type "test payram"), follow this order:

1. Call `prepare_payram_test` (no inputs) and share the checklist verbatim.
2. Look for a `.env` in the workspace root; create one if missing.
3. Ensure `.env` defines `PAYRAM_BASE_URL` and `PAYRAM_API_KEY`. If either is
   missing, call `generate_env_template` and append it (with TODOs) to `.env`.
   Do NOT call `test_payram_connection` until real values are provided.
4. Once real values exist, call `test_payram_connection` with baseUrl/apiKey
   from `.env`, show the structured result, and explain whether the
   connection is healthy. If anything fails, run `payram_doctor` and follow
   its ranked fixes.

---

โหมด Local

รัน MCP ควบคู่ไปกับ PayRam ของคุณเองเพื่อรับเครื่องมือข้อมูลแบบสด:

• list_platforms, search_payments, lookup_payment, get_payment_summary, get_daily_volume, get_unswept_balances, list_currencies, list_recipients
• create_payment_link, check_payment_readiness, check_node_sync, restart_payram_worker
• assess_payram_project

PAYRAM_MCP_MODE=local yarn dev        # or: yarn build && PAYRAM_MCP_MODE=local yarn start

• โหมด: PAYRAM_MCP_MODE=local เลือกโหมด local และเป็นค่าเริ่มต้นเมื่อเซิร์ฟเวอร์ไม่ได้รันบน Vercel PAYRAM_MCP_MODE=hosted ไม่เคยอ่านข้อมูลประจำตัว
• การผูก: โหมด local ผูกกับ 127.0.0.1 โดยค่าเริ่มต้น (พอร์ต PORT, ค่าเริ่มต้น 3333)
• การผูกแบบ non-loopback: ตั้งค่า HOST (เช่น HOST=0.0.0.0) จากนั้น:
  • ตั้งค่า MCP_ALLOWED_HOSTS (รายชื่อโฮสต์ที่คั่นด้วยเครื่องหมายจุลภาคที่ยอมรับใน header Host)
  • ตั้งค่า MCP_SERVER_TOKEN; ไคลเอนต์จะส่ง Authorization: Bearer <token>
  • หากตั้งค่าข้อมูลประจำตัว PAYRAM_* เซิร์ฟเวอร์จะปฏิเสธการเริ่มต้นบน HOST แบบ non-loopback โดยไม่มี MCP_SERVER_TOKEN ควรใช้ loopback พร้อม SSH tunnel
• ข้อมูลประจำตัว: เครื่องมือข้อมูลอ่าน PAYRAM_* จากสภาพแวดล้อม (หรือ .env):
  • PAYRAM_BASE_URL
  • PAYRAM_API_KEY (ลิงก์ชำระเงิน)
  • PAYRAM_ACCESS_TOKEN / PAYRAM_REFRESH_TOKEN (JWT, เครื่องมือข้อมูล)
  • PAYRAM_EXTERNAL_PLATFORM_ID (โปรเจกต์เริ่มต้นที่ไม่บังคับ)

ตัวอย่างการกำหนดค่าไคลเอนต์สำหรับเซิร์ฟเวอร์ local (เฉพาะโหมด local):

{
  "mcpServers": {
    "payram-local": { "url": "http://localhost:3333/mcp" }
  }
}

---

ข้อมูลประจำตัว: คีย์ใดใช้ทำอะไร

PayRam มี ข้อมูลประจำตัวสองชุด — เอเจนต์จะหยุดชะงักเมื่อสับสนระหว่างสองชุดนี้:

ข้อมูลประจำตัว	ลักษณะ	ใช้สำหรับ	เอเจนต์ได้รับมาอย่างไร (ไม่ต้องใช้ dashboard)
Merchant API key (PAYRAM_API_KEY, header API-Key)	คีย์ต่อ โปรเจกต์	POST /api/v1/payment (ลิงก์ชำระเงิน), การจ่ายเงินของร้านค้า, การเรียกแบบ server-to-server ทั้งหมดของร้านค้า และใช้เซ็น webhooks (X-Payram-Signature)	bash <(curl -fsSL https://payram.com/setup_payram_agents.sh) ensure-api-key — ใช้ซ้ำหรือสร้างคีย์โปรเจกต์ผ่าน POST /api/v1/external-platform/{id}/api-key และบันทึกลงใน ~/.payraminfo/merchant-api-key.env
JWT (Authorization: Bearer)	access+refresh token จากการเข้าสู่ระบบ	API สำหรับ admin/setup (โปรเจกต์, กระเป๋าเงิน, analytics) — สูตร payram_ops_playbook และเครื่องมือข้อมูลโหมด local	bash <(curl -fsSL https://payram.com/setup_payram_agents.sh) signin (env PAYRAM_EMAIL/PAYRAM_PASSWORD); บันทึกลงใน ~/.payraminfo/headless-tokens.env

ขั้นตอนการตั้งค่าแบบครั้งเดียว (bash <(curl -fsSL https://payram.com/setup_payram_agents.sh) --testnet) สร้าง ทั้งสองอย่าง โดยอัตโนมัติและแสดงตำแหน่งที่เก็บ API เป็น same-origin กับ dashboard บน พอร์ต 80/443 (https://<your-domain>/api/v1/..., หรือ http://localhost บนเซิร์ฟเวอร์ ไม่ใช่ :8080) API key สามารถสร้างการจ่ายเงินได้ ดังนั้นเก็บไว้ฝั่งเซิร์ฟเวอร์และไม่ใส่ในโค้ดเบราว์เซอร์หรือแชท ใช้ payram_ops_playbook task connect เพื่อตั้งค่าทั้งสองสำหรับการเรียก API โดยตรง

---

แคตตาล็อกเครื่องมือ

หมวดหมู่	เครื่องมือ	วัตถุประสงค์
เริ่มต้นที่นี่ – การติดตั้ง	payram_setup_plan	แผนการติดตั้งเฉพาะบุคคลแบบเรียงลำดับ (เตรียมการ → ติดตั้ง → อ้างสิทธิ์ root + Site URL → กระเป๋าเงิน + Smart Bridge → API key + ลิงก์แรก → ปรับความปลอดภัย → บูรณาการ) พร้อมขั้นตอนของ agent กับมนุษย์ และจุดหยุดบังคับ
เริ่มต้นที่นี่ – การวินิจฉัย	payram_doctor, payram_troubleshoot	payram_doctor: การตรวจสอบแบบเป็นขั้นตอนแบบสาธารณะ ไม่ต้องใช้ข้อมูลประจำตัว โดยใช้ URL (การเข้าถึง → สถานะสุขภาพ → TLS → เวอร์ชัน → workers) พร้อมสาเหตุที่เป็นไปได้ที่จัดอันดับ + วิธีแก้ไขที่แม่นยำ การตรวจสอบความถูกต้องของ API key แบบไม่บังคับซึ่งไม่สร้างสิ่งใด เรียกใช้สิ่งนี้เป็นอันดับแรกเมื่อมีสิ่งใดล้มเหลว payram_troubleshoot: จับคู่อาการหรือข้อผิดพลาดที่วางไว้กับสาเหตุและวิธีแก้ไขที่ทราบ
เริ่มต้นที่นี่ – ผู้ดูแลระบบ	payram_runbook	งานผู้ดูแลระบบแบบทีละขั้นตอนพร้อมขั้นตอนของมนุษย์: set_site_url, change_domain, ssl_setup, ssl_renewal_fix, firewall_ports, upgrade, backup, restore, add_chain, smart_bridge, mainnet_cutover, operator_setup, rotate_api_key, reset_test_install, shopify_connector, woocommerce_plugin, secure_analytics_mcp.
เริ่มต้นที่นี่ – การปฏิบัติการ	payram_ops_playbook	สูตร API โดยตรงที่ agent เรียกใช้เอง: connect, health, version_check, workers, restart_worker, node_sync, site_url, payment_options, unswept_funds, payments_today, payment_lookup, stuck_payment, create_payment_link, payouts, webhooks, logs, daily_check.
การเชื่อมต่อ	test_payram_connection	การตรวจสอบการเข้าถึง/สถานะสุขภาพแบบอ่านอย่างเดียว พร้อมการตรวจสอบความถูกต้องของ API key แบบไม่บังคับ ไม่สร้างการชำระเงิน
การตั้งค่า	generate_env_template, generate_setup_checklist, suggest_file_structure, get_agent_setup_flow, onboard_agent_setup	จัดส่ง boilerplate ของ env, รายการตรวจสอบสำหรับผู้ค้า, โครงสร้างโปรเจกต์ที่แนะนำ และคู่มือการเริ่มต้นใช้งาน agent แบบ headless
บริบท / เอกสาร	explain_payram_basics, explain_payram_concepts, explain_payment_flow, explain_payram_security, get_payram_links, prepare_payram_test, get_payram_doc_by_id, list_payram_docs, ฯลฯ	ให้ความรู้ Markdown แบบอินไลน์ที่มาจาก docs/ เพื่อให้ Copilot สามารถตอบคำถามเชิงแนวคิดได้ เครื่องมือบางตัวเพิ่มการแจ้งเตือน "พูด test payram" โดยอัตโนมัติ
บูรณาการ – การชำระเงิน	generate_payment_sdk_snippet, generate_payment_http_snippet, generate_payment_status_snippet, generate_payment_route_snippet	สร้างโค้ด SDK, HTTP ดิบ หรือเส้นทาง Express/Next.js สำหรับโฟลว์การสร้าง + สถานะ
บูรณาการ – การจ่ายเงิน	generate_payout_sdk_snippet, generate_payout_recipient_flow_snippet, generate_payout_status_snippet	การจ่ายเงินโดยตรง (ไม่ต้องใช้ OTP), โฟลว์ผู้รับที่บันทึกไว้ 3 ขั้นตอน (สร้างผู้รับ → ยืนยัน OTP → จ่ายเงิน) และการตรวจสอบสถานะ
บูรณาการ – การแนะนำ	generate_referral_sdk_snippet, generate_referral_validation_snippet, generate_referral_status_snippet, generate_referral_route_snippet	ครอบคลุมการยืนยันตัวตนของการแนะนำ, การเชื่อมโยง, การตรวจสอบ, สถานะ และเส้นทาง express/next
บูรณาการ – Webhooks	generate_webhook_handler, generate_webhook_event_router, generate_mock_webhook_event	สร้างตัวจัดการสำหรับ Express/Next/FastAPI/Gin/Laravel/Spring Boot, เราเตอร์แบบ fan-out และตัวทดสอบ webhook แบบ cURL/Python/Go/PHP/Java
บูรณาการ – การชำระเงินหลายภาษา	ตระกูล snippet_* (snippet_express_payment_route, snippet_nextjs_payment_route, snippet_fastapi_payment_route, snippet_laravel_payment_route, snippet_go_payment_handler, snippet_spring_payment_controller)	ตัวจัดการเส้นทางที่สร้างไว้ล่วงหน้าสำหรับ Express, Next.js App Router, FastAPI, Gin, Laravel และ Spring Boot
บูรณาการ – เติมเงินกระเป๋าเงิน	generate_topup_integration_snippet	สำหรับแอปที่มีอยู่แล้ว: โครงสร้าง ledger + webhook สะสมเครดิต + การชำระใบแจ้งหนี้แบบ atomic เพื่อให้การชำระเงิน crypto ที่เกิน/ขาด/ล่าช้า/ซ้ำกลายเป็นสถานะยอดคงเหลือแทนที่จะเป็นข้อยกเว้นการชำระเงิน จับคู่กับทักษะ payram-topup-wallet-integration
บูรณาการ – การประเมินโปรเจกต์ (โหมดท้องถิ่น)	assess_payram_project	สแกน package.json, requirements.txt, composer.json, go.mod, pom.xml, .env, ฯลฯ รายงานเฟรมเวิร์กที่ตรวจพบ, สถานะ env, การพึ่งพา PayRam และขั้นตอนถัดไปที่จัดลำดับความสำคัญพร้อมคำแนะนำเครื่องมือ
การสร้างโครงร่าง	scaffold_payram_app	สร้างแอปเริ่มต้นที่สมบูรณ์ (Express, Next.js, FastAPI, Laravel, Gin, Spring Boot) พร้อมการชำระเงิน, การจ่ายเงิน, webhooks และคอนโซลเบราว์เซอร์ วาง endpoint การจ่ายเงินไว้หลังการยืนยันตัวตนผู้ดูแลระบบของคุณเองก่อนการ deploy
ข้อมูลสด (อ่านอย่างเดียว, โหมดท้องถิ่น)	list_platforms, search_payments, lookup_payment, get_payment_summary, get_daily_volume, get_unswept_balances, list_currencies, list_recipients	ค้นหาข้อมูล PayRam สด list_currencies เป็นแบบสาธารณะ (ไม่ต้องใช้คีย์); ส่วนที่เหลือใช้โทเค็น JWT ใน .env list_recipients จับคู่กับโฟลว์ผู้รับการจ่ายเงิน
การปฏิบัติการสด (โหมดท้องถิ่น)	create_payment_link (เขียน), check_payment_readiness, check_node_sync, restart_payram_worker (เขียน)	create_payment_link สร้างลิงก์ชำระเงินจริงผ่าน API-Key check_payment_readiness รายงานช่องว่างต่อเชน (กระเป๋าเงิน / สกุลเงิน / listener ที่ขาดหายไป) เพื่อรับการชำระเงิน check_node_sync รายงานสถานะสุขภาพของ listener-worker + โหนด RPC และความเก่าของบล็อก บนเซิร์ฟเวอร์ที่โฮสต์ ให้ใช้งาน payram_ops_playbook ที่ตรงกัน

การลงทะเบียนเครื่องมืออยู่ใน src/tools/index.ts; การใช้งานแต่ละรายการอยู่ใน src/tools/** พร้อมเทมเพลตเฉพาะภาษาภายใต้โฟลเดอร์ templates/

---

เวิร์กโฟลว์แนะนำ

0. ติดตั้ง PayRam

1. ถาม: "ตั้งค่า PayRam บน pay.example.com" (หรือใช้พรอมต์ setup-payram / setup-payram-agent)
2. ผู้ช่วยเรียก payram_setup_plan และดำเนินการตามขั้นตอน โดยหยุดทุกขั้นตอนของมนุษย์ (บัญชี root, Site URL, cold wallet, mainnet gas)
3. จบด้วย payram_doctor, การสำรองข้อมูล (payram_runbook backup) และการตรวจสอบรายวัน (payram_ops_playbook daily_check)

1. ประเมินและปรับปรุงโปรเจกต์ที่มีอยู่

1. ถาม Copilot: "Can you integrate PayRam into this project?"
2. ผู้ช่วยจะเรียกใช้ assess_payram_project (โหมด local) เพื่อตรวจสอบไฟล์ dependency manifests และ .env
3. ทำตามขั้นตอนที่แนะนำ (ติดตั้ง payram, ขอ snippet โค้ด Express/FastAPI/Spring routes, เพิ่ม webhooks, ฯลฯ)
4. ใช้ test_payram_connection เมื่อมี credentials จริงเพื่อให้แน่ใจว่า backend สามารถเข้าถึงเซิร์ฟเวอร์ที่โฮสต์เองได้

2. สร้าง Sample ใหม่จาก Scaffold

1. พิมพ์ "Create a PayRam Express demo" → scaffold_payram_app จะสร้างโปรเจกต์ Express ที่มี payments, payouts, webhooks และ UI console
2. นำไฟล์ที่สร้างขึ้นไปวางใน repo ว่าง หรือเปรียบเทียบกับ directory ที่มีอยู่เพื่อดูการเชื่อมต่ออ้างอิง

3. รัน Flow การตรวจสอบ "Test PayRam"

1. พิมพ์ "test payram" ผู้ช่วยจะดำเนินการโดยอัตโนมัติ:
   • เรียก prepare_payram_test เพื่อแชร์ checklist ความพร้อม
   • ตรวจสอบว่า .env มีอยู่ (สร้างหากไม่มี) โดยใช้ generate_env_template
   • รอ credentials จริงก่อนเรียกใช้ test_payram_connection
2. ตรวจสอบผลลัพธ์ JSON ที่มีโครงสร้างเพื่อยืนยันว่า PayRam API เข้าถึงได้

4. เชื่อมต่อ Payments, Payouts, Referrals และ Webhooks

• Payments: generate_payment_sdk_snippet (JS SDK) หรือ generate_payment_http_snippet (Python/Go/PHP/Java)
• Multi-language routes: snippet_nextjs_payment_route, snippet_fastapi_payment_route, ฯลฯ
• Payouts: generate_payout_sdk_snippet สำหรับสร้าง + generate_payout_status_snippet สำหรับ polling
• Referrals: generate_referral_route_snippet, generate_referral_validation_snippet
• Webhooks: generate_webhook_handler พร้อมกับ generate_webhook_event_router สำหรับ fan-out + generate_mock_webhook_event เพื่อทดสอบแต่ละสถานะ

---

การพัฒนา

คำสั่ง	คำอธิบาย
yarn dev	รัน MCP server พร้อม hot reload ผ่าน tsx
yarn build	คอมไพล์ TypeScript ไปเป็น dist/
yarn lint / yarn format	ESLint + Prettier ทั่วทั้ง repo
yarn test	รันชุดทดสอบ Vitest (tests/)
make precommit-test	รัน format → lint → test → build ตามลำดับ

โปรเจกต์นี้เป็น TypeScript-first (ESM) ไฟล์ config ของ Prettier อยู่ใน .prettierrc.json; ESLint ถูกตั้งค่าผ่าน eslint.config.mjs การมีส่วนร่วมที่ราบรื่นทำตาม commit helper ใน Makefile → make commit

---

การแก้ไขปัญหา

เริ่มต้นด้วย payram_doctor — การเรียกแบบ read-only หนึ่งครั้งที่ตรวจสอบ reachability → health → TLS → version → workers และส่งคืนสาเหตุที่จัดอันดับพร้อมวิธีแก้ไขที่แม่นยำ สำหรับการตรวจสอบเชิงลึก ให้ทำตาม payram_ops_playbook (stuck_payment, node_sync, webhooks, logs)

• Copilot ไม่เรียกใช้เครื่องมือที่ถูกต้อง: ตรวจสอบว่า Copilot automation prompt ถูกติดตั้งและ MCP client โหลดเซิร์ฟเวอร์แล้ว รัน "test payram" หรือ "assess my project" อีกครั้งเพื่อเรียกใช้ automation ที่คาดหวัง
• test_payram_connection ล้มเหลวด้วย 401: ยืนยันว่า key เป็น project API key ที่ใช้งานอยู่ (ส่งเป็น header API-Key ไม่ใช่ Authorization)
• เครื่องมือข้อมูลแจ้งว่าไม่มี credentials: เซิร์ฟเวอร์ที่โฮสต์ไม่เคยเก็บ merchant credentials ใช้ task payram_ops_playbook ที่ตรงกัน หรือรัน MCP ใน โหมด local
• ลิงก์ชำระเงินแสดง http://localhost: ผู้ใช้ต้องบันทึก Settings → Site URL จากโดเมนสาธารณะ (task payram_runbook set_site_url)
• เครื่องมือ Docs แจ้งว่าไฟล์หาย: ตรวจสอบว่า tree ของ docs/payram-docs-live/ ในเครื่องมี markdown ที่ร้องขอ (get_payram_doc_by_id ปฏิเสธ paths ที่มี ..)
• เซิร์ฟเวอร์ไม่เริ่มทำงาน: ตรวจสอบว่าใช้ Node 20+ และรัน yarn install ในโหมด local ที่มี HOST ที่ไม่ใช่ loopback และตั้งค่า credentials PAYRAM_* แล้ว เซิร์ฟเวอร์จะปฏิเสธการเริ่มทำงานจนกว่าจะตั้งค่า MCP_SERVER_TOKEN (ดู โหมด local)

สำหรับปัญหาอื่น ๆ ให้ตรวจสอบ structured logs ที่ส่งออกจาก src/utils/logger.ts (ตั้งค่า LOG_LEVEL=debug) และเปิด issue/PR พร้อมรายละเอียดการจำลองปัญหา