پرداخت با ایجنت هوش مصنوعی: سرور MCP برای Claude Code

پرداخت با ایجنت هوش مصنوعی دو معنا دارد. یکی ایجنت‌هایی که پرداخت می‌کنند: یک دستیار هوش مصنوعی خودش چیزی می‌خرد یا هزینه فراخوانی یک API را با پروتکل پرداختی مثل x402 می‌پردازد. دیگری ایجنت‌هایی که پرداخت‌های یک کسب‌وکار را اداره می‌کنند: یک ایجنت کدنویسی مثل Claude Code با فراخوانی API پرداخت از طریق یک سرور MCP، صفحه پرداخت، اشتراک یا محصول می‌سازد.

OrcaRail امروز دومی را انجام می‌دهد. سرور MCP آن به Claude Code، Cursor و Codex اجازه می‌دهد payment intent و اشتراک ارز دیجیتال بسازند که مشتری با USDC، تتر (USDT) یا توکن‌های دیگر می‌پردازد. این مطلب هر دو معنا را توضیح می‌دهد، توضیح می‌دهد سرور MCP ‏OrcaRail چه می‌کند و نشان می‌دهد چطور آن را با خیال راحت در سندباکس وصل کنید.

پرداخت با ایجنت هوش مصنوعی چیست

	ایجنت‌هایی که پرداخت می‌کنند	ایجنت‌هایی که پرداخت‌ها را اداره می‌کنند
چه اتفاقی می‌افتد	ایجنت از طرف کاربرش به یک فروشنده یا API پول می‌دهد	ایجنت برای کسب‌وکار شما صفحه پرداخت، اشتراک و محصول می‌سازد
چه کسی می‌پردازد	ایجنت، با پولی که کاربرش اجازه داده	مشتری شما، در صفحه پرداختی که ایجنت ساخته
بر چه پایه‌ای	پروتکل‌های پرداخت مثل x402، AP2 و ACP	یک API پرداخت و سرور MCP آن
مثال	ایجنت برای هر درخواست به یک API پولی پرداخت می‌کند	«یک لینک پرداخت ۲۵ دلاری با USDC بساز و به من بده»
OrcaRail امروز	ارائه نمی‌شود	بله: سرور @orcarail/mcp

پروتکل‌های پرداخت ایجنت هوش مصنوعی: x402، AP2 و ACP

این پروتکل‌ها تعیین می‌کنند ایجنت چطور پرداخت کند. توضیح هر کدام از زبان خودش، بررسی‌شده در ۱۱ نوامبر ۲۰۲۶:

• x402 خودش را استانداردی باز و بی‌طرف برای پرداخت‌های بومی اینترنت معرفی می‌کند. وقتی درخواستی بدون پرداخت می‌رسد، سرور با HTTP 402 (Payment Required) پاسخ می‌دهد و کلاینت پرداخت می‌کند و دوباره درخواست می‌فرستد. طبق سایت x402، این پروتکل روی زنجیره‌های EVM و سولانا کار می‌کند و کاربرد اصلی آن پرداخت با استیبل‌کوین است.
• AP2 یا Agent Payments Protocol پروتکلی باز برای اقتصاد ایجنت‌هاست که گوگل منتشر کرده است (اعلامیه). سایت آن نمونه‌هایی دارد که با x402 پرداخت می‌کنند.
• ACP یا Agentic Commerce Protocol استانداردی باز برای خرید برنامه‌نویسی‌شده میان خریداران، ایجنت‌های هوش مصنوعی و کسب‌وکارهاست.

OrcaRail امروز پرداخت با x402، AP2 یا ACP ارائه نمی‌دهد. اگر به آدم‌ها می‌فروشید، همچنان به صفحه پرداخت، اشتراک و وب‌هوک نیاز دارید و سرور MCP به ایجنت اجازه می‌دهد این‌ها را برایتان بسازد و اداره کند.

APIهای پرداخت با سرور MCP برای Claude Code

سرور MCP (Model Context Protocol) مجموعه‌ای از ابزارها را برای یک API در اختیار ایجنت هوش مصنوعی می‌گذارد. OrcaRail سرور خودش را با نام @orcarail/mcp منتشر کرده است:

• نحوه اجرا: به‌صورت محلی از طریق stdio، با Node.js نسخه ۱۸ یا بالاتر.
• نحوه اتصال: با کلید و رمز API ‏OrcaRail که به‌صورت متغیر محیطی داده می‌شوند.
• کلاینت‌ها: Claude Code، Cursor، Codex، Claude Desktop و هر کلاینتی که سرور MCP از نوع stdio را پشتیبانی کند.
• چه می‌کند: صفحه پرداخت و اشتراک ارز دیجیتال می‌سازد که با USDC، تتر و توکن‌های دیگر پرداخت می‌شود و هر پرداخت به کیف‌پول‌های خود شما منتقل می‌شود.

Claude Code آن را با claude mcp add اضافه می‌کند؛ مراحل در ادامه آمده است.

سرور MCP OrcaRail چه کارهایی می‌کند

@orcarail/mcp ‏۲۷ ابزار دارد که به شکل resource.action نام‌گذاری شده‌اند:

گروه	ابزارها	کلید API لازم است
Payment intent	payment_intents.create، .retrieve، .update، .confirm، .complete، .cancel، .simulate (فقط سندباکس)	بله
اشتراک	subscriptions.create، .retrieve، .update، .cancel، .resume، .list، .list_payment_links	بله
محصول	products.list، .create، .update، .delete	بله
قیمت	prices.list، .create، .update، .deactivate	بله
حساب	account.get_mode	خیر
نرخ ارز	rates.get_fiat_quote، rates.list_currencies	خیر
صفحه‌های پرداخت میزبانی‌شده	pay.get_by_slug، pay.cancel_by_slug	خیر

با زبان ساده با آن حرف می‌زنید، مثلاً:

• «یک محصول به نام Pro Plan با قیمت دوره‌ای ماهانه ۲۹ دلار بساز.»
• «اشتراک‌های فعالم را فهرست کن و اشتراک [email protected] را در پایان دوره لغو کن.»
• «۵۰۰ یورو الان چند USDC است؟»
• «وضعیت payment intent ‏550e8400-… چیست؟»

Payment intentها و قیمت‌ها به شناسه توکن و شناسه شبکه (UUID) نیاز دارند و سرور ابزاری برای فهرست کردن آن‌ها ندارد. شناسه‌ها را از شبکه‌ها و توکن‌ها به ایجنت بدهید، یا از قیمتی که قبلاً ساخته‌اید (price_id) استفاده کنید.

چطور Claude Code را به OrcaRail وصل کنیم

1. یک سندباکس بسازید. در app.orcarail.com ثبت‌نام کنید، یک سازمان سندباکس و یک کلید API از نوع ak_test_ با رمز آن بسازید. سندباکس فقط روی تست‌نت کار می‌کند و پول واقعی جابه‌جا نمی‌شود.

2. سرور را به Claude Code اضافه کنید. به Node.js نسخه ۱۸ یا بالاتر نیاز دارد. کلید را به‌صورت متغیر محیطی بدهید، نه در خط فرمان:

   claude mcp add orcarail \
     -e ORCARAIL_API_KEY=ak_test_xxx \
     -e ORCARAIL_API_SECRET=sk_test_xxx \
     -- npx -y @orcarail/mcp --tools=all

3. بررسی کنید با claude mcp list. بعد از Claude Code بپرسید «در کدام حالت OrcaRail هستم؟». ایجنت account.get_mode را فراخوانی می‌کند که باید sandbox برگرداند.

4. یک صفحه پرداخت بسازید. مثلاً: «برای قیمت <price-id> یک payment intent با آدرس بازگشت https://example.com/thanks بساز، تأییدش کن و لینک پرداخت را به من بده.» ایجنت payment_intents.create و بعد payment_intents.confirm را فراخوانی می‌کند.

5. آزمایش کنید. بگویید «پرداخت را شبیه‌سازی کن.» ابزار payment_intents.simulate payment intent را بدون کیف‌پول کامل می‌کند و وب‌هوک‌های همیشگی را می‌فرستد. پرداخت شبیه‌سازی‌شده هرگز قابل برداشت نیست. در پرداخت واقعی، وقتی مشتری به آدرس موفقیت شما برگشت، payment_intents.complete را فراخوانی کنید؛ تا آن زمان پرداخت قطعی نیست.

6. ابزارها را محدود کنید. به‌جای --tools=all فقط چیزی را بدهید که ایجنت لازم دارد، مثلاً --tools=payment_intents.create,payment_intents.retrieve,subscriptions.list، تا نتواند اشتراکی را لغو یا محصولی را حذف کند.

7. به حالت واقعی بروید فقط وقتی آماده‌اید، با کلید ak_live_ یک سازمان live. در حالت live، سرور به ایجنت می‌گوید پول واقعی در کار است و از آن می‌خواهد پیش از هر create، confirm، complete، cancel، update یا delete از شما تأیید بگیرد.

از Cursor یا Codex استفاده می‌کنید؟ همین فرمان را به .cursor/mcp.json یا ~/.codex/config.toml اضافه کنید. راهنمای سرور MCP فایل تنظیمات هر کدام را دارد.

قواعد امنیتی برای دادن دسترسی پرداخت به ایجنت

• از سندباکس شروع کنید. کلید ak_test_ فقط روی تست‌نت کار می‌کند. کلید live پول واقعی جابه‌جا می‌کند.
• کلیدها را از تاریخچه ترمینال و git دور نگه دارید. از متغیر محیطی استفاده کنید و هرگز فایل تنظیماتی را که کلید live دارد commit نکنید.
• فقط ابزارهای لازم را باز کنید با --tools.
• پیش از هر نوشتن، حالت را بررسی کنید. account.get_mode یکی از live، sandbox یا public را برمی‌گرداند.
• کلید را عوض کنید در داشبورد، اگر ممکن است لو رفته باشد.

ایجنت هیچ‌وقت پول را نگه نمی‌دارد. مشتری در صفحه پرداخت میزبانی‌شده می‌پردازد و هر پرداخت به آدرس‌های برداشتی که در اختیار شماست منتقل می‌شود.

بقیه یکپارچه‌سازی را با هوش مصنوعی بسازید

سرور MCP پرداخت‌ها را اداره می‌کند. برای ساختن یکپارچه‌سازی در اپلیکیشن خودتان، مستندات را به‌صورت متن ساده به ایجنت بدهید: llms.txt همه صفحه‌ها را فهرست می‌کند و ساخت با هوش مصنوعی نکته‌های کاربردی دارد. برای خود کد، یکپارچه‌سازی درگاه پرداخت و راهنمای API پرداخت با استیبل‌کوین را ببینید.

پرسش‌های متداول

آیا دادن کلید API پرداخت به ایجنت هوش مصنوعی امن است؟

تا وقتی در حال ساختن هستید از کلید سندباکس استفاده کنید: کلید ak_test_ فقط روی تست‌نت کار می‌کند و پول واقعی جابه‌جا نمی‌شود. پیش از استفاده از کلید live، ابزارها را با --tools محدود کنید، کلید را در متغیر محیطی نگه دارید و از ایجنت بخواهید هر نوشتن را با شما تأیید کند؛ سرور OrcaRail در حالت live همین را از ایجنت می‌خواهد. هر کلیدی را که ممکن است لو رفته باشد عوض کنید.

کدام APIهای پرداخت سرور MCP برای Claude Code دارند؟

OrcaRail یک سرور MCP دارد: @orcarail/mcp. Claude Code آن را با claude mcp add اضافه می‌کند و این سرور صفحه پرداخت و اشتراک ارز دیجیتال می‌سازد که با USDC، تتر و توکن‌های دیگر پرداخت می‌شود. راهنمای سرور MCP را ببینید.

پروتکل پرداخت ایجنت هوش مصنوعی چیست؟

استانداردی برای اینکه ایجنت چطور پرداخت کند. x402 از کد وضعیت HTTP 402 استفاده می‌کند تا کلاینت هزینه یک درخواست را بپردازد و آن را تکرار کند، بیشتر با استیبل‌کوین. AP2 که گوگل منتشر کرده پروتکلی باز برای پرداخت ایجنت‌هاست. ACP صفحه پرداخت و اشتراک‌گذاری اطلاعات پرداخت میان ایجنت‌ها و کسب‌وکارها را پوشش می‌دهد.

آیا ایجنت هوش مصنوعی می‌تواند برای کسب‌وکار من پرداخت ارز دیجیتال بپذیرد؟

بله، از طریق سرور MCP. با OrcaRail، ایجنت یک payment intent می‌سازد و لینک صفحه پرداخت میزبانی‌شده را به شما می‌دهد. مشتری با USDC، تتر یا توکن پشتیبانی‌شده دیگری می‌پردازد و پرداخت به کیف‌پول‌های شما منتقل می‌شود. کارمزد OrcaRail برای هر تراکنش تکمیل‌شده ۰٫۵٪ است و ۱۰۰ تراکنش اول رایگان است. قیمت‌گذاری را ببینید.

آیا OrcaRail از x402 پشتیبانی می‌کند؟

فعلاً نه. ابزارهای OrcaRail برای ایجنت‌های هوش مصنوعی، سرور MCP و مستندات متنی ساده هستند و مشتری‌ها با صفحه پرداخت میزبانی‌شده و اشتراک پرداخت می‌کنند.

---

شروع در سندباکس · راهنمای سرور MCP · قیمت‌گذاری