ヘルプセンター
LaTeX と Typst のプロジェクトの作成、コンパイル、共同作業のための実用的なガイド。
外部 Agent を接続する
MCP 対応の外部 Agent を、指定したプロジェクトと範囲だけで動かします。
ログインしてアプリを接続する
Claude のように MCP サーバーの URL だけでサーバーを追加するアプリには、トークンは不要です。アプリが JointTex を開くので、ログインして承認します。
手順
- アカウント設定でアクセストークンを開き、MCP サーバー URL をコピーします。
- アプリがサーバーを追加する場所に貼り付けます。Claude では、カスタマイズ、コネクタ、カスタムコネクタを追加の順です。
- アプリがブラウザーで JointTex を開きます。求められたらログインし、ページに表示された戻り先のアドレスを確認して、権限とプロジェクトを選び、「許可」を選びます。
- アプリはアクセストークンの「接続済みのアプリ」に表示され、そこで権限を絞り込んだり接続を解除したりできます。
MCP トークンを作成する
JointTex 教育プラン、Plus、Pro では、アカウント設定に表示される MCP サーバー経由で、Codex や Claude Code などの外部 Agent を接続できます。
手順
- アカウント設定でアクセストークンを開いて「MCP トークンを使う」を展開し、その Agent に必要なプロジェクトと権限だけを選んで MCP トークンを作成します。
- トークンは一度だけ表示されます。コピーして、表示された MCP サーバー URL と Authorization Bearer ヘッダーとして Agent に設定します。
- または「Agent 設定プロンプトをコピー」を選び、Agent に貼り付けます。プロンプトにはエンドポイントと完全なトークンが含まれるため、信頼できる Agent にだけ渡してください。
- まずは読み取り専用の権限から始めます。後で Agent がソースを変更する必要が出たら、ファイル書き込みを含む新しいトークンを作成してください。権限はトークンから削除できますが、追加はできません。
権限とプロジェクトを選ぶ
トークンには権限の一覧とプロジェクトの一覧が紐づき、Agent はそのどちらの外でも何もできません。公開されているヘルプガイドだけは、どのトークンでも読めます。
手順
- 権限は projects:read、projects:create、members:invite、files:read、files:write、review:decide、compile:run、comments:read、comments:write、templates:publish、account:read です。新しいトークンは 3 つの読み取り権限から始まり、書き込み権限には必ず対応する読み取り権限が付きます。
- projects:create があると Agent はあなたのアカウントにプロジェクトを作成でき、members:invite があるとあなたが所有するプロジェクトにメールで人を招待できます。どちらもプランのプロジェクト数と共同編集者数の上限に数えられます。新しいトークンでは選択されておらず、既存のトークンにも付与されません。Agent に任せたいときだけ選択してください。
- templates:publish があると、Agent はあなたが所有するプロジェクトをテンプレートライブラリに公開したり、あなたが公開したテンプレートを再公開したりできます（「テンプレートとして公開」と同じです）。テンプレートはすぐに公開されます。新しいトークンでは選択されておらず、既存のトークンにも付与されません。
- account:read があると、Agent はアカウントで設定済みの内容を確認でき、残りの設定を手伝えます。対象はプラン、Zotero・WebDAV・GitHub の接続状況、Git と MCP のトークン数、Agent のコネクターと組織です。キー、パスワード、トークンは一切見えません。新しいトークンでは選択されていません。
- comments:write があれば、Agent は本文の一節にレビュースレッドを作成し、スレッドに返信し、解決または再開できます。コメントの編集はできず、削除できるのは自分で作成したスレッドだけです。
- Agent が書いた内容は、アプリ内の Agent の編集と同じく変更履歴として残り、プロジェクトのメンバーが確認します。review:decide があれば、変更履歴を承認または却下することもできます。判断を人に任せたい場合はこの権限を付けないでください。
- files:write があれば、Agent はプロジェクトのコンパイル設定（ルートファイル、エンジン、TeX Live のバージョン、コンパイルモード）も変更できます。この設定は共同編集者全員に適用されます。files:read があれば、コンパイルした PDF をダウンロードするリンクを取得できます。リンクはサインインなしで 10 分間有効で、Agent の接続を解除すると使えなくなります。
- 「すべてのプロジェクト」を選ぶと、現在アクセスできるプロジェクトに加えて、今後アクセスできるようになるものも含まれます。Agent の役目が限られているなら、プロジェクトを個別に指定してください。
- トークンがあなた自身のロールを超えることはありません。あなたが閲覧者であるプロジェクトでは、files:write があっても Agent は書き込めません。
接続を監視し、必要なら失効させる
見えないトークンは管理できないトークンです。すべての接続は一覧でき、いつでも取り消せます。
手順
- 「アクセストークン」の「MCP トークンを使う」で、そのトークンが到達できるプロジェクトと権限を確認します。
- 作業の内容が変わったら、より広いトークンを発行するのではなく、「アクセスを編集」でプロジェクトを変更するか権限を削除します。権限の追加には新しい MCP トークンが必要です。
- 不要になったら直ちに失効させます。失効は即座に反映されます。
- 外部 Agent が書き込んだ内容も通常の編集と同じくプロジェクトの履歴に残るため、確認も復元もできます。
- MCP トークンは 10 個まで保持できます。プランが教育プラン、Plus、Pro を下回ると、既存のトークンは保存されたまま一時停止されます。