visant-mcp-connect 是用于连接并操作 Visant Labs MCP 服务器的技能。它必须依赖 Visant Labs 账户(visantlabs.com),没有匿名模式,缺少账户时所有工具均不可用;生成类工具还会消耗账户积分。
接入方式 API 地址为 https://api.visantlabs.com,MCP 端点为 https://api.visantlabs.com/api/mcp,认证支持 OAuth 2.1 + PKCE(动态客户端注册)或 visant_sk_ 开头的 API Key。资料给出的 Claude 流程为:先检查 ~/.visant/credentials.json 是否已有 apiKey;没有则通过 npx visantlabs login -e EMAIL -p PASSWORD 登录并保存永久 apiKey;随后使用 claude mcp add --transport http 及 Authorization: Bearer 头、--scope user 添加名为 visant 的服务器;最后用 claude mcp list 验证连接。资料特别说明不要使用 settings.json 中的 mcpServers 或 mcp-remote,因为服务器直接使用 Streamable HTTP。工具在下一会话中以 mcp__visant__ 前缀出现。
主要能力 约 50 个工具,按模块划分: 账户与认证:账号资料、剩余积分与账单周期、邮箱密码登录、注册、创建与列出 API Key。 品牌规范(16 个):列出、获取(可返回适合 LLM 的 prompt 文本)、创建、局部更新、删除(需 confirm: true)、复制、分享链接、公开访问、从 URL/文本提取并合并、AI 合规审计(对比度、字体、语调、完整性)、版本历史与恢复、上传 logo(支持主/深/浅/图标变体)、上传媒体、删除 logo 与媒体。 品牌生成(5 个):依据提示词生成视觉识别,可执行 full、市场调研、SWOT、人物画像、原型、概念创意、配色、情绪板等步骤;项目列表、详情、保存、删除。 样机生成(5 个):调用 gpt-image-2、gemini-3.1-flash-image-preview、seedream-3-0 等模型生成样机,支持 1K/2K/4K 分辨率与 1:1、16:9、9:16、4:5 比例,可通过 brandGuidelineId 注入品牌上下文;另有列表、详情、元数据更新、删除和分类预设。 创意工作室(8 个):creative-full 一次完成规划→背景→渲染 PNG→保存;也可分步生成结构化布局、服务端渲染、项目增删改查。 画布/白板(8 个):创建、列表、含节点类型摘要的列表、详情(节点/边/绘图)、更新、删除、按邮箱分享(可编辑/可查看)、CSV 预览为 DataNode、解析提示词中的 {{占位符}}。 预算(6 个):创建、列表、含明细的详情、更新、删除、复制。 AI 工具(免费,0 积分):图片描述(URL 或 base64)、提示词改进。 文档与图片提取:URL 模式可从公开页面提取高清图片(支持懒加载、srcset、背景图,limit 最大 200);PDF 模式可将 PDF 转为 markdown 并可选提取颜色、字体、策略等品牌令牌。 情绪板(3 个):检测网格边界框、为每个单元格建议动画/视频、放大图片至 1K/2K/4K(资料注明其不稳定,2026 年 8 月 3 次调用均返回 INTERNAL_ERROR)。 社区(2 个):浏览公开样机预设与社区资料。
使用规则与限制 资料强调提示词记账规则:每次调用 ai-generate-image、creative-generate、mockup-generate、video-generate 都应记录到项目的 prompts.jsonl 账本,包含模型/参数、引用及角色、输出 sha256、状态、成本及失败说明,需即时记录。工具故障时最多尝试两次,应改用替代方案并明确说明,不得静默替换,需在工作 .md 中记录日期与原始错误信息。moodboard-upscale 失败时应先寻找高清原图而非直接放大;生成图片若出现 fellBack: true 应读取返回的真实模型;brand-guidelines-health-check 不可轻信,需用 brand-guidelines-get 确认。本地文件上传应使用 CLI 的 visant upload <file> --json 或预签名 URL,内联 base64 会截断导致图片损坏。令牌过期或 401 时,从 credentials.json 取 apiKey 更新 Bearer 并重启会话,文件不存在则重新登录。OAuth 令牌强制 read、write、generate 权限,生成类工具需要 generate 权限。
适用场景 适合在 Claude 等 MCP 客户端中进行品牌规范管理、视觉识别与样机生成、创意排版渲染、白板协作、预算管理以及从网页/PDF 提取设计素材等品牌与创意工作。