سرور MCP

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

یک سرور MCP برای کل حساب کاربری شما. Claude Code، Claude Desktop یا Cursor را یک بار متصل کنید و دستیار شما می‌تواند سایت‌های شما را فهرست کند، لاگ‌های آن‌ها را بخواند، فایل‌های آن‌ها را با مخزن شما همگام‌سازی کند و استقرار انجام دهد — و تنها با مجوزهایی که به آن اعطا کرده‌اید عمل کند.

امروز 65 ابزار، دقیقاً به همان صورتی که سرور ارائه می‌دهد در زیر فهرست شده‌اند.

اتصال آن

دو مرحله. توکن کل اعتبارنامه است، بنابراین با آن مانند یک رمز عبور رفتار کنید: یک بار نمایش داده می‌شود و می‌توانید یک اتصال را بدون لمس سایرین لغو کنید.

  1. ایجاد اتصال

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

  2. پیکربندی‌ای را که کلاینت شما می‌خواند، جای‌گذاری کنید

    داشبورد پیکربندی مشتری انتخابی شما را همراه با توکن شما در آن نمایش می‌دهد. هر مشتری با یک آدرس سرور یکسان ارتباط برقرار می‌کند:

    https://api.zinndigital.com/v1/mcp

Claude Code

دستور را اجرا کنید، یا این بلوک را در فایل .mcp.json در پوشه اصلی پروژه خود قرار دهید. خط "type": "http" الزامی است — بدون آن Claude Code از سرور صرف‌نظر می‌کند.

claude mcp add --transport http zinn https://api.zinndigital.com/v1/mcp \
  --header "Authorization: Bearer zmcp_live_…"
// .mcp.json
{
  "mcpServers": {
    "zinn": {
      "type": "http",
      "url": "https://api.zinndigital.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer zmcp_live_…"
      }
    }
  }
}

Claude Desktop

Claude Desktop سرورهای محلی را راه‌اندازی می‌کند، بنابراین به عنوان پلی برای اتصال به سرور میزبان، رابط خط فرمان رایگان Zinnector® ما را اجرا می‌کند. این ابزار به Node 24 یا جدیدتر نیاز دارد. توکن در متغیرهای محیطی قرار می‌گیرد، هرگز در آرگومان‌ها.

// claude_desktop_config.json
{
  "mcpServers": {
    "zinn": {
      "command": "npx",
      "args": [
        "-y",
        "zinnector@0.1.4",
        "mcp"
      ],
      "env": {
        "ZINN_MCP_TOKEN": "zmcp_live_…"
      }
    }
  }
}

مکان‌نما

سرور را به همراه آدرس و هدر Authorization به پروندهٔ ~/.cursor/mcp.json (یا .cursor/mcp.json در یک پروژه) اضافه کنید.

// ~/.cursor/mcp.json
{
  "mcpServers": {
    "zinn": {
      "url": "https://api.zinndigital.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer zmcp_live_…"
      }
    }
  }
}

هر مشتری MCP دیگر

هر کلاینی که از سرورهای Streamable HTTP راه دور با یک هدر سفارشی پشتیبانی کند کار می‌کند: آن را به آدرس بالا هدایت کنید و Authorization: Bearer را با توکن خود ارسال کنید. کلاینی که فقط سرورهای محلی را راه‌اندازی می‌کند می‌تواند از پل Claude Desktop استفاده کند.

ChatGPT برای اتصال به سرورهای MCP فقط از طریق ورود با OAuth عمل می‌کند، بنابراین هنوز نمی‌تواند از توکن استفاده کند. از همین اتصال با Claude Code، Claude Desktop یا Cursor استفاده کنید.

بررسی کنید که کار می‌کند — چهار سوال

این موارد را به زبان ساده بپرسید. در زیر هر یک، ابزاری که دستیار شما باید فراخوانی کند و شکل یک پاسخ خوب آمده است.

  1. > List my sites.
      ↳ sites_list

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

  2. > Show me the error log for example.com.
      ↳ site_logs

    گزارش خطای اخیر و گزارش دسترسی. اگر خواندن یکی از آن‌ها امکان‌پذیر نباشد، پاسخ این موضوع را اعلام می‌کند — که این با یک گزارش خالی متفاوت است.

  3. > Sync example.com to its repository.
      ↳ site_repo_sync_run

    یک کامیت در مخزن شما با هر تغییری که در سایت زنده انجام شده است، یا یادداشتی مبنی بر اینکه مخزن از قبل مطابقت داشته است. اگر مخزن جابجا شده باشد، همگام‌سازی متوقف می‌شود و هیچ‌چیزی بازنویسی نمی‌شود.

  4. > I pushed a commit — deploy example.com and tell me when it is live.
      ↳ site_deploy → site_deploy_status

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

همگام‌سازی دوسویه، در هر دو جهت

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

سایت ← مخزن

تغییرات ایجاد شده در فایل‌های زنده (مانند ویرایش در مدیریت فایل، به‌روزرسانی افزونه یا بارگذاری) را ثبت کرده و به شاخه شما ارسال می‌کند، به طوری که دستور git pull بعدی شما آن را داشته باشد.

site_repo_sync_run   ·   zinnector sync run

مخزن → وب‌سایت

یک استقرار، شاخه‌ی شما را روی وب‌سایت اعمال می‌کند. کامیت خود را ارسال کنید، سپس استقرار دهید؛ روی سرورهای خودمان، این کار نیازمند روشن بودن همگام‌سازی دوطرفه است که رایگان می‌باشد.

site_deploy   ·   zinnector push

هنگامی که هر دو طرف تغییر کردند

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

site_repo_sync_resolve keep=site|repository confirm=true

چه چیزی آن را امن نگه می‌دارد

فقط آنچه شما اعطا کرده‌اید

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

تایید برای هرگونه اقدام مخرب

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

هر اقدام در گزارش حسابرسی شما

هر تماس در برابر اتصالی که آن را برقرار کرده است ثبت می‌شود. با لغو یک اتصال در صفحه ابزارهای هوش مصنوعی، کارکرد آن بلافاصله متوقف می‌شود.

هر ابزار

تمامی 65 ابزار، از رجیستری خود سرور تولید شده‌اند — اگر در اینجا فهرست شده باشد، دستیار شما می‌تواند آن را فراخوانی کند.

سایت‌ها و استقرارها

ابزارکارکرد آنمجوزیادداشت‌ها
sites_listList the organization's sites, with each site's primary domain, status, product line, stack and the plan it is on. Optionally filter by status, product line or a search over domain and name.sites.viewفقط خواندنی
site_getGet one site's full record — domain, status, product line, stack, runtime, PHP version, region, plan and whether it is scheduled for deletion.sites.viewفقط خواندنی
site_createCreate a site and start provisioning it. Give a primary domain and a product line; optionally a blueprint to build it from, a stack type, a PHP version or a region. Returns the new site, which begins in 'provisioning' — poll site_get for status.sites.createتغییرات ایجاد می‌کند
site_deployDeploy a site — build and publish its current source to our servers. Returns the deploy state immediately; the build runs as a durable workflow. Poll site_deploy_status to follow it.hosting.deploy.manageتغییرات ایجاد می‌کند
site_deploy_statusThe site's current deploy state — status, target, the live URL, the deployed commit and when it last went live.sites.viewفقط خواندنی
site_deployments_listList a site's recent deployments — id, status, commit, branch and timings. Use this to choose the deployment_id to roll back to.sites.viewفقط خواندنی
site_rollbackRoll a site back to an earlier deployment by re-deploying its commit. Destructive: pass confirm=true. Use site_deployments_list to choose which one.hosting.deploy.manageتغییرات ایجاد می‌کند · درخواست تایید

همگام‌سازی دوطرفه

ابزارکارکرد آنمجوزیادداشت‌ها
site_repo_sync_getShow a site's two-way sync with its repository: whether it is available and on, the repository and branch, the current state (idle, synced, conflict, adopt, error) and the last runs with the commits they made.sites.viewفقط خواندنی
site_repo_sync_setTurn two-way sync on or off for a site, optionally limited to a subdirectory of the site. Needs the customer's own GitHub account connected. Turning it on pushes nothing by itself — call site_repo_sync_run for that.hosting.deploy.manageتغییرات ایجاد می‌کند
site_repo_sync_runSync a site to its repository now: commit whatever changed in the site's live files and push it to the connected branch, so a local git pull receives it. If the repository moved since the last sync the run is HELD and nothing is overwritten — the result says so. The other direction (repository to site) is site_deploy.hosting.deploy.manageتغییرات ایجاد می‌کند
site_repo_sync_resolveResolve a HELD two-way sync. keep=site commits the site's files on top of the repository (their commits stay in history); keep=repository applies the repository to the site and DISCARDS the site's unsynced changes. Destructive: pass confirm=true.hosting.deploy.manageتغییرات ایجاد می‌کند · درخواست تایید

گزارش‌ها و معیارها

ابزارکارکرد آنمجوزیادداشت‌ها
site_metricsCurrent metrics for one site — visits, bandwidth, error rate, disk and resource use. Each section reports whether it is available, so 'no data' is distinguishable from 'zero'.sites.viewفقط خواندنی
site_usageOne site's metered visit usage for the current billing period, with the plan's allowance and what any overage costs.sites.viewفقط خواندنی
site_logsRead the recent tail of one site's web-server access log and error log. Each log reports whether it could be read, so an unreadable log is never mistaken for an empty one. Use this before proposing a fix for errors or slowness.sites.panel_accessفقط خواندنی
site_build_logRead the build log of one deployment — the latest when deployment_id is omitted. Pass after=<total from the previous call> to fetch only new lines while complete is false.sites.viewفقط خواندنی

پیکربندی و WordPress

ابزارکارکرد آنمجوزیادداشت‌ها
site_php_version_getThe site's current PHP version and every version it is allowed to switch to on its product line.sites.viewفقط خواندنی
site_php_version_setSwitch a site to a different PHP version. The version must be one that site_php_version_get lists as available. Reports whether the change reached the machine or was only recorded for provisioning to apply.hosting.php.manageتغییرات ایجاد می‌کند
wordpress_stateA WordPress site's core version, whether an update is available, and which management operations its hosting permits.sites.viewفقط خواندنی
wordpress_plugins_listList a WordPress site's plugins — name, version, whether active and whether an update is available.sites.viewفقط خواندنی
wp_plugin_updateUpdate one WordPress plugin to its latest version. Returns the plugin list as it reads after the update.sites.panel_accessتغییرات ایجاد می‌کند
wordpress_update_coreUpdate WordPress core to the latest version on a site. This cannot be undone by another call — take a backup first with backup_create if you may need to go back. Requires confirmation.sites.panel_accessتغییرات ایجاد می‌کند · درخواست تایید
wordpress_set_pluginActivate or deactivate one plugin on a WordPress site. Takes effect on the live site immediately. Requires confirmation.sites.panel_accessتغییرات ایجاد می‌کند · درخواست تایید

پشتیبان‌گیری‌ها

ابزارکارکرد آنمجوزیادداشت‌ها
backups_listA site's backups — each one's id, when it was taken, its size and status — plus whether a backup is currently running and how many on-demand backups remain in the rolling 24-hour allowance.sites.viewفقط خواندنی
backup_createTake an on-demand backup of a site and return the updated backup state. Bounded to 3 per rolling 24 hours per site; the backup runs in the background.hosting.backup.manageتغییرات ایجاد می‌کند
backup_restoreRestore a site from one of its backups. This OVERWRITES the site's live database and files, and everything changed since that backup was taken is lost. Requires confirmation, and the confirmation names how old the backup is.hosting.backup.manageتغییرات ایجاد می‌کند · درخواست تایید

دامنه‌ها و DNS

ابزارکارکرد آنمجوزیادداشت‌ها
dns_records_listList a page of DNS records for a domain whose DNS we host, in name/type/value order. Returns a next_cursor for the following page.sites.viewفقط خواندنی
dns_record_createCreate a DNS record for a domain whose DNS we host.domains.dns.manageتغییرات ایجاد می‌کند
dns_record_updateUpdate an existing DNS record for a domain whose DNS we host.domains.dns.manageتغییرات ایجاد می‌کند
dns_record_deleteDelete a DNS record for a domain whose DNS we host.domains.dns.manageتغییرات ایجاد می‌کند · درخواست تایید
domains_listList the organization's domains — id, hostname, status, product line and whether we registered it or the customer pointed it at us. The ids returned here are what the DNS, cache-purge and index-check tools take.sites.viewفقط خواندنی

حافظه پنهان و خزنده‌ها

ابزارکارکرد آنمجوزیادداشت‌ها
cache_purgePurge the CDN cache for a domain. Omit 'urls' to purge everything, or pass a bounded list of absolute URLs to purge only those.sites.cache.purgeفقط خواندنی
crawler_policy_getGet a site's SEO-crawler-blocking (PBN footprint) policy: which crawlers are blocked, the available crawlers, and the rendered robots.txt/server rules.sites.viewفقط خواندنی
crawler_policy_setSet a site's SEO-crawler-blocking policy. 'blocked' is a list of crawler keys (from crawler_policy_get's available_crawlers). Search engines can never be blocked. Publishes the change so the server rules are re-written.sites.crawler.manageتغییرات ایجاد می‌کند

ایمیل

ابزارکارکرد آنمجوزیادداشت‌ها
mail_services_listList the organization's email services — every domain it has mailboxes on, with the plan's mailbox allowance, how many are used, and whether the mail DNS is published.mail.viewفقط خواندنی
mailboxes_listList the mailboxes on one email service, with each mailbox's size, how full it is, and whether it can send and receive.mail.viewفقط خواندنی
mailbox_createCreate a mailbox on an email service. Returns the new mailbox's password, which is shown once and cannot be retrieved later.mail.manageتغییرات ایجاد می‌کند
mail_forwarders_listList the mail forwarders on one email service — which address goes where.mail.viewفقط خواندنی
mail_forwarder_createCreate a mail forwarder on an email service, sending everything for one address on to one or more destinations.mail.manageتغییرات ایجاد می‌کند

سئو

ابزارکارکرد آنمجوزیادداشت‌ها
site_seo_metricsThe cached SEO authority metrics for a hosted site — domain rank, backlinks, referring domains and organic keywords. Read-only and free; the figures are refreshed by the platform's own sweep, so they may be up to a month old.sites.viewفقط خواندنی
domain_index_checkThe cached search-index status for a domain — whether it is indexed, how many pages, and when the reading was taken. Read-only and free.sites.viewفقط خواندنی

تصاویر هوش مصنوعی

ابزارکارکرد آنمجوزیادداشت‌ها
image_models_listThe image models this account can generate with — provider, model, and the price per image in USD. Read-only and free. A model that is not listed cannot be used, either because it is retired or because nobody has priced it.sites.viewفقط خواندنی
image_generateGenerate an image from a prompt and put it in this account's image library. Costs money — the price per image is what image_models_list reports for the model used. Returns the image ids; the customer sees them in their library immediately.links.editتغییرات ایجاد می‌کند · می‌تواند هزینه کند

تابلوها

ابزارکارکرد آنمجوزیادداشت‌ها
board_listList this organisation's project boards, newest first.agency.board.viewفقط خواندنی
board_getRead one board in full: its columns and every card on them.agency.board.viewفقط خواندنی
board_createCreate a project board, optionally for one of your client organisations.agency.board.manageتغییرات ایجاد می‌کند
board_card_createAdd a card to a column. Cards are agency-only unless you pass visibility 'client'.agency.board.manageتغییرات ایجاد می‌کند
board_card_moveMove a card to another column, or to another position in its column.agency.board.manageتغییرات ایجاد می‌کند
board_card_commentComment on a card. Agency-only unless you pass visibility 'client', in which case the client sees it attributed to your agency.agency.board.commentتغییرات ایجاد می‌کند

صورتحساب و ارتقا

ابزارکارکرد آنمجوزیادداشت‌ها
subscriptions_listList the organization's subscriptions — the plan each one is on, its status, renewal date and whether it auto-renews.billing.viewفقط خواندنی
invoices_listList the organization's invoices and credit notes — number, status, total, currency and issue date. Optionally filter by status.billing.viewفقط خواندنی
upgrade_optionsWhat can be bought to lift a limit you have hit — bigger plans, priced with tax, in your own currency. Pass the entitlement from a refusal (e.g. 'max_sites'), or a site_id to see what that site's own plan could move to. Read-only: nothing is bought, and calling this costs nothing.billing.viewفقط خواندنی
purchase_quotePrice a plan exactly, with tax, in the customer's own currency — and nothing is bought or charged. Returns a quote_id to pass to purchase_authorize together with the total, which is what stops an agent committing someone to a figure they never saw. Quotes expire: re-quote rather than reusing an old id.billing.payment.manageتغییرات ایجاد می‌کند
purchase_authorizeComplete a purchase from a quote: places the order and charges the payment method on file. You must pass the exact total and currency purchase_quote returned — if the price has moved since, this refuses rather than charging a different amount. Retrying with the same quote_id returns the same order and never charges twice.billing.payment.manageتغییرات ایجاد می‌کند · درخواست تایید · می‌تواند هزینه کند

پشتیبانی

ابزارکارکرد آنمجوزیادداشت‌ها
tickets_listList the organization's support tickets — subject, status, priority and when they were last updated. Optionally filter by status or site.tickets.viewفقط خواندنی
ticket_createOpen a support ticket. Include what you already checked — an agent that has read the KB and run diagnostics should say so in the body, so a human does not repeat it.tickets.replyتغییرات ایجاد می‌کند

نماینده فروش

ابزارکارکرد آنمجوزیادداشت‌ها
reseller_overviewThe reseller programme in one read: status, whether you can sell, billing day, default markup, your panel hostname and nameservers, mail sending domain, support routing, commerce readiness and the languages your clients' panel offers.reseller.viewفقط خواندنی · فقط نمایندگان فروش
reseller_services_listList the sites you have provisioned for your clients — one row per service, with the client organisation, status, any hold you placed, what it costs you wholesale and what you sell it for. Your own sites are not here; use sites_list for those.reseller.viewفقط خواندنی · فقط نمایندگان فروش
reseller_service_getOne client service in full — status, plan, any hold, wholesale cost, your sell price, and its disk and bandwidth usage.reseller.viewفقط خواندنی · فقط نمایندگان فروش
reseller_service_suspendPut one of your client's services on a non-payment hold. The site stops serving until you release it. Requires confirm: true.reseller.provisionتغییرات ایجاد می‌کند · درخواست تایید · فقط نمایندگان فروش
reseller_service_unsuspendRelease a non-payment hold you placed on a client's service. The site starts serving again.reseller.provisionتغییرات ایجاد می‌کند · فقط نمایندگان فروش
reseller_prices_listYour price list: every plan you can sell, with the Zinn® list price, your wholesale cost, and the retail price you have set (if any).reseller.viewفقط خواندنی · فقط نمایندگان فروش
reseller_client_wallets_listEvery client wallet you hold a float in, with the balance per client and the total held per currency. This is money you have taken and not yet delivered service for.reseller.viewفقط خواندنی · فقط نمایندگان فروش

ادامه خواندن

ترمینال را ترجیح می‌دهید؟

مرجع خط فرمان Zinnector®

ساخته شده بر روی API عمومی

مرجع API

آنچه یک دستیار هوش مصنوعی می‌تواند برای شما انجام دهد

ابزارهای هوش مصنوعی و MCP

دستیار خود را در دو دقیقه متصل کنید

ابزارهای هوش مصنوعی را در داشبورد خود باز کنید، یک اتصال ایجاد کنید و تنظیماتی را که مشتری شما می‌خواند، جای‌گذاری کنید.