Vozclara

VozClara

多言語対応のAI学習ツールです。公開動画のURLを貼り付けると、母語で構造化された ナレッジパック（要約、重要なアイデア、用語集、クイズ、タイムスタンプ付きの 文字起こし）を取得できます。対応言語：スペイン語、ポルトガル語、ドイツ語、英語。

公開中：vozclara.app MCP サーバー：smithery.ai/server/salvador7eon/vozclara

姿勢は古典的に、道具は現代的に。

---

MCP 連携

VozClara は Model Context Protocol（MCP）サーバーを公開しており、AI エージェント （Claude Desktop、Cursor、Claude Code、Continue、Copilot Chat を搭載した VS Code など）から直接呼び出せます。

ワンクリックでインストール：Smithery からクライアントを選択すれば完了です。

手動設定（Claude Desktop の場合。Windows では %APPDATA%\Claude\claude_desktop_config.json、 macOS では ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "vozclara": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://vozclara.app/api/mcp"]
    }
  }
}

Claude Desktop を再起動して、次のように尋ねます：

「vozclara を使って、この動画をドイツ語で要約してください：https://www.youtube.com/watch?v=…」

利用可能なツール

匿名エンドポイント（/api/mcp）では、サインインなしで使えるツールを1つ公開しています。OAuth で保護されたエンドポイント（/api/mcp/pro）では、ユーザー自身の VozClara ライブラリを操作するツールを3つ追加で利用できます。

ツール	エンドポイント	入力	出力
vozclara_generate_pack	/api/mcp（匿名）	url、language（es／pt／de／en）、depth（short／standard／deep）	ナレッジパックのテキスト＋構造化メタデータ＋vozclara.app のインタラクティブなパックへのディープリンク
vozclara_search_my_library	/api/mcp/pro（OAuth）	query、省略可能な limit（1～10）	認証済みユーザーのパックを対象としたセマンティック検索結果。各結果から vozclara.app にリンクします
vozclara_ask_video	/api/mcp/pro（OAuth）	pack_id、question	インライン引用付きのRAGに基づく回答。対象はその1つのパックに厳密に限定されます
vozclara_export_anki	/api/mcp/pro（OAuth）	pack_id	ユーザーが開いて .apkg デッキをダウンロードするディープリンクURL

認証済みの設定（Claude Desktop、有料プランのツール。上記のライブラリ関連ツール3つが追加されます）：

{
  "mcpServers": {
    "vozclara-pro": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://vozclara.app/api/mcp/pro"]
    }
  }
}

初回の呼び出し時に mcp-remote がブラウザーを開きます。マジックリンクでサインインし、スコープ（library:read、library:write、profile）を承認すると、リフレッシュトークンがローカルにキャッシュされます。GitHub の MCP サーバーと同じ流れです。

Claude Skills バンドル

上記のMCPツールを補完する、より高レベルの機能です。このリポジトリの skills/ には、日常的な動画／ナレッジ／学習に関する依頼を VozClara MCP サーバー経由で処理する、インストール可能な Claude Skills が3つ含まれています。これにより、ユーザーがツール名を覚えていなくても、Claude は vozclara_generate_pack、vozclara_search_my_library、vozclara_ask_video のどれを使うべきか判断できます。

mkdir -p ~/.claude/skills
cp -R skills/vozclara-* ~/.claude/skills/

Claude Desktop を再起動します（または Claude Code で /reload-skills を実行します）。スキルがピッカーに表示されます。各スキルの起動条件と、有料プランの2つのスキルでのOAuthフローについては skills/README.md を参照してください。

---

技術スタック

レイヤー	テクノロジー
フロントエンド	Cloudflare Pages 上の Vite + React 18 + TypeScript + Tailwind
ワーカー	Cloudflare Workers + Durable Objects + KV + D1 + Vectorize
LLM（無料／Pro）	Workers AI · @cf/meta/llama-3.3-70b-instruct-fp8-fast
LLM（Pro Plus）	Cloudflare AI Gateway 経由の Anthropic Claude Sonnet 4.5
文字起こし	Supadata（販売責任者、ライセンス取得済み）
埋め込み	セマンティック検索向けの @cf/baai/bge-base-en-v1.5
TTS	OpenAI tts-1（オプション、プレミアム音声ナレーション）
認証	Resend 経由のマジックリンク。パスワード不要
決済	Paddle（販売責任者。EU VAT と米国の売上税に対応）
MCP	agents SDK + McpAgent +（フェーズ2）workers-oauth-provider
分析	Cloudflare Web Analytics（Cookie 不使用、同意バナーなし）

---

ローカル開発

前提条件：Node 20 以上、Git。

# Install
npm install
npm --prefix worker install

# Two terminals — Vite dev server + Wrangler dev
# Terminal A: Vite on :5173
npm run dev
# Terminal B: Wrangler on :8787
npm run worker:dev

Vite は /api/* を :8787 にプロキシするため、http://localhost:5173 でエンドツーエンドの動作を確認できます。

ローカルで Worker から Supadata を呼び出すには、worker/ 内に .dev.vars ファイルを配置します。

SUPADATA_API_KEY=sd_…
# Optional — enables OpenAI TTS path
OPENAI_API_KEY=sk-…
# Optional — enables Sonnet 4.5 for Pro Plus tier
ANTHROPIC_API_KEY=sk-ant-…

このファイルは Git の追跡対象外です。本番環境のシークレットは、代わりに wrangler secret put <NAME> で登録します。

---

デプロイ

フロントエンド → Cloudflare Pages

npm run build
# Push to GitHub; Cloudflare Pages builds dist/ automatically.
# Custom domain: vozclara.app

Worker → Cloudflare Workers

cd worker
npx wrangler deploy

これにより、API と MCP サーバーが vozclara.app/api/* にデプロイされ、対応する Smithery の URL は https://vozclara--salvador7eon.run.tools になります。

---

コンプライアンス

• DSGVO Art. 13 — サブプロセッサーの全リストは /privacy にあります
• DSGVO Art. 17 — サーバー側でのアカウント削除時に、メール、セッション、投票、レビューを一括削除します
• EU AI Act Art. 50(1) — 初めてジェネレーターにアクセスした際に、AI に関する開示バナーを表示します
• EU AI Act Art. 50(2) — エクスポートされるすべてのパックに、AI 生成の透かしが付与されます
• 返金ポリシー — /refund で14日間の返金保証を提供しています

---

ブランド

LEON MARÉ のエディトリアルスタイル：

• カラー — ネイビー #0A1A3A、ゴールド #C9A24B、クリーム #F7F3EC、グラファイト #1A1A1A
• タイポグラフィ — ロケール別：Reforma（ES）、Adelle Sans（PT）、Inter（DE）、Tiempos（EN）
• トーン — クラシカルで断定的。感嘆符、絵文字、最上級表現は使用しません

---

VozClara · LEON MARÉ の製品 · フランクフルト・アム・マイン · ドノスティア · ポルト