К основному содержанию
скилл CX Codex

visant-mcp-connect — скилл для Claude Code: подключение Visant

Скилл visant-mcp-connect для Claude Code подключает инструменты Visant Labs через MCP. Он срабатывает на просьбы настроить Visant, вызвать его инструменты или извлечь данные из PDF.

MIT ★ 91 обновлён 2026-11-11

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add pedrojaques99/visant-skills-public --skill visant-mcp-connect -a claude-code
Открыть на GitHub

Что делает visant-mcp-connect

Скилл настраивает подключение к MCP-серверу Visant Labs и даёт агенту доступ к его инструментам. Через них можно работать с бренд-гайдами, макетами, бюджетами, мудбордами и холстами, а также извлекать данные из PDF.

Для работы нужна учётная запись Visant Labs: анонимного режима нет. Генерация расходует кредиты аккаунта. В Claude Code подключение настраивается командой claude mcp add к https://api.visantlabs.com/api/mcp; после настройки инструменты доступны в следующей сессии с префиксом mcp__visant__.

Какие задачи решает

  • подключить MCP-сервер Visant Labs к агенту
  • создать или обновить бренд-гайд
  • сгенерировать макет по описанию
  • извлечь бренд-токены из PDF

Примеры запросов агенту

  • Подключи Visant Labs и настрой его инструменты в Claude Code.
  • Используй инструменты Visant, чтобы обновить бренд-гайд.
  • Извлеки данные и бренд-токены из PDF через Visant.

Как установить visant-mcp-connect

1Через Skills CLI (Vercel)

npx skills add pedrojaques99/visant-skills-public --skill visant-mcp-connect -a claude-code

2Вручную: положить файлы

~/.claude/skills/visant-mcp-connect/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/visant-mcp-connect/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о visant-mcp-connect

Как установить visant-mcp-connect в Claude Code?

Выполни npx skills add pedrojaques99/visant-skills-public --skill visant-mcp-connect -a claude-code. Файл скилла появится по пути ~/.claude/skills/visant-mcp-connect/SKILL.md.

Что делает visant-mcp-connect?

Он подключает Claude Code к Visant Labs через MCP. Инструменты сервиса работают с бренд-гайдами, макетами и бюджетами, а также извлекают данные из PDF.

Что нужно для работы visant-mcp-connect?

Нужна учётная запись Visant Labs. Генерация расходует кредиты аккаунта.

Исходный текст

SKILL.md · MIT
---
name: visant-mcp-connect
description: 'Connects and operates the Visant Labs MCP (requires a Visant Labs account): brand guidelines, mockups, creative studio, canvas, budgets, moodboard, PDF extraction. Use on "connect visant", "use the visant tools", "setup visant mcp", "conecta o visant", "usar as tools do visant", "extrair PDF pelo visant".'
tags:
  - mcp
  - visant
  - brand
  - ai-tools
metadata:
  family: marca
---

# Visant Labs MCP

> **Requires a Visant Labs account** (visantlabs.com). Without one, none of these
> tools work: there is no anonymous mode. Generation tools also spend the
> account's credits.

**API:** `https://api.visantlabs.com`
**MCP:** `https://api.visantlabs.com/api/mcp`
**Auth:** OAuth 2.1 + PKCE (dynamic client registration) or API key (`visant_sk_...`)

---

## Connect (Claude-first flow)

### Step 1: check for existing credentials

```bash
cat ~/.visant/credentials.json
```

If it exists and has `apiKey`, skip to Step 3.

### Step 2: authenticate

Ask the user for their Visant Labs email and password, then run:

```bash
npx visantlabs login -e EMAIL -p PASSWORD
```

This saves `~/.visant/credentials.json` with the permanent `apiKey`
(`visant_sk_...`).

### Step 3: configure the MCP (global, any directory)

```bash
claude mcp add --transport http \
  --header "Authorization: Bearer <apiKey>" \
  --scope user \
  visant https://api.visantlabs.com/api/mcp
```

> **Do not use** `mcpServers` in `settings.json` or `mcp-remote`: the server
> speaks Streamable HTTP directly.

### Step 4: verify

```bash
claude mcp list
# should show: visant: https://api.visantlabs.com/api/mcp (HTTP) - ✓ Connected
```

The tools show up with the `mcp__visant__` prefix in the next session.

---

## Available tools (~50)

### Account & Auth
| Tool | What it does |
|------|-----------|
| `account-profile` | User profile (name, email, plan) |
| `account-usage` | Remaining credits, limits, billing cycle |
| `auth-login` | Email/password login → JWT |
| `auth-register` | Create account → JWT |
| `api-key-create` | Generate a `visant_sk_xxx` API key |
| `api-key-list` | List existing API keys |

### Brand Guidelines (16 tools)
| Tool | What it does |
|------|-----------|
| `brand-guidelines-list` | List all brand guidelines |
| `brand-guidelines-get` | Full data (JSON, or `format:"prompt"` for LLM-ready text) |
| `brand-guidelines-create` | Create a new guideline |
| `brand-guidelines-update` | Partial patch (colors, typography, strategy, tokens) |
| `brand-guidelines-delete` | Delete (requires `confirm: true`) |
| `brand-guidelines-duplicate` | Duplicate a guideline |
| `brand-guidelines-share` | Create/revoke a public link |
| `brand-guidelines-public` | Access by slug (no auth) |
| `brand-guidelines-ingest` | Extract from URL/text and merge into the guideline |
| `brand-guidelines-compliance-check` | AI audit (contrast, typography, voice, completeness) |
| `brand-guidelines-versions` | Version history |
| `brand-guidelines-restore-version` | Restore a previous version |
| `brand-guidelines-upload-logo` | Upload logo (base64/URL, variants: primary/dark/light/icon) |
| `brand-guidelines-upload-media` | Upload media kit (image/PDF) |
| `brand-guidelines-delete-logo` | Delete logo by ID |
| `brand-guidelines-delete-media` | Delete media by ID |

### Branding Machine (5 tools)
| Tool | What it does |
|------|-----------|
| `branding-generate` | Generate a visual identity from a prompt (steps: full/market-research/swot/persona/archetype/concept-ideas/color-palettes/moodboard). Follows `visant-methodology` |
| `branding-list` | List branding projects |
| `branding-get` | Project details |
| `branding-save` | Save/update a project |
| `branding-delete` | Delete a project |

### Mockup Machine (5 tools)
| Tool | What it does |
|------|-----------|
| `mockup-generate` | Generate an AI mockup. Models: `gpt-image-2` (best), `gemini-3.1-flash-image-preview`, `seedream-3-0`. Resolutions: 1K/2K/4K. Aspect ratios: 1:1/16:9/9:16/4:5. Auto-injects brand context via `brandGuidelineId`. |
| `mockup-list` | List mockups |
| `mockup-get` | Mockup details |
| `mockup-update` | Update metadata |
| `mockup-delete` | Delete |
| `mockup-presets` | Presets by category (business-card, social-media, packaging, apparel, etc.) |

### Creative Studio (8 tools)
| Tool | What it does |
|------|-----------|
| `creative-full` | Full pipeline: plan → background → render PNG → save. One shot. |
| `creative-generate` | Generate a structured layout (layers, overlay, background prompt) |
| `creative-render` | Render a plan to PNG server-side |
| `creative-projects-create` | Save a creative project |
| `creative-projects-list` | List projects |
| `creative-projects-get` | Project details |
| `creative-projects-update` | Update a project |
| `creative-projects-delete` | Delete a project |

### Canvas / Whiteboard (8 tools)
| Tool | What it does |
|------|-----------|
| `canvas-create` | Create a whiteboard |
| `canvas-list` | List projects |
| `canvas-list-projects` | List with a summary of node types |
| `canvas-get` | Details (nodes, edges, drawings) |
| `canvas-update` | Update nodes/edges/linkedGuideline |
| `canvas-delete` | Delete |
| `canvas-share` | Share (canEdit/canView by email) |
| `canvas-parse-csv` | Preview CSV → DataNode rows |
| `canvas-resolve-variables` | Resolve `{{placeholders}}` in a prompt |

### Budget (6 tools)
| Tool | What it does |
|------|-----------|
| `budget-create` | Create a budget (clientName, projectDescription) |
| `budget-list` | List budgets |
| `budget-get` | Details with line items |
| `budget-update` | Update fields |
| `budget-delete` | Delete |
| `budget-duplicate` | Duplicate |

### AI Utilities (free)
| Tool | What it does |
|------|-----------|
| `ai-describe-image` | Describe an image (URL or base64). 0 credits. |
| `ai-improve-prompt` | Improve prompt text. 0 credits. |

> **House rule: a generated prompt is a saved prompt.** Every call to
> `ai-generate-image` / `creative-generate` / `mockup-generate` / `video-generate`
> goes to the project's `prompts.jsonl` ledger: one line per call, with
> model/params, refs **with each one's role**, `sha256` of the output, status
> (approved/discarded), cost, and a note on what went wrong for discarded ones.
> Record it on the spot: it cannot be recovered later. If `visant-mockup-creator`
> is installed, the contract is in its `references/prompt-ledger.md`.

### Document & Image Extraction
| Tool | What it does |
|------|-----------|
| `document-extract` | **Dual mode**, see "Document Extract" below. URL mode pulls HD images from any public page; PDF mode turns a PDF into markdown + brand tokens. |

### Moodboard (3 tools)
| Tool | What it does |
|------|-----------|
| `moodboard-detect-grid` | Detect bounding boxes in a moodboard grid |
| `moodboard-suggest` | Suggest animations/video for each cell |
| `moodboard-upscale` | Upscale an image to 1K/2K/4K. **⚠ Unstable: returned `INTERNAL_ERROR` on 3/3 calls in Aug 2026.** See "When a tool goes down". |

### Community (2 tools)
| Tool | What it does |
|------|-----------|
| `community-presets` | Browse public mockup presets |
| `community-profiles` | Browse community profiles |

---

## When a tool goes down

MCP tools break, and the right response is never to insist or to pretend the
result came out:

1. **Two attempts, no more.** Repeated `INTERNAL_ERROR` is the server, not the
   payload; a third try only burns time.
2. **Use the alternative and say which one.** Never swap silently: whoever reads
   the result needs to know which path it came through.
3. **Report the breakage** in the work's `.md`, with the date and the exact
   message.

| If it fails | Alternative |
|---|---|
| `moodboard-upscale` | Look for the high-res ORIGINAL before upscaling: it almost always exists and nobody looked (run [[visant-preflight]]). Upscaling is plan B; upscaling without searching for the original is plan C dressed as plan A. |
| `ai-generate-image` falls back to the wrong model | The response carries `fellBack: true` and the real `model`. **Read the response**: asking for gemini and getting gpt-image-1 changes the result and the cost. |
| `brand-guidelines-health-check` | Do not trust it; confirm with `brand-guidelines-get`. It has reported an empty vault on a full one. |
| Local file upload | `visant upload <file> --json` via the CLI, or a presigned URL (`media-upload-urls` + `curl -X PUT` + `media-commit`). Inline base64 truncates and uploads a corrupted image. |

---

## Document Extract (dual mode)

### Mode 1: image extraction from a URL
```json
{ "url": "https://www.behance.net/gallery/...", "limit": 80 }
```
Returns image URLs with width, height and alt text (`limit` max 200). Works with
Behance, Pinterest, Dribbble, portfolios, blogs. Handles lazy-loaded images,
srcset and background images. Scope: `read`.

### Mode 2: PDF extraction
```json
{ "pdf_base64": "<base64>", "output": "inline", "include_brand_tokens": true }
```
Also accepts `pdf_path` for files on the server. `output: "disk"` saves a `.md`,
`"inline"` returns text. `include_brand_tokens: true` extracts colors, typography
and strategy (two phases: algorithmic + Gemini).

---

## Expired token / 401

```bash
cat ~/.visant/credentials.json   # take .apiKey
```

Update the Bearer in the MCP config and restart the session. If the file does not
exist: `npx visantlabs login`.

---

## Usage tips

- **Brand context in generation:** pass `brandGuidelineId` to mockup-generate,
  creative-full and creative-generate to inject colors/typography/voice.
- **`format: "prompt"`** on `brand-guidelines-get` returns text optimized for LLM
  context, not JSON.
- **creative-full** is the shortcut: it avoids chaining generate + mockup-generate
  + render by hand.
- **Credits:** `account-usage` shows the balance. AI utilities (describe-image, improve-prompt) are free.
- **Scopes:** OAuth tokens enforce `read`, `write`, `generate`; generation tools
  need `generate`.

## Neighbors

- **[[visant-brand-populate]]**: fill a new brand
- **[[visant-brand-sync]]**: reconcile an existing brand
- **[[visant-methodology]]**: the method behind the fields
- **[[visant-creative]]**: social and marketing pieces
- **[[brand-mockup-kit]]**: a batch of mockups for a brand
- **[[visant-mockup-creator]]**: new scene photos for the store

© pedrojaques99 · MIT · pedrojaques99/visant-skills-public

Похожие скиллы

Все скиллы по теме «Дизайн» →
brand claudekit Скилл brand держит голос бренда, визуальные правила и дизайн-токены в одном файле, а потом раздаёт их промптам агента и вашему CSS. CX Codex +1 51 100установок Brand Guidelines Generator claude-office-skills Скилл Brand Guidelines Generator формирует регламенты по стилю бренда, правилам типографики и цветовым палитрам. Пригодится маркетологам и разработчикам для фиксации визуальных стандартов проекта. CX Codex +1 4 900установок figma-code-connect-components официальный openai Скилл figma-code-connect-components связывает опубликованные компоненты из Figma с кодом проекта через Figma Code Connect. Помогает сопоставить свойства макета с интерфейсами в репозитории. CX Codex +1 3 000установок critique-brand-consistency Owl-Listener Скилл critique-brand-consistency для Claude Code, Cursor, Codex и других ИИ-сред сверяет отрендеренный экран с тремя файлами проекта: mood.md, voice.md и tokens.md. Находит каждое отклонение и предлагает конкретное исправление. CX Codex +1 2 300установок brandkit nexu-io Скилл brandkit генерирует презентационные доски с логотипом, палитрой, типографикой и мокапами — как из студии айдентики. CX Codex +1 2 100установок scenario-brand-kit scenario-labs Скилл scenario-brand-kit генерирует логотип в редактируемом SVG, палитру, типографику, варианты знака и приложения через Scenario. Для запуска новой айдентики или ребрендинга. CX Codex +1 870установок

Из того же набора12

Весь набор →
visant-methodology Скилл visant-methodology для Claude Code проводит брендинг через каскад из 9 этапов и 3 фаз. Запускается по запросам о полной стратегии бренда или аудите платформы. CX Codex +1 ★ 91звёзд репо visant-design Скилл visant-design для Claude Code перерабатывает интерфейсы и проверяет результат на экране приложения. Запускается на запросы об улучшении UI/UX, редизайне или удалении шаблонных AI-элементов. CX Codex +1 ★ 91звёзд репо site-reels Скилл site-reels для Claude Code записывает сценарии веб-сайтов в MP4 1080p для Figma Slides и собирает продуктовые шоурилы. CX Codex +1 ★ 91звёзд репо visant-preflight Скилл visant-preflight для Claude Code проводит опрос стейкхолдера и проверяет шрифты, графику и брендбук перед стартом крупных клиентских проектов вроде редизайна сайта или запуска кампании. CX Codex +1 ★ 91звёзд репо visant-video-editor Скилл visant-video-editor для Claude Code собирает видео из исходных материалов: анализирует клипы, предлагает список склеек и готовит ролик. Включается по запросу смонтировать влог, урок или нарезать тишину. CX Codex +1 ★ 91звёзд репо visant-premiere-editor Скилл visant-premiere-editor для Claude Code собирает черновой монтаж в Adobe Premiere Pro из JSON-плана нарезки. Переносит таймлайн через XML и MCP без потери кадров. CX Codex +1 ★ 91звёзд репо visant-refine Скилл visant-refine для Claude Code помогает оформлять графики, шкалы, спарклайны и панели управления в едином визуальном стиле. Подключается по просьбе добавить график, слайдер симулятора или доработать интерфейс. CX Codex +1 ★ 91звёзд репо visant-copy Скилл visant-copy для Claude Code пишет и правит тексты на pt-BR в голосе Visant, а copy-lint ловит штампы ИИ на pt и en. Запускается на просьбах про заголовок или тон голоса. CX Codex +1 ★ 91звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой