ealmeida
9741b4761d
Documenta as 9 tools do MCP dedicado multi-site (mcp-full-cliente, porta 3204) para gestão do broker de licenças WordPress premium (full-customer, api.full.services) — estado de ligação, plugins geridos, catálogo, extracto de licenças da conta e reactivação controlada.
63 lines
4.0 KiB
Markdown
63 lines
4.0 KiB
Markdown
---
|
|
name: mcp-full-cliente
|
|
description: MCP dedicado (HTTP StreamableHTTP local, ligação `full-cliente` em ~/.claude.json, porta 3204) para gestão do plugin FULL.Cliente (full-customer, broker de licenças WordPress premium, api.full.services) no cluster CWP — ligação de sites, extracto real de licenças da conta, catálogo activo, plugins geridos e reactivação controlada via WP-CLI/wp eval sobre full-customer. Usar quando "full cliente", "licença full", "licenças compradas", "reactivar licença", "extracto licenças", "ligar site à full", "desligar site full", "auditoria licenças frota", ou qualquer consulta/gestão de licenças premium geridas pelo broker FULL.Cliente.
|
|
layer: wiki
|
|
---
|
|
|
|
# /mcp-full-cliente — MCP dedicado FULL.Cliente (broker de licenças WordPress)
|
|
|
|
Projecto em `/media/ealmeida/Dados/Dev/mcp-full-cliente/` (TypeScript, SDK MCP
|
|
oficial, StreamableHTTP, porta `3204`). Substitui os comandos manuais
|
|
`wp eval-file` documentados na skill de conhecimento `full-cliente` por tools
|
|
estruturadas e tipadas com validação Zod.
|
|
|
|
**Multi-site:** aceita o parâmetro `site` em todas as tools (default:
|
|
`descomplicar.pt`). Sites suportados: `descomplicar.pt`,
|
|
`starter.descomplicar.pt`, `emanuelalmeida.pt`, `ccv.descomplicar.pt`,
|
|
`care.descomplicar.pt`, `ecommerce.descomplicar.pt`,
|
|
`ecommerce-demo.descomplicar.pt`, `e-commerce.descomplicar.pt`.
|
|
|
|
## Regra de ouro: "geridos" ≠ "comprado"
|
|
|
|
- `fc_list_managed_plugins` (`plugin-repository/updates`) — plugins cujo
|
|
updater está actualmente substituído pela FULL **neste site**.
|
|
- `fc_get_account_licenses` (`account/licenses-extract`) — **fonte de verdade
|
|
da conta**: extracto de produtos comprados, licenças disponíveis e lista de
|
|
domínios em uso por produto.
|
|
|
|
## Tools (9)
|
|
|
|
### Leitura (6)
|
|
1. `fc_connection_status` — estado da ligação do site à FULL (`fc/connection-email` no usermeta de admin ou option legado) e email/user associados.
|
|
2. `fc_list_managed_plugins` — plugins geridos neste site específico.
|
|
3. `fc_list_catalog` — catálogo completo da FULL com pesquisa por nome/slug.
|
|
4. `fc_get_account_licenses` — extracto real de licenças da conta (compradas, disponíveis, domínios em uso por produto).
|
|
5. `fc_audit_fleet_licenses` — agregação dos domínios activos em toda a conta vs sites do cluster.
|
|
6. `fc_list_supported_sites` — lista estática dos sites suportados e caminhos de docroot.
|
|
|
|
### Escrita com guardas (3)
|
|
7. `fc_connect_site` — liga um site à conta partilhada (`it@descomplicar.pt`), descobrindo automaticamente o ID de admin local ou aceitando `user_id`. Grátis (não consome licenças).
|
|
8. `fc_disconnect_site` — desliga localmente (requer `confirm: true`). **Aviso:** não liberta licenças no servidor da FULL (para libertar um domínio é necessário suporte da FULL).
|
|
9. `fc_reactivate_plugin` — reactiva licença de um plugin suportado de passo único (`astra-addon`, `seo-by-rank-math-pro`, `advanced-custom-fields-pro`, `wp-rocket`, `perfmatters`, `wpforms`, etc.). Requer `confirm: true` porque consome licença e abre ticket Zendesk na FULL. Exclui fluxos multi-step como `elementorPro` (OAuth) e `essentialAddons` (OTP).
|
|
|
|
## Credenciais
|
|
|
|
`.env` local (`WP_SSH_HOST=server`), sem tokens/API keys próprios — a
|
|
autenticação usa a sessão SSH root já configurada e o token de ligação
|
|
armazenado no usermeta do WordPress de cada site ligado.
|
|
|
|
## Verificação
|
|
|
|
Construído e testado ponta-a-ponta contra a API real da FULL e os sites
|
|
`descomplicar.pt` e `emanuelalmeida.pt` em 19-08-2026: 13/13 evaluations
|
|
automatizadas (`npm run eval:ci`). Deploy como processo `hub` persistente
|
|
(`mcp-full-cliente`, porta 3204, `http://127.0.0.1:3204/mcp`), registado em
|
|
`~/.claude.json` como `full-cliente`.
|
|
|
|
## Skills relacionadas
|
|
|
|
- `full-cliente` — skill de conhecimento profundo do broker: arquitectura do
|
|
plugin `full-customer`, endpoints da API `api.full.services`, fluxos
|
|
multi-step (OAuth Elementor Pro), e diagnóstico de licenças de fabricante
|
|
directo vs CodeCanyon vs FULL.
|