Adeegaha MCP

U oggolow kaaliyahaaga AI inuu maamulo martigelintaada

Hal server ee MCP oo loogu talagalay dhammaan akoonkaaga. Hal mar ku xidh Claude Code, Claude Desktop ama Cursor, kaaliyahaaguna wuxuu taxli karaa mareegahaaga, akhriyi karaa diiwaankooda, wada waafajin karaa faylashooda kaydkaaga oo uu soo bandhigi karaa - isaga oo ku shaqaynaya oo keliya ogolaanshaha aad siiso.

65 qalab maanta, oo hoos ku qoran sida uu adeegegu u bixiyo.

Ku xidh

Labada tallaabo. Astaanta aqoonsigu waa aqoonsiga oo dhan, markaa ula dhaqmi sida erayga sirta ah: hal mar ayaa la tusiyaa, waxaadna joojin kartaa hal xiriirin adiga oo aan taaban kuwa kale.

Abuur xiriir
Dashboards-kaaga, fur qalabka AI, u bixi magaca xiriirinta, dooro macaamiishaada oo calaamadee waxa ay qaban karaan. Waxaad siin kartaa oo keliya waxa adigu laguu ogol yahay inaad sameyso.
Ku dheji habaynta uu macaamiilku akhriyo
Dashbood-ka wuxuu muujinayaa habaynta macaamiisha aad dooratay, iyadoo calaamadaadu ay hore ugu dhex jirto. Macmiil kastaa wuxuu la hadlayaa cinwaanka server-ka isla mid ah:
```
https://api.zinndigital.com/v1/mcp
```

Claude Code

Soodhac amarka kaliya, ama geli baloogga ku jira .mcp.json ee xididka mashruucaaga. Sadarka "type": "http" waa qasab — iyada oo aan la joogin Claude Code waxa uu ka boodayaa adeegaha.

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 waxay bilowdaa server-yada maxalliga ah, markaa waxay waddaa CLI-geenna bilaashka ah ee Zinnector® oo ah buundo isku xirta server-ka la martigeliyay. Waxay u baahan tahay Node 24 ama ka cusub. Astaanta waxaa la geliyaa env, ee looma geliyo doodaha.

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

Camarada

Kudar server-ka ~/.cursor/mcp.json (ama .cursor/mcp.json ee mashruuc dhexdiisa) cinwaanka iyo madaxa Oggolaanshaha (Authorization header).

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

MCP client kasta oo kale

Kasta oo ka mid ah macaamiisha taageerta server-ada Streamable HTTP ee fog oo leh madax caado ah ayaa shaqeeya: ku tilmaami ciwaanka kore oo u dir Authorization: Bearer oo wata summadaada (token). Macmiil bilaaba server-ada maxalliga ah oo keliya ayaa isticmaali kara buundada Claude Desktop.

ChatGPT waxay ku xidhaa server-mada MCP iyadoo la adeegsanayo saxiixida OAuth keliya, markaa ma isticmaali karto calaamad (token) weli. Isticmaal isku xirkaas oo kale leh ChatGPT, Claude, Claude Code, Claude Desktop ama Cursor.

Ka hubi in uu shaqeynayo — afar su'aal

Ku Weydii kuwan luuqad cad. Hoos kasta waxaa ku yaal aaladda uu caawiyahaagu yeeri lahaa iyo sida jawaabta fiican ay u egtahay.

```
> List my sites.
  ↳ sites_list
```
Goobahaaga oo wata heerkooda iyo qorshahooda. Liis madhan oo ku yaal akoon leh goobo waxay ka dhigan tahay in xiriirku ka maqan yahay ogolaanshaha lagu arko goobaha.
```
> Show me the error log for example.com.
  ↳ site_logs
```
Diiwaanka khaladka iyo diiwaanka gelitaanka ee dhowaan. Haddii aan midkood la akhrin karin, jawaabtu sidaas ayay sheegaysaa—taasi waa mid ka duwan diiwaanka madhan.
```
> Sync example.com to its repository.
  ↳ site_repo_sync_run
```
Commit-ka ku jira kaydkaaga (repository) oo wata wixii isbeddel ah ee ku yimid bogga nool, ama xusuusin ah in kaydku hore u waafaqsanaa. Haddii kaydku dhaqaaqo, wada-socodsiinta (sync) waa la hayaa mana jiro wax la dul-qorayo.
```
> I pushed a commit — deploy example.com and tell me when it is live.
  ↳ site_deploy → site_deploy_status
```
Gelinta waa la safay, kadibna waxay toos u noqotaa ballanka la codsaday. Qalabka qorista ayaa ku weydiinaya ogolaanshahaaga macmiilka ka hor intaysan shaqeyn.

Isku-dubarid laba-geesood ah, labada dhinacba

Bogga ku xiran bakhaarka (repository) wuxuu la siman yahay labada dhinacba, kaaliyahaaguna wuxuu hagi karaa labada dhinacba.

Goob → keydka xogta

Waxay dammaanad qaadaysaa in wixii isbeddel ah ee ku yimid faylasha nool — tafatir ku jira maamulaha faylka, cusboonaysiin plugin, ama soo rarid — loo riixo laantaada, si git pull-kaaga xiga uu u helo.

site_repo_sync_run   ·   zinnector sync run

Kaydka → bogga

Bixintu waxay laamahaaga ka dhigaysaa goobtaada. Riix gudbintaada, kadibna bixi; adeegayaashayada waxay u baahan yihiin laba-geesood is-waafajin ah oo shaqaynaya, kaas oo ah bilaash.

site_deploy   ·   zinnector push

Markii labada dhinacba is beddeleen

Wax so ah si aamusan looma mideeyo ama looma dulqoro. Isku-sidku wuu istaagaa, wuxuu magacaabaa is-beddelka, wuxuuna sugayaa inaad haysato mareegaha ama aad haysato keydka. Kaydka oo la haysto wuxuu tuurayaa is-beddellada aan la isku-sidin ee mareegaha, markaas waxay u baahan tahay xaqiijin.

site_repo_sync_resolve keep=site|repository confirm=true

Waxa ka ilaalinaya ammaan

Kaliya waxa aad fasaxday

Qalab kasta wuxuu u baahan yahay ogolaansho, isku xidhuna wuxuu haystaa oo keliya kuwa aad calaamadaysay. Mareegaha macaamiisha kale ma jiraan ilaa inta uu isku xidhkaagu garan karo.

Xaqiijinta wax kasta oo waxyeelo leh

Dib u celinta, soo celinta, xallinta wada-shaqeynta haysata iyo iibsashada dhammaantood waxay u baahan yihiin xaqiijin cad, wax kasta oo lacag ku kacayana waxay ku tusi doonaan wadarta saxda ah marka hore.

Tallaabo kasta oo ku jirta diiwaankaaga hantisaabaynta

Wicitaan kasta waxaa lagu diiwaangeliyaa isku xirka sameeyay. Baabi'i isku xirka bogga aaladaha AI wuxuuna joojinayaa inuu shaqeeyo si degdeg ah.

Qalab kasta

Dhammaan 65 qalab, oo laga soo saaray diiwaanka server-ka — haddii halkan lagu qoro, kaaliyahaagu wuu wici karaa.

Goobaha iyo geynta

Qalab	Waxa uu qabto	Ogolaansho	Qoraallada hoose
`sites_list`	List 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`	akhristaa oo qura
`site_get`	Get one site's full record — domain, status, product line, stack, runtime, PHP version, region, plan and whether it is scheduled for deletion.	`sites.view`	akhristaa oo qura
`site_create`	Create 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`	wax ka beddelaya waxyaabaha
`site_deploy`	Deploy 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`	wax ka beddelaya waxyaabaha
`site_deploy_status`	The site's current deploy state — status, target, the live URL, the deployed commit and when it last went live.	`sites.view`	akhristaa oo qura
`site_deployments_list`	List a site's recent deployments — id, status, commit, branch and timings. Use this to choose the deployment_id to roll back to.	`sites.view`	akhristaa oo qura
`site_rollback`	Roll 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`	wax ka beddelaya waxyaabaha · waxay codsaneysaa xaqiijin

Isku-dubarid laba-jiho ah

Qalab	Waxa uu qabto	Ogolaansho	Qoraallada hoose
`site_repo_sync_get`	Show 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`	akhristaa oo qura
`site_repo_sync_set`	Turn 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`	wax ka beddelaya waxyaabaha
`site_repo_sync_run`	Sync 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`	wax ka beddelaya waxyaabaha
`site_repo_sync_resolve`	Resolve 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`	wax ka beddelaya waxyaabaha · waxay codsaneysaa xaqiijin

Diiwaannada iyo cabbiraadaha

Qalab	Waxa uu qabto	Ogolaansho	Qoraallada hoose
`site_metrics`	Current 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`	akhristaa oo qura
`site_usage`	One site's metered visit usage for the current billing period, with the plan's allowance and what any overage costs.	`sites.view`	akhristaa oo qura
`site_logs`	Read 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`	akhristaa oo qura
`site_build_log`	Read 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`	akhristaa oo qura

Habeynta iyo WordPress

Qalab	Waxa uu qabto	Ogolaansho	Qoraallada hoose
`site_php_version_get`	The site's current PHP version and every version it is allowed to switch to on its product line.	`sites.view`	akhristaa oo qura
`site_php_version_set`	Switch 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`	wax ka beddelaya waxyaabaha
`wordpress_state`	A WordPress site's core version, whether an update is available, and which management operations its hosting permits.	`sites.view`	akhristaa oo qura
`wordpress_plugins_list`	List a WordPress site's plugins — name, version, whether active and whether an update is available.	`sites.view`	akhristaa oo qura
`wp_plugin_update`	Update one WordPress plugin to its latest version. Returns the plugin list as it reads after the update.	`sites.panel_access`	wax ka beddelaya waxyaabaha
`wordpress_update_core`	Update 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`	wax ka beddelaya waxyaabaha · waxay codsaneysaa xaqiijin
`wordpress_set_plugin`	Activate or deactivate one plugin on a WordPress site. Takes effect on the live site immediately. Requires confirmation.	`sites.panel_access`	wax ka beddelaya waxyaabaha · waxay codsaneysaa xaqiijin

Guriyaha

Qalab	Waxa uu qabto	Ogolaansho	Qoraallada hoose
`backups_list`	A 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`	akhristaa oo qura
`backup_create`	Take 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`	wax ka beddelaya waxyaabaha
`backup_restore`	Restore 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`	wax ka beddelaya waxyaabaha · waxay codsaneysaa xaqiijin

Domainyada iyo DNS

Qalab	Waxa uu qabto	Ogolaansho	Qoraallada hoose
`dns_records_list`	List 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`	akhristaa oo qura
`dns_record_create`	Create a DNS record for a domain whose DNS we host.	`domains.dns.manage`	wax ka beddelaya waxyaabaha
`dns_record_update`	Update an existing DNS record for a domain whose DNS we host.	`domains.dns.manage`	wax ka beddelaya waxyaabaha
`dns_record_delete`	Delete a DNS record for a domain whose DNS we host.	`domains.dns.manage`	wax ka beddelaya waxyaabaha · waxay codsaneysaa xaqiijin
`domains_list`	List 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`	akhristaa oo qura

Keshka iyo gurguurteyaasha

Qalab	Waxa uu qabto	Ogolaansho	Qoraallada hoose
`cache_purge`	Purge 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`	akhristaa oo qura
`crawler_policy_get`	Get 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`	akhristaa oo qura
`crawler_policy_set`	Set 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`	wax ka beddelaya waxyaabaha

Iimayl

Qalab	Waxa uu qabto	Ogolaansho	Qoraallada hoose
`mail_services_list`	List 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`	akhristaa oo qura
`mailboxes_list`	List the mailboxes on one email service, with each mailbox's size, how full it is, and whether it can send and receive.	`mail.view`	akhristaa oo qura
`mailbox_create`	Create a mailbox on an email service. Returns the new mailbox's password, which is shown once and cannot be retrieved later.	`mail.manage`	wax ka beddelaya waxyaabaha
`mail_forwarders_list`	List the mail forwarders on one email service — which address goes where.	`mail.view`	akhristaa oo qura
`mail_forwarder_create`	Create a mail forwarder on an email service, sending everything for one address on to one or more destinations.	`mail.manage`	wax ka beddelaya waxyaabaha

SEO

Qalab	Waxa uu qabto	Ogolaansho	Qoraallada hoose
`site_seo_metrics`	The 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`	akhristaa oo qura
`domain_index_check`	The 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`	akhristaa oo qura

Sawirrada AI

Qalab	Waxa uu qabto	Ogolaansho	Qoraallada hoose
`image_models_list`	The 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`	akhristaa oo qura
`image_generate`	Generate 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`	wax ka beddelaya waxyaabaha · lacag bixin kartaa

Looxyada

Qalab	Waxa uu qabto	Ogolaansho	Qoraallada hoose
`board_list`	List this organisation's project boards, newest first.	`agency.board.view`	akhristaa oo qura
`board_get`	Read one board in full: its columns and every card on them.	`agency.board.view`	akhristaa oo qura
`board_create`	Create a project board, optionally for one of your client organisations.	`agency.board.manage`	wax ka beddelaya waxyaabaha
`board_card_create`	Add a card to a column. Cards are agency-only unless you pass visibility 'client'.	`agency.board.manage`	wax ka beddelaya waxyaabaha
`board_card_move`	Move a card to another column, or to another position in its column.	`agency.board.manage`	wax ka beddelaya waxyaabaha
`board_card_comment`	Comment on a card. Agency-only unless you pass visibility 'client', in which case the client sees it attributed to your agency.	`agency.board.comment`	wax ka beddelaya waxyaabaha
`board_share_link_create`	Create a copy-paste link to a board that you can send in any chat or email. Defaults to a read-only link that needs no Zinn® account to open.	`agency.board.manage`	wax ka beddelaya waxyaabaha
`board_share_link_revoke`	Revoke a board share link. This also removes anybody who joined the board through it, so use it when a link has gone somewhere it should not have.	`agency.board.manage`	wax ka beddelaya waxyaabaha · waxay codsaneysaa xaqiijin

Biilasha iyo casriyeynta

Qalab	Waxa uu qabto	Ogolaansho	Qoraallada hoose
`subscriptions_list`	List the organization's subscriptions — the plan each one is on, its status, renewal date and whether it auto-renews.	`billing.view`	akhristaa oo qura
`invoices_list`	List the organization's invoices and credit notes — number, status, total, currency and issue date. Optionally filter by status.	`billing.view`	akhristaa oo qura
`upgrade_options`	What 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`	akhristaa oo qura
`purchase_quote`	Price 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`	wax ka beddelaya waxyaabaha
`purchase_authorize`	Complete 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`	wax ka beddelaya waxyaabaha · waxay codsaneysaa xaqiijin · lacag bixin kartaa

Taageero

Qalab	Waxa uu qabto	Ogolaansho	Qoraallada hoose
`kb_search`	Search the published knowledge base for how-to and troubleshooting articles. Returns title, slug and summary so the agent can try a documented fix before opening a ticket.		akhristaa oo qura
`tickets_list`	List the organization's support tickets — subject, status, priority and when they were last updated. Optionally filter by status or site.	`tickets.view`	akhristaa oo qura
`ticket_create`	Open 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`	wax ka beddelaya waxyaabaha

Wakiilka iibiyaha

Qalab	Waxa uu qabto	Ogolaansho	Qoraallada hoose
`reseller_overview`	The 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`	akhristaa oo qura · iibiyayaasha oo kaliya
`reseller_services_list`	List 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`	akhristaa oo qura · iibiyayaasha oo kaliya
`reseller_service_get`	One client service in full — status, plan, any hold, wholesale cost, your sell price, and its disk and bandwidth usage.	`reseller.view`	akhristaa oo qura · iibiyayaasha oo kaliya
`reseller_service_suspend`	Put one of your client's services on a non-payment hold. The site stops serving until you release it. Requires confirm: true.	`reseller.provision`	wax ka beddelaya waxyaabaha · waxay codsaneysaa xaqiijin · iibiyayaasha oo kaliya
`reseller_service_unsuspend`	Release a non-payment hold you placed on a client's service. The site starts serving again.	`reseller.provision`	wax ka beddelaya waxyaabaha · iibiyayaasha oo kaliya
`reseller_prices_list`	Your 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`	akhristaa oo qura · iibiyayaasha oo kaliya
`reseller_client_wallets_list`	Every 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`	akhristaa oo qura · iibiyayaasha oo kaliya

Sii akhri

Ku xir caawiyehaaga laba daqiiqadood gudahood

Ka fur qalabka AI ee golahaaga maamulka, samee xiriirin, oo dheji qaabeynta ay macaamiishaadu akhrinayaan.