Overleaf for AI agents (olmcp)

Agent–Overleaf Connector (olmcp)

olmcp を使うと、AI エージェントが Overleaf プロジェクトのレビューコメントに返信できます。

Overleaf でコメントすると、エージェントがコメントと選択したテキストを読み取り、Overleaf の変更履歴付き変更として編集案を提示し、同じスレッドに返信します。レビュー担当者は引き続きあなたです。編集を承認または却下し、スレッドを閉じます。

olmcp はホスト型のバックエンドを持ちません。コネクターはお使いのコンピューター上で実行され、Overleaf のセッションを使用します。選択した AI クライアントは、独自のプライバシー条件に基づき、MCP の結果をモデルプロバイダーに送信する場合があります。

ワークフロー

1. You select text and leave a comment in Overleaf.
2. The agent reads the comment and the live project.
3. The agent proposes a tracked change and replies in the thread.
4. You accept, reject, request another version, or resolve the thread.

デフォルトでは、編集はサイレントな置換ではなく、提案です。Overleaf では元のテキストが変更履歴付きの削除として表示され、提案されたテキストが変更履歴付きの挿入として表示されます。

プロジェクトのステータス： 1.0.0-alpha.3。レビューの基本的な流れは実際の Overleaf プロジェクトで使用されていますが、保留中の提案の改訂やファイル作成などの新しい機能は、まだ実サービスでのテストが必要です。まずは使い捨てのプロジェクトでお試しください。

MCP でできること、できないこと

できること	意図的にできないこと
プロジェクト内のコメント、スレッド、選択したテキスト、テキストファイルを読み取る	変更履歴付きの変更を代わりに承認または却下する
review モードで変更履歴付きの編集案を提示する	コメントスレッドを解決、再開、閉じる、または削除する
#direct を明示的に使用した場合に、通常の編集を適用する	既存のファイルを上書きまたは削除する
コメントスレッドに返信する	Overleaf のサポート対象外である新しい履歴形式を使うドキュメントを編集する
別のバージョンを依頼された場合に、自身の保留中の提案を改訂する	画像、PDF、その他のバイナリ形式のプロジェクトファイルを作成する
新しいテキストファイルと不足しているフォルダーを作成する	バックグラウンドで継続的に動作したり、新しいコメントを監視したりする
Overleaf でプロジェクトをコンパイルし、PDF をローカルに保存する	エージェントに独立した Overleaf ID を与える。変更にはあなたのアカウントが使用される

ツールのインターフェースでこれらの制限を適用しています。ただし、シェルへの無制限のアクセス権を持つエージェントは、保存されたセッションクッキーを読み取り、MCP を介さずに Overleaf に接続できます。セキュリティと信頼を参照してください。

クイックスタート

Node.js 20 以降、Overleaf アカウント、そして Claude Code や Codex などの MCP 対応エージェントが必要です。Python、TeX、Overleaf の有料 Git 連携は不要です。現在の GitHub ベースのインストールでは、git コマンドも必要になる場合があります。通常の使用では必要ありません。

1. olmcp をインストールする

npm install -g github:nipdep/agent-overleaf-connector
olmcp --version

2. Overleaf にサインインする

ブラウザーの開発者ツールから overleaf_session2 クッキーをコピーし、次を実行します。

olmcp auth --cookie "<cookie value>"

このクッキーはパスワードと同様に扱ってください。エージェントとのチャット、issue、コミットには絶対に貼り付けないでください。セットアップガイドでは、クッキーの確認場所と、有効期限が切れた場合の対処方法を説明しています。

3. MCP サーバーを登録する

エージェントを選択してから、再起動します。

# Claude Code
claude mcp add --scope user olmcp -- "$(which olmcp)" mcp

# Codex
codex mcp add olmcp -- "$(which olmcp)" mcp

Windows PowerShell のコマンドやその他の MCP クライアントについては、AI エージェントを接続するで説明しています。

4. プロジェクトの URL をエージェントに渡す

プロジェクトのフォルダーやクローンは必要ありません。MCP の接続後、リクエストに Overleaf プロジェクトの URL を貼り付けます。

https://www.overleaf.com/project/<project-id> のコメントに対応してください。

URL を毎回貼り付けたくない場合は、olmcp init を使って作業フォルダーにプロジェクト ID を保存できます。プロジェクトの選び方を参照してください。

5. コメントに対応する

Overleaf で文を選択し、「もっと分かりやすくして」とコメントします。次に、エージェントに次のように伝えます。

https://www.overleaf.com/project/<project-id> のコメントに対応してください。

Overleaf に戻って、変更履歴付きの編集を確認します。承認または却下するか、別の依頼を返信するか、自分でスレッドを解決してください。

日常的な操作

次の操作を行うには…	Overleaf での操作
通常のレビュー可能な編集を提案する	通常のコメントを残します。デフォルトは review です
変更履歴を残さずに編集を適用する	コメントに #direct を追加します
エージェントにスレッドを見せないようにする	#no-agent を追加します
特定のスレッドにエージェントの注意を向ける	対象のコメントに #agent を追加します
保留中の提案を別のバージョンにしてもらう	同じスレッドで「もう少し短く」などと返信してから、エージェントを再実行します
新しいセクションや参考文献ファイルを追加する	コメントで依頼します。新しいファイルはすぐに表示され、\input または参考文献の編集は別途提案されます
議論を終了する	スレッドを自分で解決します

例、モード、タグ、ファイル作成、MCP ツールの全一覧については、Using olmcp をご覧ください。

重要な安全上の詳細

• コネクターはユーザーのセッションを使用するため、変更履歴に記録される変更はユーザーの Overleaf アカウントに帰属します。
• 新しく作成したファイルは変更履歴に記録できません。ファイルはすぐに表示され、コネクターがファイルを上書きまたは削除することはありません。
• #direct による変更はすぐに反映されます。元に戻す必要がある場合は、Overleaf History を使用してください。
• このインターフェースは非公式であり、Overleaf の変更によって動作しなくなる可能性があります。
• セッション Cookie は通常、数日で期限切れになります。olmcp doctor でセッションの期限切れが報告された場合は、再度 olmcp auth を実行してください。

ドキュメント

• まずはこちら：ドキュメント一覧
• インストールとセットアップ
• コメント、提案、タグ、ファイルの使用
• AI エージェントの接続と制約
• アルファテストのチェックリストを実行する
• 検証済みの動作と現在の制限を確認する
• 技術設計を理解する
• コントリビュート

リリースの変更内容は変更履歴をご覧ください。廃止された Python ワークフロー（Git 同期、ソースマーカー、redline.tex、GitHub Actions）は、python-legacy ブランチに残っています。

ロゴファイル：PNG · SVG

ライセンスと謝辞

Apache 2.0。LICENSE をご覧ください。Overleaf プロトコルの処理は、Alexander Loth による olcli（MIT）で使用されている方式に準拠しています。詳しくは THIRD_PARTY_NOTICES.md をご覧ください。