رفتن به محتوا
Mobile Accounting

سرور MCP

Mobile Accounting را به دستیار AI خود اضافه کنید

Mobile Accounting یک سرور MCP دارد؛ استاندارد بازی که دستیارهای هوش مصنوعی برای کار با برنامه‌های دیگر به کار می‌برند. آن را به دستیاری که همین حالا استفاده می‌کنید اضافه کنید، یک بار وارد شوید و دربارهٔ اعدادتان بپرسید یا از او بخواهید پیش‌نویس هزینه، فاکتور خرید، فاکتور، پیش‌فاکتور و سند حسابداری بسازد تا شما قطعی کنید.

نشانی سرور

https://mcp.mobileaccounting.com

آن را هر جا دستیارتان نشانی سرور MCP راه دور یا اتصال‌دهنده می‌خواهد بچسبانید. کلید API لازم نیست: شما وارد Mobile Accounting می‌شوید و اتصال را تأیید می‌کنید.

دستیار شما چه کارهایی می‌تواند بکند

پنجاه‌ودو ابزار که هر کدام به‌جای شما و در مجموعه‌های دفاتری که برمی‌گزینید کار می‌کنند. دستیارتان از روی چیزی که می‌پرسید ابزار مناسب را انتخاب می‌کند.

دفاتر و طرف‌حساب‌ها

list_books
مجموعه دفاتری که این اتصال می‌تواند به آن‌ها دسترسی داشته باشد.
list_categories
دسته‌های هزینه، درآمد و دارایی در یک مجموعه دفاتر.
month_end_checklist
پیش از قفل کردن یک ماه، چه چیزی هنوز باز است.
get_card_fee_setting
اینکه مجموعه دفاتری کارمزد کارت را از مشتری می‌گیرد یا نه، و سقف آن در محل شما.
missing_receipts
ردیف‌های بانک و کارتی که هنوز رسید ندارند، و رسیدهایی که به آن‌ها می‌خورند.
find_contacts
مشتری‌ها و تأمین‌کنندگان، با جست‌وجو از روی بخشی از نام.
update_contact
نام، ایمیل یا نشانی پستی یک مشتری یا فروشنده را اصلاح می‌کند.

فاکتورها و هزینه‌ها

find_documents
اسناد بر پایهٔ نوع، وضعیت، طرف‌حساب یا تاریخ، یا فقط اسناد پرداخت‌نشده.
get_document
یک سند: وضعیتش، اینکه فرستاده و دیده شده، پرداخت شده، سررسید دارد یا سررسیدگذشته است.
find_estimates
پیش‌فاکتورها و پیشنهاد قیمت‌ها: ارسال‌شده، پذیرفته‌شده، منقضی‌شده و اینکه کدام‌ها به فاکتور تبدیل شدند.
get_installment_plan
برنامهٔ اقساط یک فاکتور یا فاکتور خرید: هر تاریخ، مبلغ، آنچه پرداخت شده و روش وصول آن.
upcoming_installments
اقساطی که در یک بازهٔ تاریخی در همهٔ برنامه‌ها سررسید می‌شوند، پولی که وارد و خارج می‌شود.
customer_portal
اینکه پورتال مشتری روشن است یا نه، و هر مشتری آخرین بار کی پورتالش را باز کرده است.

زمان

list_time
زمانی که در یک دوره ثبت کرده‌اید، صورت‌حساب‌شده یا نه، با جمع‌ها.
unbilled_time
زمان قابل صورت‌حساب که هنوز روی فاکتوری نیست، به تفکیک مشتری (برای کسی که زمان را مدیریت می‌کند).

سفارش‌های خرید

find_purchase_orders
سفارش‌های تأمین‌کنندگان بر پایهٔ وضعیت، یا فقط آن‌هایی که هنوز باز هستند.
get_purchase_order
یک سفارش: چه چیزی دریافت و صورت‌حساب شده و آیا فاکتور خرید با آن می‌خواند.
get_on_order
موجودی انبار و آنچه سفارش داده شده، قلم‌به‌قلم، با تاریخ تحویل بعدی.

گزارش‌ها

profit_and_loss
هر دوره، در مقایسه با دوره یا سال قبل، ماهانه یا فصلی.
balance_sheet
آنچه در هر تاریخ دارید و بدهکارید.
cash_flow
پول ورودی و خروجی در یک دوره.
cash_forecast
برآوردی از موجودی نقد شما ۳۰، ۶۰ و ۹۰ روز بعد، از روی آنچه در دفاتر هست.
insights
چیزهایی در دفاتر که ارزش نگاه دارند: خرج غیرعادی، افزایش قیمت، احتمال تکراری بودن، رسید گم‌شده، مشتری‌های دیرپرداخت.
sales_tax_report
مالیات گرفته‌شده و پرداخت‌شده، به تفکیک مالیات و حوزه.
tax_set_aside
تقریباً چقدر برای مالیات بر درآمد تا اینجای امسال باید کنار بگذارید و قسط بعدی کی سررسید می‌شود. برآورد است، نه توصیهٔ مالیاتی.
sales_tax_returns
کدام اظهارنامه‌های مالیات بر فروش و کی سررسید دارند.
sales_tax_return_worksheet
یک اظهارنامه با ردیف‌های فرم، برای بررسی پیش از ارسال.
sales_tax_claims
درخواست‌های استرداد مالیات بر فروش و مدارکی که لازم دارند.
unpaid_invoices
آنچه مشتری‌ها به شما بدهکارند، با سن بدهی.
unpaid_bills
آنچه شما بدهکارید، با سن بدهی.
spending
هزینه به تفکیک دسته یا تأمین‌کننده.
account_balances
مانده هر حساب.
journal_entries
همهٔ ثبت‌های گذشتهٔ یک دوره، با ردیف‌های بدهکار و بستانکارشان.
general_ledger
تراکنش‌های یک حساب در یک دوره، با مانده جاری. حساب را با کد یا نامش بگویید.
sales_by_customer
فروش به تفکیک مشتری در یک دوره، و سهم هر کدام.
customer_statement
فاکتورها، اعتبارها و پرداخت‌های یک مشتری، با مانده بدهی. چیزی برای او فرستاده نمی‌شود.

بودجه‌ها

list_budgets
بودجه‌های یک مجموعه دفاتر، به تفکیک سال مالی، و اینکه کدام فعال است.
budget_vs_actual
بودجه در برابر واقعی برای هر دوره، ماهانه یا فصلی، با اختلاف.
budget_status
این ماه و سال تا امروز در برابر بودجه، و دسته‌هایی که بیشترین فراروی را دارند.

معافیت‌های مالیات بر فروش

tax_exemption_forms
گواهی‌های معافیت و فروش مجدد که هر استان و ایالت منتشر می‌کند، با پیوند به فرم‌های رسمی.
tax_exemption_certificates
گواهی‌هایی که از مشتری‌ها دارید و به تأمین‌کنندگان داده‌اید، و کدام‌ها نزدیک انقضا هستند.
check_tax_exemption
اینکه فروش به یک مشتری یا خرید از یک تأمین‌کننده معاف است یا نه، و چرا.
exempt_sales
فروش‌های معاف به تفکیک استان یا ایالت و دلیل، برای اظهارنامهٔ مالیات بر فروش شما.

پیش‌نویس، فقط اگر اجازه بدهید

record_expense
یک رسید پرداخت‌شده، پرداخت از بانک، کارت، نقد یا مالک.
record_bill
یک فاکتور خرید برای پرداخت بعداً.
create_invoice
یک فاکتور فروش برای مشتری. دستیار هرگز آن را نمی‌فرستد.
create_estimate
یک پیش‌فاکتور یا پیشنهاد قیمت برای مشتری. شما آن را می‌فرستید و به فاکتور تبدیل می‌کنید.
log_time
ساعت‌هایی که برای مشتری کار کرده‌اید، به‌عنوان زمان خودتان. چیزی صورت‌حساب نمی‌شود.
bill_time
زمان صورت‌حساب‌نشدهٔ مشتری روی یک پیش‌نویس فاکتور. دستیار هرگز آن را نمی‌فرستد.
draft_purchase_order
یک سفارش خرید برای تأمین‌کننده. دستیار هرگز آن را نمی‌فرستد.
draft_budget
بودجه‌ای برای یک سال، به شکل نسخه‌ای که هرگز فعال نمی‌شود. شما آن را در برنامه به بودجهٔ اصلی تبدیل می‌کنید.
record_journal_entry
یک ثبت روزنامه: حساب‌هایی که بدهکار و بستانکار می‌کند، با تراز. همچنین برای کپی یا معکوس کردن ثبتی قدیمی.

دستیار شما پیش‌نویس می‌نویسد. شما قطعی می‌کنید. نمی‌تواند چیزی را قطعی، ارسال، پرداخت، ابطال یا حذف کند. هزینه‌ها، فاکتورهای خرید، فاکتورها، پیش‌فاکتورها، سفارش‌های خرید و بودجه‌هایی که می‌سازد در برنامه به شکل پیش‌نویس منتظر می‌مانند تا خودتان بررسی و قطعی یا ارسال کنید. زمانی که ثبت می‌کند در اختیار شماست تا تغییر دهید یا حذف کنید و فقط روی پیش‌نویس فاکتور صورت‌حساب می‌شود.

اتصال چگونه کار می‌کند

  1. نشانی سرور را به دستیارتان اضافه می‌کنید.
  2. دستیار شما Mobile Accounting را در مرورگرتان باز می‌کند و شما همان‌جا وارد می‌شوید. دستیار هرگز رمز شما را نمی‌بیند.
  3. مجموعه دفاتری را که می‌تواند ببیند و اینکه می‌تواند پیش‌نویس بسازد یا نه علامت می‌زنید، بعد «اجازه دادن» را می‌زنید.
  4. از آن به بعد به‌جای شما کار می‌کند و هرگز فراتر از آنچه نقش شما در آن دفاتر اجازه می‌دهد نمی‌رود.
  5. هر وقت خواستید قطع کنید: در برنامه از «تنظیمات»، «برنامه‌های متصل»، یا با برداشتن اتصال‌دهنده از دستیارتان.

آن را در دستیارتان تنظیم کنید

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

Claude

Claude در وب، برنامهٔ دسکتاپ و برنامه‌های موبایل

  1. در Claude «Customize» و بعد «Connectors» را باز کنید.
  2. «Add» و بعد «Add custom connector» را انتخاب کنید.
  3. نامش را Mobile Accounting بگذارید، نشانی سرور را بچسبانید و «Continue» را بزنید.
  4. تنظیمات ورودی را که Claude با «Detected» علامت زده نگه دارید، بعد «Add» را بزنید.
  5. «Connect» را بزنید، وارد Mobile Accounting شوید، دفاترتان را انتخاب کنید و «اجازه دادن» را بزنید.

در طرح‌های Team و Enterprise یک مالک اتصال‌دهنده را در «Organization settings» و «Connectors» اضافه می‌کند و بعد هر عضو «Connect» را می‌زند. طرح Free یک اتصال‌دهندهٔ سفارشی را مجاز می‌داند.

نشانی سرور
https://mcp.mobileaccounting.com

Claude Code

Claude در ترمینال یا ویرایشگر شما

  1. دستور زیر را در یک ترمینال اجرا کنید.
  2. در Claude Code عبارت /mcp را بنویسید، mobile-accounting را انتخاب کنید و «Authenticate» را بزنید.
  3. در مرورگری که باز می‌شود وارد Mobile Accounting شوید، دفاترتان را انتخاب کنید و «اجازه دادن» را بزنید.

برای استفاده در همهٔ پروژه‌ها، نه فقط پروژهٔ فعلی، به دستور --scope user اضافه کنید.

ترمینال
claude mcp add --transport http mobile-accounting https://mcp.mobileaccounting.com

ChatGPT

ChatGPT در وب، با حالت توسعه‌دهنده

  1. در ChatGPT روی وب، «Settings» و بعد «Apps» را باز کنید (در برخی طرح‌ها «Apps & Connectors»).
  2. زیر «Advanced settings» حالت «Developer mode» را روشن کنید.
  3. «Create» را انتخاب کنید، نامش را Mobile Accounting بگذارید و نشانی سرور را بچسبانید.
  4. «Authentication» را روی OAuth بگذارید، تأیید کنید که به برنامه اعتماد دارید و «Create» را انتخاب کنید.
  5. وارد Mobile Accounting شوید، دفاترتان را انتخاب کنید و «اجازه دادن» را بزنید.
  6. در یک گفتگوی تازه، Mobile Accounting را از منوی + روشن کنید، بعد بپرسید.

حالت توسعه‌دهنده در طرح‌های پولی ChatGPT هست و در Business، Enterprise و Edu ممکن است ابتدا مدیر باید آن را مجاز کند. OpenAI گاهی نام این منوها را عوض می‌کند؛ مرکز راهنمایش نام‌های فعلی را دارد.

نشانی سرور
https://mcp.mobileaccounting.com

Cursor

ویرایشگر Cursor

  1. «افزودن به Cursor» را بزنید. Cursor باز می‌شود و سرور را نشان می‌دهد.
  2. «Install» را انتخاب کنید.
  3. وقتی Cursor نشان داد mobile-accounting به ورود نیاز دارد، آن را انتخاب کنید، وارد Mobile Accounting شوید، دفاترتان را انتخاب کنید و «اجازه دادن» را بزنید.

یا دستی: بلوک زیر را برای همهٔ پروژه‌ها به ~/.cursor/mcp.json یا برای یک پروژه به .cursor/mcp.json اضافه کنید.

~/.cursor/mcp.json
{
  "mcpServers": {
    "mobile-accounting": {
      "url": "https://mcp.mobileaccounting.com"
    }
  }
}

VS Code و GitHub Copilot

Copilot Chat در Visual Studio Code

  1. «نصب در VS Code» (یا VS Code Insiders) را بزنید. صفحه VS Code را باز می‌کند و سرور را نشان می‌دهد.
  2. «Install» را انتخاب کنید، بعد وقتی VS Code پرسید سرور را راه بیندازید.
  3. در مرورگری که باز می‌شود وارد Mobile Accounting شوید، دفاترتان را انتخاب کنید و «اجازه دادن» را بزنید.
  4. در Copilot Chat از حالت Agent استفاده کنید. ابزارهای Mobile Accounting در فهرست ابزارها هستند.

یا دستی: از Command Palette «MCP: Add Server» را اجرا کنید، HTTP را انتخاب کنید، نشانی سرور را بچسبانید و نامش را mobile-accounting بگذارید. یا از فایل یا دستور ترمینال زیر استفاده کنید.

.vscode/mcp.json
{
  "servers": {
    "mobile-accounting": {
      "type": "http",
      "url": "https://mcp.mobileaccounting.com"
    }
  }
}
Or from a terminal
code --add-mcp '{"name":"mobile-accounting","type":"http","url":"https://mcp.mobileaccounting.com"}'

Windsurf

Windsurf و Devin Desktop

  1. تنظیمات MCP را باز کنید: در Windsurf پنل سرورهای MCP در Cascade؛ در Devin Desktop «Customize» و بعد «MCPs».
  2. پیکربندی خام، یعنی mcp_config.json، را باز کنید و بلوک زیر را اضافه کنید.
  3. ذخیره کنید، فهرست سرورها را تازه کنید و وقتی خواست وارد Mobile Accounting شوید.

Windsurf حالا Devin Desktop نام دارد. هنوز ~/.codeium/windsurf/mcp_config.json را می‌خواند.

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "mobile-accounting": {
      "serverUrl": "https://mcp.mobileaccounting.com"
    }
  }
}

هر کلاینت MCP دیگر

Gemini، Grok، Copilot Studio و هر دستیار یا ابزاری که از MCP پشتیبانی کند

  1. ببینید کلاینت شما سرور MCP راه دور را کجا اضافه می‌کند. ممکن است اتصال‌دهنده، یکپارچه‌سازی یا ابزار نامیده شود.
  2. نشانی سرور را بچسبانید. اگر نوع انتقال پرسید، Streamable HTTP را انتخاب کنید. هر کلید API را خالی بگذارید.
  3. وقتی خواست وارد Mobile Accounting شوید، دفاترتان را انتخاب کنید و «اجازه دادن» را بزنید.

کلاینتی که فایل JSON می‌خواند بلوک اول را می‌گیرد. کلاینتی که فقط سرورهای محلی اجرا می‌کند می‌تواند از پل mcp-remote در بلوک دوم به ما برسد، که به Node.js نیاز دارد.

MCP client configuration (JSON)
{
  "mcpServers": {
    "mobile-accounting": {
      "type": "http",
      "url": "https://mcp.mobileaccounting.com"
    }
  }
}
A client that only runs local servers, through mcp-remote
{
  "mcpServers": {
    "mobile-accounting": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.mobileaccounting.com"
      ]
    }
  }
}

برای توسعه‌دهندگان و کلاینت‌های AI

سرور MCP را روی Streamable HTTP ارائه می‌دهد و افراد را با OAuth 2.1 وارد می‌کند: کد مجوز با PKCE و ثبت پویای کلاینت، بدون کلید API. ابزارها هنگام اجرا با tools/list فهرست می‌شوند. این سندها آن را شرح می‌دهند:

پرسش‌ها

کدام دستیارها با Mobile Accounting کار می‌کنند؟
هر دستیار یا ویرایشگری که بتواند سرور MCP راه دور اضافه کند: Claude، ChatGPT، Cursor، VS Code با GitHub Copilot، Windsurf و بسیاری دیگر. اینکه دستیار شما بتواند اضافه کند یا نه به طرحش بستگی دارد.
آیا کلید API لازم دارم؟
نه. شما در مرورگرتان وارد Mobile Accounting می‌شوید و اتصال را تأیید می‌کنید. دستیار شما هرگز رمزتان را نمی‌بیند.
آیا دستیارم می‌تواند دفاترم را تغییر دهد؟
فقط با ساختن پیش‌نویس هزینه، فاکتور خرید، فاکتور، پیش‌فاکتور و سند حسابداری، و فقط اگر هنگام اتصال اجازهٔ پیش‌نویس داده باشید. نمی‌تواند چیزی را قطعی، ارسال، پرداخت، ابطال یا حذف کند. هر پیش‌نویس را شما بررسی می‌کنید و در برنامه قطعی می‌کنید.
کدام دفاتر را می‌تواند ببیند؟
فقط مجموعه دفاتری که هنگام اتصال علامت می‌زنید، و فقط تا وقتی در آن‌ها مالک، مدیر، حسابدار یا دفتردار هستید.
آیا می‌تواند عکس رسید را بخواند؟
بله. دستیار شما عکس را با مدل خودش می‌خواند و ارقام را به شکل پیش‌نویس می‌فرستد. اگر بتواند خودش فایل را باز کند، عکس را هم به پیش‌نویس پیوست می‌کند؛ در غیر این صورت هنگام قطعی کردن آن را در برنامه پیوست کنید.
آنچه به دستیارم تایپ می‌کنم را چه کسی می‌بیند؟
ارائه‌دهندهٔ دستیار شما، طبق شرایط خودش. Mobile Accounting فقط درخواست‌هایی را می‌گیرد که دستیار شما برای ارقام و پیش‌نویس‌ها می‌فرستد.
چطور یک دستیار را قطع کنم؟
در برنامه «تنظیمات» و بعد «برنامه‌های متصل» را باز کنید و آن را قطع کنید. برداشتن اتصال‌دهنده از دستیارتان هم اتصال را تمام می‌کند.

دستیار شما اول به دفاترتان نیاز دارد

در Mobile Accounting حساب بسازید و دفاترتان را تنظیم کنید، بعد دستیاری را که الان استفاده می‌کنید وصل کنید.