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（動的クライアント登録）または API キー（visant_sk_...）

---

接続（Claude を優先するフロー）

ステップ 1：既存の認証情報を確認する

cat ~/.visant/credentials.json

存在し、apiKey があれば、ステップ 3 に進みます。

ステップ 2：認証する

ユーザーに Visant Labs のメールアドレスとパスワードを尋ねてから、次を実行します。

npx visantlabs login -e EMAIL -p PASSWORD

永続的な apiKey（visant_sk_...）を含む ~/.visant/credentials.json が保存されます。

ステップ 3：MCP を設定する（グローバル、任意のディレクトリ）

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

**settings.json の mcpServers や mcp-remote は使用しないでください。**サーバーは Streamable HTTP を直接使用します。

ステップ 4：確認する

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

次のセッションで、ツールが mcp__visant__ というプレフィックス付きで表示されます。

---

利用可能なツール（約50種類）

アカウントと認証

ツール	説明
account-profile	ユーザープロフィール（名前、メールアドレス、プラン）
account-usage	残りのクレジット、上限、請求サイクル
auth-login	メールアドレス／パスワードでログイン → JWT
auth-register	アカウントを作成 → JWT
api-key-create	visant_sk_xxx API キーを生成
api-key-list	既存の API キーを一覧表示

ブランドガイドライン（16種類のツール）

ツール	説明
brand-guidelines-list	すべてのブランドガイドラインを一覧表示
brand-guidelines-get	全データ（JSON、または LLM 向けのテキストには format:"prompt"）
brand-guidelines-create	新しいガイドラインを作成
brand-guidelines-update	部分更新（カラー、タイポグラフィ、戦略、トークン）
brand-guidelines-delete	削除（confirm: true が必要）
brand-guidelines-duplicate	ガイドラインを複製
brand-guidelines-share	公開リンクを作成／無効化
brand-guidelines-public	スラッグでアクセス（認証不要）
brand-guidelines-ingest	URL／テキストから抽出し、ガイドラインに統合
brand-guidelines-compliance-check	AI による監査（コントラスト、タイポグラフィ、ブランドボイス、網羅性）
brand-guidelines-versions	バージョン履歴
brand-guidelines-restore-version	以前のバージョンを復元
brand-guidelines-upload-logo	ロゴをアップロード（base64／URL、バリエーション：primary/dark/light/icon）
brand-guidelines-upload-media	メディアキットをアップロード（画像／PDF）
brand-guidelines-delete-logo	ID でロゴを削除
brand-guidelines-delete-media	ID でメディアを削除

ブランディングマシン（5種類のツール）

ツール	説明
branding-generate	プロンプトからビジュアルアイデンティティを生成（ステップ：full/market-research/swot/persona/archetype/concept-ideas/color-palettes/moodboard）。visant-methodology に準拠
branding-list	ブランディングプロジェクトを一覧表示
branding-get	プロジェクトの詳細
branding-save	プロジェクトを保存／更新
branding-delete	プロジェクトを削除

モックアップマシン（5種類のツール）

ツール	説明
mockup-generate	AI モックアップを生成。モデル：gpt-image-2（最良）、gemini-3.1-flash-image-preview、seedream-3-0。解像度：1K/2K/4K。アスペクト比：1:1/16:9/9:16/4:5。brandGuidelineId を通じてブランドのコンテキストを自動挿入します。
mockup-list	モックアップを一覧表示
mockup-get	モックアップの詳細
mockup-update	メタデータを更新
mockup-delete	削除
mockup-presets	カテゴリ別のプリセット（名刺、ソーシャルメディア、パッケージ、アパレルなど）

クリエイティブスタジオ（8 個のツール）

ツール	機能
creative-full	全工程を実行します。計画 → 背景 → PNG をレンダリング → 保存。一度で完了します。
creative-generate	構造化されたレイアウト（レイヤー、オーバーレイ、背景プロンプト）を生成します
creative-render	計画をサーバー側で PNG にレンダリングします
creative-projects-create	クリエイティブプロジェクトを保存します
creative-projects-list	プロジェクトの一覧を表示します
creative-projects-get	プロジェクトの詳細を表示します
creative-projects-update	プロジェクトを更新します
creative-projects-delete	プロジェクトを削除します

キャンバス／ホワイトボード（8 個のツール）

ツール	機能
canvas-create	ホワイトボードを作成します
canvas-list	プロジェクトの一覧を表示します
canvas-list-projects	ノードの種類の概要とともに一覧を表示します
canvas-get	詳細（ノード、エッジ、描画）を表示します
canvas-update	ノード、エッジ、linkedGuideline を更新します
canvas-delete	削除します
canvas-share	共有します（メールアドレスごとに canEdit／canView を設定）
canvas-parse-csv	CSV をプレビューし、DataNode の行に変換します
canvas-resolve-variables	プロンプト内の {{placeholders}} を解決します

予算（6 個のツール）

ツール	機能
budget-create	予算を作成します（clientName、projectDescription）
budget-list	予算の一覧を表示します
budget-get	明細項目を含む詳細を表示します
budget-update	フィールドを更新します
budget-delete	削除します
budget-duplicate	複製します

AI ユーティリティ（無料）

ツール	機能
ai-describe-image	画像を説明します（URL または base64）。クレジット消費は 0 です。
ai-improve-prompt	プロンプトのテキストを改善します。クレジット消費は 0 です。

運用ルール：生成したプロンプトは保存されたプロンプトです。 ai-generate-image／creative-generate／mockup-generate／video-generate の呼び出しはすべて、プロジェクトの prompts.jsonl 台帳に記録されます。呼び出しごとに 1 行で、モデル／パラメーター、各参照の役割、出力の sha256、ステータス（承認済み／破棄済み）、コスト、破棄した場合は失敗した理由のメモが含まれます。その場で記録してください。後から復元することはできません。visant-mockup-creator がインストールされている場合、仕様はその references/prompt-ledger.md に記載されています。

ドキュメントと画像の抽出

ツール	機能
document-extract	デュアルモード。「Document Extract」を参照してください。URL モードでは、公開されている任意のページから HD 画像を取得します。PDF モードでは、PDF を Markdown とブランドトークンに変換します。

ムードボード（3 個のツール）

ツール	機能
moodboard-detect-grid	ムードボードのグリッド内のバウンディングボックスを検出します
moodboard-suggest	各セルのアニメーション／動画を提案します
moodboard-upscale	画像を 1K／2K／4K にアップスケールします。⚠ 不安定：2026 年 8 月の 3 回の呼び出しすべてで INTERNAL_ERROR が返されました。「ツールが停止した場合」を参照してください。

コミュニティ（2 個のツール）

ツール	機能
community-presets	公開モックアッププリセットを閲覧します
community-profiles	コミュニティプロフィールを閲覧します

---

ツールが停止したとき

MCP ツールは動作しなくなることがあります。そのときに、無理に続けたり、結果が出たふりをしたりしてはいけません。

1. 試行は2回まで。それ以上は行わないでください。 INTERNAL_ERROR が繰り返される場合、原因はペイロードではなくサーバーです。3回目の試行は時間を浪費するだけです。
2. 代替手段を使い、どれを使ったか明記してください。 黙って切り替えてはいけません。結果を読む人は、どの経路で得られたかを知る必要があります。
3. 問題の内容を、日付と正確なメッセージとともに作業の .md に記録してください。

失敗した場合	代替手段
moodboard-upscale	アップスケーリングの前に、高解像度のオリジナルを探してください。ほとんどの場合、すでに存在しているのに誰も探していません（[[visant-preflight]] を実行してください）。アップスケーリングはプランBです。オリジナルを探さずにアップスケーリングするのは、プランAに見せかけたプランCです。
ai-generate-image が誤ったモデルにフォールバックする	レスポンスには fellBack: true と実際の model が含まれます。レスポンスを確認してください。gemini を指定して gpt-image-1 が使われると、結果もコストも変わります。
brand-guidelines-health-check	信用せず、brand-guidelines-get で確認してください。中身がすべて揃っているのに、空のボルトだと報告したことがあります。
ローカルファイルのアップロード	CLI 経由で visant upload <file> --json を使うか、署名付き URL（media-upload-urls + curl -X PUT + media-commit）を使ってください。インラインの base64 は途中で切り詰められ、画像が破損した状態でアップロードされます。

---

Document Extract（デュアルモード）

モード1：URLからの画像抽出

{ "url": "https://www.behance.net/gallery/...", "limit": 80 }

幅、高さ、代替テキストを含む画像 URL を返します（limit の最大値は200です）。Behance、Pinterest、Dribbble、ポートフォリオ、ブログで動作します。遅延読み込み画像、srcset、背景画像にも対応しています。スコープ：read。

モード2：PDF抽出

{ "pdf_base64": "<base64>", "output": "inline", "include_brand_tokens": true }

サーバー上のファイルには pdf_path も指定できます。output: "disk" は .md を保存し、"inline" はテキストを返します。include_brand_tokens: true は色、タイポグラフィ、戦略を抽出します（アルゴリズム + Gemini の2段階）。

---

トークンの期限切れ／401

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

MCP 設定の Bearer を更新し、セッションを再起動してください。ファイルが存在しない場合は、npx visantlabs login を実行してください。

---

使用上のヒント

• 生成時のブランドコンテキスト： brandGuidelineId を mockup-generate、creative-full、creative-generate に渡すと、色／タイポグラフィ／トーンを適用できます。
• brand-guidelines-get の format: "prompt"： JSON ではなく、LLM のコンテキストに最適化されたテキストを返します。
• creative-full： 近道として使えます。generate + mockup-generate + render を手動で連続実行する必要がありません。
• クレジット： account-usage で残高を確認できます。AI ユーティリティ（describe-image、improve-prompt）は無料です。
• スコープ： OAuth トークンでは read、write、generate が適用されます。生成ツールには generate が必要です。