Clarik Mcp Server

---

🚀 クイックスタート

npx clarik install

これだけです。Clarik は Claude Desktop と Claude Code を検出して両方を設定し、 バックグラウンドで静かに動作を開始します。

╔═══════════════════════════════════════╗
║           Welcome to Clarik           ║
║   Clarity and memory for Claude.      ║
╚═══════════════════════════════════════╝

✅ Detected: Claude Desktop
✅ Detected: Claude Code
✅ Checking compatibility...
✅ Done. Clarik is active.

Claude を開いて会話を始めましょう。Clarik がすべてを記憶します。

---

💡 できること

Clarik は、開発者が Claude を使う際に直面する最大の問題を静かに解決する MCP サーバーです。

問題	Clarik による解決方法
🧠 Claude はセッション間ですべてを忘れてしまう	永続メモリ — 事実、決定事項、注意点をいつまでも保持します
📄 コンテキストがいっぱいになり、品質が低下する	インテリジェントな注入 — 最も関連性の高いメモリだけを読み込みます
💸 コンテキストの繰り返しでトークンを浪費する	トークンの最適化 — API コストを月額 47～73 ドル削減します
🔄 コンテキストがいっぱいになると進捗が失われる	チェックポイント — 中断した場所から正確に保存・再開できます
🗂️ あるプロジェクトのメモリが別のプロジェクトに漏れる	プロジェクトの分離 — リポジトリごとに独自のメモリ領域を用意します
⚠️ Claude が編集すべきでないファイルを編集する	リポジトリガード — 保護されたファイルの編集には確認が必要です
🤔 Claude が質問せずに推測する	仮定チェッカー — 検証されていない主張にフラグを付けます

---

🔧 全 20 ツール

無料ツール（ライセンス不要）

ツール	機能
clarik_memory_learn	会話から事実を抽出して保存します。思考ブロックを取り除きます。
clarik_memory_recall	関連性、新しさ、重要度に基づいて順位付けされたメモリを取得します。
clarik_memory_list	現在のプロジェクトのメモリをすべて表示します。
clarik_memory_edit	特定のメモリの事実を更新します。
clarik_memory_clear	カテゴリを指定して、またはすべてのメモリを消去します。
clarik_context_trim	トークン予算内でメモリをインテリジェントに注入します。
clarik_checkpoint_save	セッションの状態を構造化されたスナップショットとして保存します。
clarik_checkpoint_resume	チェックポイントから再開し、中断した場所から正確に続けられます。

Pro ツール（買い切り 20 ドル）

ツール	機能
clarik_project_index	ファイルと用途の対応表を作成し、Claude がコードベース全体を理解できるようにします。
clarik_token_monitor	トークン使用量をリアルタイムで追跡します。コンテキストが 70% に達すると警告します。
clarik_memory_archive	古くなったメモリをアーカイブに移します。アクティブなメモリを高速に保ちます。
clarik_conflict_resolver	矛盾するメモリを検出して解決します。
clarik_change_scope_guard	編集前に保護対象ファイルの確認を求めます。
clarik_assumption_checker	Claude が質問せずに推測した場合にフラグを付けます。
clarik_diff_reviewer	説明付きで差分を構造的にレビューします。
clarik_hallucination_detector	主張を実際のコードと照合します。
clarik_decision_timeline	アーキテクチャ上の決定を日付と理由とともに記録します。
clarik_prompt_library	プロンプトテンプレートを保存して再利用します。
clarik_session_search	過去のセッションを全文検索します。
clarik_export_session	セッションデータを JSON または Markdown としてエクスポートします。

---

💰 トークンの節約

Clarik のインテリジェントなメモリ注入により、Claude が処理する冗長なトークンが減ります。

実際の数値（Sonnet 4.6、入力トークン100万あたり$3）

	Clarik なし	Clarik あり
セッションあたりの入力トークン数	~800K	~320K
セッションあたりのコスト	~$3.90	~$1.50
月額コスト（20日間）	~$78/mo	~$5–31/mo
月間の節約額	—	$47–73/mo

Clarik Pro costs $20 once.
Saves $47–73/month.
Pays for itself in 8 days.

---

🏷️ 料金プラン

プラン	価格	内容
無料	$0（永久）	8つの基本ツール — メモリ、コンテキスト、チェックポイント
Pro 永久ライセンス	$20	20個すべてのツール。1回限りのお支払いで永久に利用できます。
Pro 月額プラン	$8/mo	20個すべてのツール。いつでも解約できます。

→ Clarik Pro を入手

すでにキーをお持ちですか？

npx clarik activate YOUR-KEY

---

🛡️ セーフモード

Clarik には、ワークフローに合わせて選べる4つのセーフティモードがあります。

モード	メモリ	ガード	おすすめの用途
Safe（デフォルト）	✅ オン	✅ 有効	通常の開発
Strict	✅ オン	🔒 すべて確認	本番コード、機密性の高いリポジトリ
Minimal	❌ オフ	❌ オフ	プライバシーの最大化、簡単なタスク
Creative	✅ オン	🟡 緩和	プロトタイピング、探索

---

🖥️ CLI コマンド

npx clarik install          # Install into Claude Desktop + Claude Code
npx clarik activate KEY     # Unlock Pro tools with license key
npx clarik status           # Show plan, tools, savings, grace period
npx clarik upgrade          # Open clarik.dev/pro in browser
npx clarik uninstall        # Clean removal from all configs

---

🔒 プライバシーとデータ

データがマシンの外に送信されることはありません。

• すべてのメモリはローカルの ~/.clarik/ に保存されます
• テレメトリ、分析サーバー、クラウド同期はありません
• Anthropic の API への送信を除き、データは送信されません。API キーはご自身のものを使用します
• メモリファイルはお客様が所有します。通常の JSON ファイルなので、読み取り、編集、削除ができます
• ライセンスの検証のみネットワークに接続します（Gumroad、24時間に1回）

---

❓ よくある質問

Clarik はコードをどこかに送信しますか？

いいえ。 すべてのデータはマシン上に保持されます。Clarik はメモリをローカルの JSON ファイルとして保存します。 ネットワークリクエストは、Gumroad 経由のライセンス検証のみです（Pro ユーザーは1日1回）。

Claude Desktop と Claude Code で使えますか？

はい。 インストーラーが両方を自動的に検出して設定します。

コンテキストがいっぱいになったらどうなりますか？

Clarik は現在のセッションのチェックポイント（目標、進捗、決定事項、次のステップ）を保存できます。 新しいセッションを開始すれば、clarik_checkpoint_resume ですぐに再開できます。

オフラインで使えますか？

はい。 無料ツールは常にオフラインで利用できます。Pro ツールは、最後にライセンス確認に成功してから5日間、オフラインで利用できます。

Windows で使えますか？

はい。 stdio との互換性を確保するため、自動的に cmd /c ラッパーを使用して Windows を完全にサポートしています。 macOS と Linux でも動作します。

ほかの MCP サーバーと競合しますか？

いいえ。 名前の競合を防ぐため、すべてのツール名には clarik_ が付いています。

Clarik が記憶した内容を確認できますか？

はい。 clarik_memory_list を使うと、保存されたすべてのメモリを確認できます。または、~/.clarik/projects/ 内の JSON ファイルを直接確認できます。

データを削除するにはどうすればよいですか？

npx clarik uninstall        # Remove from Claude configs
rm -rf ~/.clarik/           # Delete all stored data

---

🔧 互換性

プラットフォーム	状態
macOS	✅ 完全対応
Windows	✅ 完全対応（cmd /c ラッパー）
Linux	✅ 完全対応
Claude Desktop	✅ 自動設定
Claude Code	✅ 自動設定

既知の問題

• macOS ベータ版：macOS のベータ版リリースでは、MCP 接続が不安定になる場合があります。 ベータ版が検出された場合、インストーラーが警告します。
• トランスポート：Clarik が使用するトランスポートは stdio のみです。既知の MCP 互換性の問題により、SSE および HTTP トランスポートには対応していません。

---

🔍 トラブルシューティング

Clarik のツールが Claude に表示されない場合

1. インストールが正常に完了したことを確認します：npx clarik status
2. Claude Desktop / Claude Code を再起動します
3. MCP 設定ファイルが正しく書き込まれたことを確認します：
   • Mac：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%/Claude/claude_desktop_config.json
   • Linux：~/.config/Claude/claude_desktop_config.json

「接続が失われました」または頻繁に切断される

Clarik には、接続を維持するための 30 秒間隔のハートビート ping が含まれています。 それでも切断が発生する場合は、以下をお試しください。

1. Claude Desktop を最新バージョンに更新する
2. 可能であれば、macOS のベータ版を避ける
3. ~/.clarik/ ディレクトリの権限を確認する

ライセンスの有効化に失敗する

1. インターネット接続を確認する
2. キーの形式を確認する：CLARIK-XXXX-XXXX-XXXX
3. もう一度お試しください。Gumroad の API は、まれに短時間停止することがあります
4. Pro ツールは、最後に正常に確認されてから 5 日間、オフラインで動作します

---

📊 メモリの仕組み

Clarik が学習する内容

• ✅ スタックとフレームワークの選択（「Next.js 14 と App Router を使っています」）
• ✅ アーキテクチャ上の決定（「REST から tRPC に移行しました」）
• ✅ ファイルの用途（「lib/auth.ts は JWT とセッションを処理します」）
• ✅ 注意点と警告（「v2 API は使わないでください。正常に動作しません」）
• ✅ ユーザーが確認した事実

Clarik が学習しない内容

• ❌ 思考ブロック（<thinking>、<antml-thinking>）
• ❌ 思考の連鎖の記録
• ❌ 推測に基づく内容
• ❌ ユーザーによる訂正前の内容

メモリのランキング

メモリを呼び出す際、Clarik は各事実をスコア付けします。

score = (relevance × 0.5) + (recency × 0.3) + (importance × 0.2)

最もスコアの高い事実だけがコンテキストに挿入されます。一度にすべてが挿入されることはありません。

プロジェクトの分離

各プロジェクトには、以下から導出された独自のメモリ領域があります。

git remote URL → workspace root → package.json name

React プロジェクトのメモリが Python プロジェクトに表示されることはありません。

---

法的事項

Clarik は、コミュニティによって構築された独立したツールです。 Anthropic PBC とは一切提携、承認、関係していません。

Claude® は Anthropic PBC の登録商標です。 Claude、Claude Desktop、Claude Code への言及はすべて、 互換性の識別のみを目的としています。

トークンコストの節約額は、一般的な開発者の 利用パターンに基づく推定値です。実際の節約額は、ワークフロー、 モデルの選択、使用量によって異なります。

Clarik はすべてのデータをお使いのデバイスにローカル保存します。 お客様ご自身の API キーを使用した Anthropic API を除き、データがサーバーに送信されることはありません。

いかなる種類の保証もなく、現状のまま提供されます。

利用規約全文：https://clarik.dev/terms

---