MCP 連携

Model Context Protocol (MCP) は、AI アシスタント（Claude Desktop、Cursor、Windsurf など）が外部ツールやサービスと対話できるようにするオープンスタンダードです。Clarity の MCP サーバーにより、ワークスペースがライブの AI アクセス可能な環境に変わります。

MCP でできること

MCP を有効にすると、AI アシスタントは以下のことができます：

• すべての Clarity プロジェクトを 一覧表示 し、ファイルツリーを閲覧
• プロジェクト内の任意のファイルを 読み取り および 書き込み
• 新しいファイルを 作成（LaTeX、Typst、BibTeX など）
• ファイルを安全に 削除（メインファイルは保護されます）
• LaTeX および Typst ドキュメントを コンパイル し、エラーを自動的に デバッグ
• Typst ドキュメントを検索 — 構文、関数、パターンを参照
• TikZ イラストを生成 — プロフェッショナルな図表を作成

AI クライアントを離れることなく、すべて実行可能です。コピー＆ペーストもコンテキスト切り替えも不要です。

仕組み

Clarity は 11 のツール を備えた MCP サーバー を公開しており、ローカルマシンで実行され、標準の stdio トランスポートを介して AI クライアントと通信します：

1. 1Clarity の設定で API キー を生成
2. 2AI クライアントの設定に Clarity を MCP サーバーとして追加
3. 3AI クライアントが Clarity MCP サーバーをサブプロセスとして起動
4. 4サーバーが API キーで認証し、リクエストを Clarity のバックエンドにプロキシ
5. 5AI アシスタントがワークスペースへのフルアクセスを取得

アーキテクチャ

API キーがすべてのリクエストを認証します。サーバーはキーを保存せず、起動時に環境変数から読み取ります。

クイックリンク

• セットアップガイド — Claude Desktop と Cursor のステップバイステップの手順
• ツールリファレンス — 全 11 MCP ツールの詳細なドキュメント
• API キーとセキュリティ — キーの仕組み、安全対策、脅威モデル