> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP サーバー

> Claude Code や Codex などの AI クライアントを、プロジェクトの MCP サーバー経由でプロジェクトに接続します。

各プロジェクトには MCP サーバーがあり、Claude Code、Codex、Cursor、VS Code、Gemini CLI などの AI クライアントがプロジェクトで作業できます。ファイルの読み取りと編集、コンパイル、LaTeX のログの読み取り、PDF のダウンロード、コメントへの返信が可能です。

> [!NOTE]
>
> この機能は [ayaka-notes/ayakaleaf-pro](https://github.com/ayaka-notes/ayakaleaf-pro) によって開発されたものです。v6.3.1 以降で導入されています。

![](https://mintcdn.com/ayakaleaf-pro/75JEUzv4DcYJF7Z-/images/on-premises/8b4eca630b3083da54177b4e7a431571.png?fit=max\&auto=format\&n=75JEUzv4DcYJF7Z-\&q=85\&s=73546d80edf492bf43df53303023ca29)

![](https://mintcdn.com/ayakaleaf-pro/z0f8sws6lnhMSWO4/images/on-premises/img-c48f4f64.png?fit=max\&auto=format\&n=z0f8sws6lnhMSWO4\&q=85\&s=b6f33a465bae9952ce7be3bcb15c57c5)

### セットアップ

MCP サーバーは Git 連携に含まれています。[git-bridge](https://ayakaleaf-pro.mintlify.site/ja/on-premises/configuration/overleaf-toolkit/integrations/git-integration.md) を有効にすれば、MCP サーバーも利用できるようになります。その他の設定は必要ありません。

### AI クライアントを接続する

1. **アカウント設定** で Git 認証トークンを生成します。同じトークンが MCP サーバーと Git の両方で使用されます。
2. エディターで **Integrations** を開き、**MCP server** をクリックします。プロジェクトの MCP サーバーのアドレス `https://<your-overleaf>/project/<project_id>/mcp` と、各 AI クライアントへの追加方法が表示されます。コマンドをコピーし、`<token>` を自分のトークンに置き換えてください。

トークンは HTTP ヘッダー `Authorization: Bearer <token>` として送信されます。たとえば、Claude Code 用のコマンドは次のとおりです。

```bash theme={null}
claude mcp add --transport http overleaf \
  https://<your-overleaf>/project/<project_id>/mcp \
  --header "Authorization: Bearer <token>"
```

### 使い方

接続したら、AI クライアントに普段の言葉で依頼します。例:

| 依頼内容 | AI クライアントが使用するツール |
| - | - |
| *序論の誤字を修正して。* | `read_file`、`edit_file`: 編集はエディターにリアルタイムで表示されます |
| *プロジェクトをコンパイルして LaTeX のエラーを修正して。* | `compile`、`get_compile_log`、`edit_file` |
| *未解決のコメントに返信してから解決済みにして。* | `list_comments`、`reply_to_comment`、`resolve_comment` |
| *XeLaTeX に切り替えて PDF をダウンロードして。* | `update_settings`、`compile`、`get_output_file_link` |

### ツール

| グループ | ツール |
| - | - |
| プロジェクト | `get_clone_info`、`get_settings`、`update_settings`、`list_versions` |
| ファイル | `list_files`、`read_file`、`edit_file`、`write_file`、`delete_file` |
| コンパイル | `compile`、`get_compile_log`、`get_output_file_link`、`word_count` |
| コメント | `list_comments`、`reply_to_comment`、`resolve_comment`、`reopen_comment` |

`edit_file` と `write_file` による編集はエディターにリアルタイムで表示され、共同編集者の編集とマージされます。多数のファイルを一度に扱う場合、バイナリファイル、名前の変更などについては、AI クライアントが Git でプロジェクトをクローンしてプッシュすることもできます。

### 権限

MCP サーバーは、Git と同様にプロジェクトの共有設定に従います。

* プロジェクトを閲覧できるユーザーは全員、プロジェクトの読み取り、コンパイル、出力のダウンロードができます。
* ファイルと設定を変更できるのは、オーナーと編集者のみです。
* レビュアーはコメントへの返信に加え、自分が開始したコメントを解決または再オープンすることもできます。
* リンクで参加した閲覧者は、エディターと同様にコメントを見ることができません。

### Q\&A

> [accordion] エディターに Integrations や MCP server が表示されない
>
> **回答：** MCP サーバーには専用の環境変数はありません。`config/overleaf.rc` の `GIT_BRIDGE_ENABLED=true` で有効になります。[Git 連携](https://ayakaleaf-pro.mintlify.site/ja/on-premises/configuration/overleaf-toolkit/integrations/git-integration.md)を参照してください。変更後は `bin/up -d` を実行してください。git-bridge がない場合、エディターの左レールに **Integrations** タブは表示されません。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.