Servidor MCP

Deixe sua assistente de IA gerenciar sua hospedagem

Um servidor MCP para toda a sua conta. Conecte o Claude Code, o Claude Desktop ou o Cursor uma vez, e seu assistente poderá listar seus sites, ler os logs deles, sincronizar os arquivos deles com seu repositório e fazer o deploy — agindo apenas com as permissões que você conceder a ele.

65 ferramentas hoje, listadas abaixo exatamente como o servidor as oferece.

Conectar

Duas etapas. O token é a credencial inteira, portanto, trate-o como uma senha: ele é exibido uma vez e você pode revogar uma conexão sem afetar as outras.

Criar uma conexão
No seu painel, abra as ferramentas de IA, dê um nome à conexão, escolha seu cliente e marque o que ele pode fazer. Você só pode conceder permissões que você mesmo tem autorização para executar.
Cole a configuração que o seu cliente lê
O painel mostra a configuração do cliente que você escolheu, com seu token já inserido nele. Cada cliente se comunica com o mesmo endereço de servidor:
```
https://api.zinndigital.com/v1/mcp
```

Claude Code

Execute o comando único ou coloque o bloco em .mcp.json na raiz do seu projeto. A linha "type": "http" é obrigatória — sem ela, o Claude Code ignora o servidor.

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

O Claude Desktop inicia servidores locais, por isso ele executa a nossa CLI gratuita Zinnector® como uma ponte para o servidor hospedado. Ele requer o Node 24 ou mais recente. O token vai em env, nunca nos argumentos.

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

Cursor

Adicione o servidor a ~/.cursor/mcp.json (ou .cursor/mcp.json em um projeto) com o endereço e o cabeçalho Authorization.

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

Outro cliente MCP

Qualquer cliente que dê suporte a servidores HTTP Streamable remotos com um cabeçalho personalizado funciona: aponte-o para o endereço acima e envie Authorization: Bearer com o seu token. Um cliente que inicie apenas servidores locais pode usar a ponte do Claude Desktop.

O ChatGPT se conecta a servidores MCP apenas fazendo login com OAuth, portanto ainda não pode usar um token. Use a mesma conexão com Claude Code, Claude Desktop ou Cursor.

Verifique se funciona — quatro perguntas

Faça essas perguntas em linguagem clara. Abaixo de cada uma está a ferramenta que seu assistente deve chamar e a aparência de uma boa resposta.

```
> List my sites.
  ↳ sites_list
```
Seus sites com seus respectivos status e plano. Uma lista vazia em uma conta que possui sites significa que a conexão não tem permissão para visualizar sites.
```
> Show me the error log for example.com.
  ↳ site_logs
```
O registro de erros e o registro de acesso recentes. Se um deles não pôde ser lido, a resposta indica isso — o que é diferente de um registro vazio.
```
> Sync example.com to its repository.
  ↳ site_repo_sync_run
```
Um commit no seu repositório com o que quer que tenha mudado no site ativo, ou uma nota de que o repositório já correspondia. Se o repositório foi movido, a sincronização é suspensa e nada é sobrescrito.
```
> I pushed a commit — deploy example.com and tell me when it is live.
  ↳ site_deploy → site_deploy_status
```
O deploy está na fila e, em seguida, entra no ar com o commit aplicado. As ferramentas de IA pedem sua autorização no cliente antes de serem executadas.

Sincronização bidirecional, em ambas as direções

Um site com um repositório conectado mantém-se sincronizado com ele em ambas as direções, e o seu assistente pode operar em qualquer uma delas.

Site → repositório

Committe as alterações feitas nos arquivos ativos — uma edição no gerenciador de arquivos, uma atualização de plugin, um envio — e as envia para o seu branch, para que o seu próximo git pull as inclua.

site_repo_sync_run   ·   zinnector sync run

Repositório → site

Uma implantação aplica sua ramificação ao site. Envie seu commit e, em seguida, implante; em nossos próprios servidores, isso exige que a sincronização bidirecional esteja ativada, o que é gratuito.

site_deploy   ·   zinnector push

Quando ambos os lados mudaram

Nada é mesclado ou sobrescrito silenciosamente. A sincronização para, identifica o commit e espera você decidir se deseja manter o site ou manter o repositório. Manter o repositório descarta as alterações não sincronizadas do site, por isso é necessária confirmação.

site_repo_sync_resolve keep=site|repository confirm=true

O que mantém isso seguro

Apenas o que você concedeu

Cada ferramenta precisa de uma permissão, e uma conexão mantém apenas aquelas que você marcou. Os sites de outro cliente não existem até onde sua conexão pode perceber.

Confirmação para qualquer ação destrutiva

Reverter, restaurar, resolver uma sincronização retida e realizar compras exigem uma confirmação explícita, e qualquer coisa que custe dinheiro mostra o total exato primeiro.

Cada ação no seu log de auditoria

Cada chamada é registrada na conexão que a originou. Revogue uma conexão na página de ferramentas de IA e ela parará de funcionar imediatamente.

Todas as ferramentas

Todas as 65 ferramentas, geradas a partir do próprio registro do servidor — se estiver listada aqui, seu assistente poderá chamá-la.

Sites e implantações

Ferramenta	O que ele faz	Permissão	Notas
`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`	somente leitura
`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`	somente leitura
`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`	altera as coisas
`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`	altera as coisas
`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`	somente leitura
`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`	somente leitura
`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`	altera as coisas · solicita confirmação

Sincronização bidirecional

Ferramenta	O que ele faz	Permissão	Notas
`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`	somente leitura
`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`	altera as coisas
`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`	altera as coisas
`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`	altera as coisas · solicita confirmação

Logs e métricas

Ferramenta	O que ele faz	Permissão	Notas
`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`	somente leitura
`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`	somente leitura
`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`	somente leitura
`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`	somente leitura

Configuração e WordPress

Ferramenta	O que ele faz	Permissão	Notas
`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`	somente leitura
`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`	altera as coisas
`wordpress_state`	A WordPress site's core version, whether an update is available, and which management operations its hosting permits.	`sites.view`	somente leitura
`wordpress_plugins_list`	List a WordPress site's plugins — name, version, whether active and whether an update is available.	`sites.view`	somente leitura
`wp_plugin_update`	Update one WordPress plugin to its latest version. Returns the plugin list as it reads after the update.	`sites.panel_access`	altera as coisas
`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`	altera as coisas · solicita confirmação
`wordpress_set_plugin`	Activate or deactivate one plugin on a WordPress site. Takes effect on the live site immediately. Requires confirmation.	`sites.panel_access`	altera as coisas · solicita confirmação

Backups

Ferramenta	O que ele faz	Permissão	Notas
`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`	somente leitura
`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`	altera as coisas
`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`	altera as coisas · solicita confirmação

Domínios e DNS

Ferramenta	O que ele faz	Permissão	Notas
`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`	somente leitura
`dns_record_create`	Create a DNS record for a domain whose DNS we host.	`domains.dns.manage`	altera as coisas
`dns_record_update`	Update an existing DNS record for a domain whose DNS we host.	`domains.dns.manage`	altera as coisas
`dns_record_delete`	Delete a DNS record for a domain whose DNS we host.	`domains.dns.manage`	altera as coisas · solicita confirmação
`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`	somente leitura

Cache e rastreadores

Ferramenta	O que ele faz	Permissão	Notas
`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`	somente leitura
`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`	somente leitura
`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`	altera as coisas

E-mail

Ferramenta	O que ele faz	Permissão	Notas
`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`	somente leitura
`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`	somente leitura
`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`	altera as coisas
`mail_forwarders_list`	List the mail forwarders on one email service — which address goes where.	`mail.view`	somente leitura
`mail_forwarder_create`	Create a mail forwarder on an email service, sending everything for one address on to one or more destinations.	`mail.manage`	altera as coisas

SEO

Ferramenta	O que ele faz	Permissão	Notas
`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`	somente leitura
`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`	somente leitura

Imagens de IA

Ferramenta	O que ele faz	Permissão	Notas
`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`	somente leitura
`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`	altera as coisas · pode gastar dinheiro

Painéis

Ferramenta	O que ele faz	Permissão	Notas
`board_list`	List this organisation's project boards, newest first.	`agency.board.view`	somente leitura
`board_get`	Read one board in full: its columns and every card on them.	`agency.board.view`	somente leitura
`board_create`	Create a project board, optionally for one of your client organisations.	`agency.board.manage`	altera as coisas
`board_card_create`	Add a card to a column. Cards are agency-only unless you pass visibility 'client'.	`agency.board.manage`	altera as coisas
`board_card_move`	Move a card to another column, or to another position in its column.	`agency.board.manage`	altera as coisas
`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`	altera as coisas
`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`	altera as coisas
`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`	altera as coisas · solicita confirmação

Faturamento e atualizações

Ferramenta	O que ele faz	Permissão	Notas
`subscriptions_list`	List the organization's subscriptions — the plan each one is on, its status, renewal date and whether it auto-renews.	`billing.view`	somente leitura
`invoices_list`	List the organization's invoices and credit notes — number, status, total, currency and issue date. Optionally filter by status.	`billing.view`	somente leitura
`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`	somente leitura
`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`	altera as coisas
`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`	altera as coisas · solicita confirmação · pode gastar dinheiro

Suporte

Ferramenta	O que ele faz	Permissão	Notas
`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.		somente leitura
`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`	somente leitura
`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`	altera as coisas

Revendedor

Ferramenta	O que ele faz	Permissão	Notas
`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`	somente leitura · somente revendedores
`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`	somente leitura · somente revendedores
`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`	somente leitura · somente revendedores
`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`	altera as coisas · solicita confirmação · somente revendedores
`reseller_service_unsuspend`	Release a non-payment hold you placed on a client's service. The site starts serving again.	`reseller.provision`	altera as coisas · somente revendedores
`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`	somente leitura · somente revendedores
`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`	somente leitura · somente revendedores

Continuar lendo

Conecte seu assistente em dois minutos

Abra as ferramentas de IA no seu painel, crie uma conexão e cole a configuração que seu cliente lê.