tecof-mcp
Official@tecof/mcp
stdio MCP-сервер для Tecof Developer API v1. Работает внутри репозитория темы Tecof; читает компоненты темы с диска (AST), преобразует простые определения «секций», написанные агентом, в документ редактора и создаёт/обновляет страницы в статусе черновика через Developer API. Публикация всегда выполняется из панели (в API нет publish).
SDK:
@modelcontextprotocol/server@^2(+zod@^4) —McpServer+serveStdioNode ≥ 20, ESM
Поддерживаются аннотации инструментов (
readOnlyHint,destructiveHint) и_meta["anthropic/requiresUserInteraction"](для удаления)
Установка
В корне репозитория темы:
# 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_...' >> .envСервер запускается через npx; глобальная установка не требуется:
npx -y @tecof/mcp@latestПеременные окружения
Каталог проекта определяется в порядке TECOF_PROJECT_DIR → CLAUDE_PROJECT_DIR → process.cwd(); из него читаются .env и .env.local. process.env не перезаписывается — значения из файлов заполняют только пустые ключи (.env.local > .env).
Переменная | Обязательная | Описание |
| да | персональный ключ доступа |
| да* | адрес бэкенда; если нет — используется |
| нет | глобальный id темы; если нет — |
| нет | корень локального предпросмотра (по умолчанию |
| нет | если репозиторий темы находится в другом каталоге |
При отсутствии токена/URL сервер всё равно запускается; list_components и validate_document работают, инструменты страниц возвращают ошибку с подсказкой. Логи пишутся только в stderr; необработанные ошибки также попадают в stderr, процесс не падает.
Безопасность: TECOF_API_URL должен быть https. Если указан адрес http:// (не loopback), при запуске выводится предупреждение в stderr, и к каждой ошибке инструмента добавляется та же подсказка; редиректы http→https не отслеживаются (Node fetch при редиректе сбрасывает Authorization, что даёт вводящий в заблуждение 401) — ответ 3xx превращается в ошибку «схема/хост TECOF_API_URL неверны». Таймаут запроса (30 с) покрывает чтение заголовков и тела целиком.
Claude Code — .mcp.json
{
"mcpServers": {
"tecof": {
"type": "stdio",
"command": "npx",
"args": ["-y", "${TECOF_MCP_PACKAGE:-@tecof/mcp@latest}"]
}
}
}Переменная окружения TECOF_MCP_PACKAGE переопределяет спецификацию пакета — до публикации в npm или для локальной разработки укажите папку этого репозитория (npx -y /path/to/tecof-mcp запускает bin из папки):
export TECOF_MCP_PACKAGE=/Users/<siz>/Desktop/Tecof/tecof-mcp # claude'u bu shell'den başlatı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"]
}
}
}Токен не записывается ни в один файл конфигурации; он остаётся в .env. Клиентский процесс запускается в корне репозитория темы, сервер читает .env оттуда.
Related MCP server: officeagent-net
Инструменты
Инструмент | Вход | Что делает |
| — | магазин, языки, тема (themeId/merchantThemeId/domain), scope/срок действия токена, количество страниц |
|
| каталог темы (AST с диска, кэш по mtime). |
|
| список страниц (slug по возрастанию) |
|
| outline: дерево секций/слотов (id, type, краткий текст); full: draftData |
|
| проверяет без сохранения; |
|
| создаёт черновик; Header/Footer копируются из общих компонентов страницы |
|
| GET → применить операции → проверить → PUT (оптимистичная блокировка через |
|
| мягкое удаление — требуется подтверждение пользователя |
|
| ссылки предпросмотра черновика на 1 час (storefront + локальный) |
Результаты возвращаются как content[0].text (JSON) + structuredContent; ошибки имеют isError: true и содержат информацию о поле/пути (чтобы агент мог исправить).
Операции update_page
append_section{section} (перед Footer), insert_section{section, before?|after?} (если якорь не указан — как append, перед Footer), replace_section{id, section}, remove_section{id}, move_section{id, before?|after?}, set_props{id, props} (поверхностное слияние), set_slot{id, slot, children} (полностью заменяет слот; сначала строятся новые дети, при неудаче старое содержимое сохраняется), set_root_props{props}.
Примечания по поведению:
Общие компоненты доступны только для чтения — включая их дочерние узлы. Узел с
sharedComponentId(Header/Footer) и все его потомки в zones (Logo, NavLink, FooterColumn…) не могут быть изменены черезset_props/set_slot/replace_section/remove_section; возвращается ошибка «общий компонент — редактируйте в панельном редакторе». Сам общий корень можно удалить со страницы черезremove_section(с предупреждением; master не затрагивается). В outlineget_pageэти узлы помеченыshared: true.Разделение ошибок/предупреждений (режим operations): документ, полученный через GET, сначала нормализуется (inline-массивы слотов, оставшиеся в props → zones; узлы
SharedComponentRefс удалённым master отбрасываются с предупреждением — backend делает то же самое при PUT). Узлы, добавленные/изменённые агентом в этом ходе, проверяются строго (неизвестный type, нарушение allow, element-at-root → ошибка); нарушения в ранее существовавших, не тронутых узлах — только предупреждение: несвязанное обновление не блокируется из-за изменившейся темы. В режимеdocumentи вcreate_page/validate_documentвсе узлы проверяются строго.Пустой
operations: [](и нет meta) → ошибка «нет операций для применения»; PUT не отправляется. Если указан толькоmeta,draftDataне отправляется (status не меняется published→changed, лишняя ревизия не создаётся); в ответе это показывает полеsavedDraft.Предупреждения бэкенда при сохранении (
warnings: [{code,path,message}]в корне конверта, напр. отбрасывание ссылки на Header с удалённым master) возвращаются в ответеcreate_page/update_pageстрокамиsunucu: [code] path: message.
Формат авторства
Агент пишет не JSON документа, а дерево секций; генерация id, слияние defaultProps, преобразование slot → zone и многоязычные сокращения выполняются на сервере.
{
"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>" } } ] } }
]
}
}Правила преобразования:
Если
typeотсутствует в каталоге — ошибка; категорияelementв корне — ошибка; дочерний элемент слота внеallow— ошибка.props=defaultProps(−id, −inline-дети слотов) ←variants[variant].props(+_variant) ← пользовательскиеprops.Если
slots[slot]задан — он; если нет — примерные дети из defaultProps; если[]— пусто. Всё записывается вzones["<id>:<slot>"],props[slot] = [].Многоязычные сокращения:
"текст"→[{code: языкПоУмолчанию, value}];{tr, en}→[{code,value}]; отсутствующий язык — предупреждение.link:"/путь"→[{code, value:{url, target:"_self"}}].upload: строка URL → запись внешнего файла.Если значение
select/radioвнеoptions— ошибка. Ключи с префиксом_— ошибка (classNameразрешён).id: 8 символов
[A-Za-z0-9_-], уникален во всём документе (если передан валидный и уникальныйprops.id— принимается).
Разработка
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ğrularТесты не отправляют запросы к реальному бэкенду (мок fetch); каталог темы читается из копий компонентов в test/fixtures/theme.
Программное использование (HTTP transport и т.п.):
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