tecof-mcp
Official@tecof/mcp
Servidor MCP stdio para la API de desarrollador de Tecof v1. Se ejecuta desde dentro de un repositorio de temas de Tecof; lee los componentes del tema desde el disco (AST), convierte las definiciones simples de «secciones» escritas por el agente en un documento de editor y crea/actualiza páginas en borrador mediante la API de desarrollador. La publicación siempre se realiza desde el panel (no hay publish en la API).
SDK:
@modelcontextprotocol/server@^2(+zod@^4) —McpServer+serveStdioNode ≥ 20, ESM
Anotaciones de herramientas (
readOnlyHint,destructiveHint) y_meta["anthropic/requiresUserInteraction"](borrado) compatibles.
Instalación
En la raíz del repositorio de temas:
# 1) Panelden API anahtarı üretin: Ayarlar → Geliştirici / API Anahtarları (scope: pages:read, pages:write)
# 2) .env (gitignore'da) içine yazın
echo 'TECOF_API_TOKEN=tcf_...' >> .envEl servidor se ejecuta con npx; no requiere instalación global:
npx -y @tecof/mcp@latestVariables de entorno
El directorio del proyecto se determina en el orden TECOF_PROJECT_DIR → CLAUDE_PROJECT_DIR → process.cwd(); .env y .env.local se leen desde ahí. process.env no se sobrescribe: los valores de los archivos solo completan las claves vacías (.env.local > .env).
Variable | Obligatorio | Descripción |
| sí | Clave de acceso personal |
| sí* | Dirección del backend; si no, se usa |
| no | ID de tema global; si no, |
| no | Raíz de vista previa local (por defecto |
| no | Si el repositorio de temas está en otro directorio |
Si falta el token/URL, el servidor igualmente arranca; list_components y validate_document funcionan, y las herramientas de páginas devuelven un error orientativo. Los registros se escriben solo en stderr; los errores no capturados también van a stderr y el proceso no se bloquea.
Seguridad: TECOF_API_URL debe ser https. Si se proporciona una dirección http:// (fuera de loopback), se muestra una advertencia en stderr al inicio y se añade la misma pista a cada error de herramienta; las redirecciones http→https no se siguen (Node fetch elimina Authorization en la redirección, lo que producía un 401 engañoso) — una respuesta 3xx se convierte en el error «esquema/host de TECOF_API_URL incorrecto». El tiempo de espera de la solicitud (30 s) cubre la lectura completa de cabeceras y cuerpo.
Claude Code — .mcp.json
{
"mcpServers": {
"tecof": {
"type": "stdio",
"command": "npx",
"args": ["-y", "${TECOF_MCP_PACKAGE:-@tecof/mcp@latest}"]
}
}
}La variable de entorno TECOF_MCP_PACKAGE sobrescribe la especificación del paquete: indique la carpeta de este repositorio antes de publicarlo en npm o para desarrollo local (npx -y /path/to/tecof-mcp ejecuta el bin de la carpeta):
export TECOF_MCP_PACKAGE=/Users/<siz>/Desktop/Tecof/tecof-mcp # claude'u bu shell'den başlatınPublicación (npm)
npm run build && npm test && node scripts/smoke.mjs
npm version patch # ya da minor
npm publish --access public # @tecof kapsamı — tecof-theme-editor/analytics ile aynı hesapCodex — .codex/config.toml
[mcp_servers.tecof]
command = "npx"
args = ["-y", "@tecof/mcp@latest"]Gemini CLI — .gemini/settings.json
{
"mcpServers": {
"tecof": {
"command": "npx",
"args": ["-y", "@tecof/mcp@latest"]
}
}
}El token no se escribe en ningún archivo de configuración; permanece en .env. El proceso cliente se inicia en la raíz del repositorio de temas y el servidor lee el .env desde allí.
Related MCP server: officeagent-net
Herramientas
Herramienta | Entrada | Qué hace |
| — | Tienda, idiomas, tema (themeId/merchantThemeId/domain), alcance/caducidad del token, número de páginas |
|
| Catálogo del tema (AST desde disco, caché mtime). |
|
| Lista de páginas (slug ascendente) |
|
| outline: árbol de secciones/slots (id, type, texto corto); full: draftData |
|
| Valida sin guardar; |
|
| Crea un borrador; Header/Footer se copian de los componentes compartidos de la página |
|
| GET → aplicar operaciones → validar → PUT (bloqueo optimista con |
|
| Soft delete — requiere confirmación del usuario |
|
| Enlaces de vista previa del borrador por 1 hora (storefront + local) |
Los resultados se devuelven como content[0].text (JSON) + structuredContent; los errores llevan isError: true con información de campo/ruta (para que el agente pueda corregirlos).
Operaciones de update_page
append_section{section} (antes del Footer), insert_section{section, before?|after?} (si no hay ancla, como append, antes del Footer), replace_section{id, section}, remove_section{id}, move_section{id, before?|after?}, set_props{id, props} (fusión superficial), set_slot{id, slot, children} (reemplaza el slot por completo; primero se construyen los nuevos hijos, si falla se conserva el contenido anterior), set_root_props{props}.
Notas de comportamiento:
Los componentes compartidos son de solo lectura, incluidos sus nodos hijos. El nodo que lleva
sharedComponentId(Header/Footer) y todos sus descendientes bajo zones (Logo, NavLink, FooterColumn…) no se pueden modificar conset_props/set_slot/replace_section/remove_section; devuelve el error «componente compartido: edítelo desde el editor del panel». La raíz compartida en sí puede eliminarse de la página conremove_section(con advertencia; el master no se ve afectado). En el outline deget_page, estos nodos están marcados conshared: true.Distinción entre error y advertencia (modo operations): el documento procedente de GET se normaliza primero (las matrices de slots inline que quedaron en props → zones; los nodos
SharedComponentRefcuyo master se ha eliminado se descartan con advertencia — el backend hace lo mismo en el PUT). Los nodos que el agente añadió/modificó en esta ronda se validan estrictamente (tipo desconocido, violación de allow, element-at-root → error); las violaciones en nodos preexistentes no tocados son solo advertencias: una actualización no relacionada no se bloquea porque el tema haya cambiado. En el mododocumenty encreate_page/validate_document, todos los nodos se validan estrictamente.operations: []vacío (si tampoco hay meta) → error «no hay operaciones que aplicar»; no se hace PUT. Si solo se proporcionameta, no se envíadraftData(el estado no pasa de published→changed, no se abre una revisión innecesaria); el camposavedDraftde la respuesta lo indica.Las advertencias de guardado del backend (
warnings: [{code,path,message}]en la raíz del sobre, p. ej. la eliminación de un vínculo Header cuyo master se ha borrado) se devuelven en la respuesta decreate_page/update_pagecomo líneassunucu: [code] path: message.
Formato de autoría
El agente escribe un árbol de secciones, no un documento JSON; la generación de ids, la fusión de defaultProps, la conversión de slot → zone y los atajos multilingües se realizan en el servidor.
{
"type": "FeaturesSection",
"props": { "columns": "3", "background": "dark" },
"variant": "dark", // bileşenin variants anahtarı (varsa)
"slots": {
"contentSlot": [
{ "type": "Title", "props": { "text": { "tr": "Neden biz?", "en": "Why us?" }, "size": "lg" } }
],
"itemsSlot": [
{ "type": "Card", "props": { "href": "/hakkimizda" },
"slots": { "contentSlot": [ { "type": "Paragraph", "props": { "text": "<p>Hızlı teslimat</p>" } } ] } }
]
}
}Reglas de conversión:
Si
typeno está en el catálogo, error; la categoríaelementen la raíz, error; un hijo de slot fuera deallow, error.props=defaultProps(−id, −hijos de slot inline) ←variants[variant].props(+_variant) ←propsdel usuario.Si se proporciona
slots[slot], se usa ese; si no, los hijos de ejemplo en defaultProps; si se proporciona[], vacío. Todo se escribe enzones["<id>:<slot>"]yprops[slot] = [].Atajos multilingües:
"metin"→[{code: varsayılanDil, value}];{tr, en}→[{code,value}]; idioma faltante advertencia.link:"/yol"→[{code, value:{url, target:"_self"}}].upload: URL string → registro de archivo externo.Si el valor de
select/radioestá fuera deoptions, error. Las claves con prefijo_son error (classNamelibre).id: 8 caracteres
[A-Za-z0-9_-], único en todo el documento (si se proporciona unprops.idválido y único, se acepta).
Desarrollo
npm install
npm run build # tsc → dist/ (+ dist/bin.js +x)
npm test # vitest (parser, build, validate, operations, api mock, config, uçtan uca MCP)
node scripts/smoke.mjs # dist/bin.js'i stdio ile ayağa kaldırıp initialize + tools/list doğrularLos tests no hacen peticiones al backend real (mock de fetch); el catálogo de temas se lee de los componentes de copia en test/fixtures/theme.
Uso programático (transporte HTTP, etc.):
import { buildServer, ServerContext, loadConfig } from "@tecof/mcp";
const ctx = new ServerContext({ config: loadConfig() });
const server = buildServer({ ctx }); // McpServer — istediğiniz transport'a bağlayınAvailable Tools
9 toolscreate_pageSayfa oluştur (taslak)A
Yazarlık biçimindeki bölümlerden yeni bir TASLAK sayfa oluşturur. Header/Footer, layoutFrom sayfasındaki ortak bileşenlerden otomatik kopyalanır (varsayılan: home) — bunları sections içinde vermeyin. Önce list_components (full) ile alanları doğrulayın; dryRun:true ile kaydetmeden deneyin.
Inputs: slug (required), title (required), sections (required), meta, +2 more.
delete_pageSayfayı silADestructiveIdempotent
Sayfayı siler (soft delete; panelden geri alınabilir). Kullanıcı onayı olmadan ÇAĞIRMAYIN — confirm:true kullanıcının açık onayını temsil eder. Şablon sayfalar silinemez.
Inputs: page (required), confirm (required).
get_pageSayfayı getirARead-onlyIdempotent
Bir sayfanın taslağını döner. mode=outline (varsayılan): bölümler ve slot çocukları id/type/kısa metinle — update_page için id'leri buradan alın. mode=full: tam draftData JSON.
Inputs: page (required), mode.
get_preview_urlÖnizleme URL'si alARead-only
Sayfanın TASLAK hâli için 1 saat geçerli önizleme bağlantıları: yayındaki domain (storefront) ve yerel geliştirme (TECOF_LOCAL_URL). Yayınlama panelden yapılır.
Inputs: page (required), locale.
get_site_contextSite bağlamını getirARead-onlyIdempotent
Mağaza (diller, varsayılan dil), aktif tema (themeId/merchantThemeId/domain), API anahtarının kapsamı ve bitişi, sayfa sayısı. Diğer araçlardan önce çağırın.
Inputs: no named parameters.
list_componentsTema bileşenlerini listeleARead-onlyIdempotent
Tema reposundaki section ve element bileşenlerini diskten okur. summary: ad, label, kategori, slot adları. full: alanlar (tip, seçenekler, slot allow listesi), defaultProps, variants. Bölüm yazmadan önce full ile alan adlarını doğrulayın.
Inputs: detail, category, component.
list_pagesSayfaları listeleARead-onlyIdempotent
Aktif temadaki sayfaları listeler (id, slug, başlık, durum: draft/published/changed, tarihler).
Inputs: includeTemplates.
update_pageSayfayı güncelle (taslak)A
Sayfa taslağını günceller. Ya operations (append/insert/replace/remove/move_section, set_props, set_slot, set_root_props — id'ler get_page outline'dan; append_section ve anchor'sız insert_section yeni bölümü Footer'ın ÖNÜNE koyar) ya da document (tam doküman) verin; meta ile başlık/slug/meta alanları (yalnız meta verilirse draftData'ya dokunulmaz). Ortak bileşenler (Header/Footer) ve onların ALT düğümleri değiştirilemez. dryRun:true kaydetmez.
Inputs: page (required), meta, dryRun, document, +1 more.
validate_documentDokümanı doğrulaARead-onlyIdempotent
Kaydetmeden doğrular. Ya sections (yazarlık biçimi: type/props/variant/slots) ya da document (tam {root,content,zones}) verin. Hatalar yol + açıklama ile döner; ok=true ise normalizedDocument kaydedilebilir haldedir.
Inputs: document, sections.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool targets a distinct resource/action: context, component listing, page listing, page detail, validation, page create/update/delete, and preview. There is no meaningful overlap; validate_document is clearly separate from create/update dryRun as a standalone check.
All tools use a consistent snake_case verb_noun pattern: get_site_context, list_components, list_pages, get_page, validate_document, create_page, update_page, delete_page, get_preview_url. No camelCase or mixed verb styles appear.
Nine tools is well-scoped for a page-management server: context, component introspecton, page CRUD, validation, and preview. Each tool serves a clear purpose without redundancy.
The tool set covers the page draft lifecycle well: create, read, list, update, delete, validate, and preview. It is slightly incomplete for the full page lifecycle because publishing is intentionally left to the panel, so an agent cannot publish or unpublish a page through the server.
Maintenance
Related MCP Connectors
MCP server for managing FormDesigner forms, fields, logic rules, themes, and entries
Read-only MCP server over the developer docs for the portfolio's JSON API, MCP, A2A and NLWeb.
Create, edit, preview, publish, and manage web pages from MCP-capable AI clients.
An MCP server that provides access to Agility CMS. See https://mcp.agilitycms.com for more details.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server for generating AntiCMS v3 JSON component templates with validation and field type support.11 npmMIT
- AlicenseAqualityBmaintenanceMCP server that lets agents edit real Microsoft Word (.docx) documents - tracked changes, tables, styles, comments, content controls, and document properties - with every edit validated and previewed before saving. Built on the Open XML SDK (no Word automation); reads and writes documents in place through filesystem or SharePoint storage.1628MIT

kiubi-local-mcpofficial
AlicenseNot gradedqualityCmaintenanceLocal MCP server for Kiubi graphic theme integration, exposing tools for documentation, theme introspection, and static file validation to AI agents like Claude and Cursor.16 npm1ISC
user-majico-mcpofficial
AlicenseNot gradedqualityCmaintenanceMCP server for Majico.xyz that enables coding agents to read (and limited write) brand guidelines, design tokens, studio canvas, and export manifests.9 npmMIT