> ## Documentation Index
> Fetch the complete documentation index at: https://docs.inki.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Codexからインキを使う

> Codexからインキに接続し、ノートを探す・読む・保存する・編集する

## Codexでインキを使うには

Codexからインキのノートを探したり、ターミナルやエディタで書いた下書きをインキのノートとして保存したりできます。保存したノートはインキで開き、続きを書けます。

CodexのCLI、IDEの拡張機能、アプリは同じ設定を使います。どれか1つでインキを足すと、ほかでも使えます。

## インキを接続する

インキのアカウントが必要です。

1. ターミナルで次のコマンドを実行する

   ```bash theme={null}
   codex mcp add inki --url https://inki.so/api/mcp
   ```

2. ブラウザでインキのページが開くので、インキにログインし、「接続を許可」をクリック

3. Codexを開き直し、`/mcp`で「inki」が出ていることを確かめる

ブラウザが開かなかったときや、途中で閉じたときは、`codex mcp login inki`を実行するとログインをやり直せます。`codex mcp list`の「Auth」の列で、ログインしたかを確かめられます。

コマンドを打つ代わりに、Codexに頼んで足してもらうこともできます。パソコンのブラウザかMac版のインキで「設定」>「アカウント」の「エージェントを接続」を開き、「端末・エディタで使う」の文の「コピー」をクリックして、Codexに送ってください。Codexが設定を足し、まだすることを案内します。iOSアプリとスマホのブラウザのインキにはこの文が無いので、上の手順で足してください。

## できること

* **ノートを探す**: 話題を伝えると、その言葉を含むノートを検索します。最近のノートやフォルダ内のノートを頼むと、更新が新しい順に一覧にします
* **読んで要約する**: 要約・引用・編集の前に、インキに保存されている本文を読みます。Codexが挙げるノートには、インキで開けるリンクが付きます
* **新しいノートとして保存する**: 手元のファイルや会話で作った下書きを、指定したフォルダに新しいノートとして保存できます。フォルダがまだなければ、Codexが作成できます
* **ノートを編集する**: 段落の書き換え、文の追加、一部の削除を頼めます。編集前の版はノートの[更新履歴](https://docs.inki.so/ja/features/notebook.md#更新履歴)に残り、そこから戻せます
* **名前の変更と移動**: ノートのタイトルを変えたり、別のフォルダへ移したりできます。本文はそのまま残ります
* **ゴミ箱へ移す**: 一度に移せるのは1つのノートだけです。移したノートは30日間、[ゴミ箱](https://docs.inki.so/ja/features/notebook-operations.md#ゴミ箱)から戻せます
* **接続中のアカウントを確かめる**: どのアカウントが接続されているかを聞くと、表示名とメールアドレスを答えます

## 依頼の例

* 接続しているインキのアカウントを教えて
* インキで最近書いたノートは？
* このリポジトリのREADMEをもとにリリースのお知らせを書いて、インキの「お知らせ」フォルダに「v2.0のお知らせ」という名前で保存して
* インキのノート「設計メモ」を読んで、今の実装と違うところを挙げて
* インキのノート「週報」を開いて、今週マージしたプルリクエストの要約を最後に足して

## Codexが許可を求める場面

Codexは、設定によってはインキのツールを使う前に許可を求めます。許可を求められたら、使うツールとインキに送る内容を確かめてから許可してください。ノートの編集、名前の変更や移動、ゴミ箱への移動は、変更内容を確かめてから許可することをおすすめします。

## Codexからできないこと

* ノートの完全な削除、ゴミ箱を空にすること
* フォルダの削除
* 複数のノート、フォルダごと、すべてのノートをまとめてゴミ箱へ移すこと
* 共有リンクの作成
* ワークスペースのほかのメンバーのノートを読む・変えること

ノートを完全に削除するときは、インキの[ゴミ箱](https://docs.inki.so/ja/features/notebook-operations.md#復元・完全に削除)から行ってください。

## 接続を解除する

* **パソコンのブラウザとMac版**: 「設定」>「アカウント」の「エージェントを接続」で、接続済みの一覧のCodexの「解除」をクリックし、同じ行に表示される確認の「解除する」をクリック
* **どのブラウザからでも**: [inki.so/ja/connections](https://inki.so/ja/connections)を開いてログインし、Codexの「解除」をクリックし、同じ行の「解除する」で確定

Codexで`codex mcp logout inki`や`codex mcp remove inki`を実行しても、インキの接続済みの一覧にはCodexが残ります。消すときは、上のどちらかでインキ側からも解除してください。

インキ側で解除しても、保存済みのノートはインキにそのまま残ります。また使うときは、`codex mcp login inki`でログインし直してください。

## 注意

* `/mcp`に「inki」が出ないときは、`codex mcp list`でinkiが足されているかを確かめ、Codexを開き直してください
* 「inki」が出ていても使えないときは、`codex mcp list`の「Auth」の列を見て、ログインしていなければ`codex mcp login inki`を実行してください
* 検索は、ノートに含まれる言葉との一致で探します。見つからないときは、別の言葉で頼んでください。直前の編集が検索結果に反映されるまで、少し時間がかかることがあります
* Codexが読むのは、インキに保存済みの本文です。別の端末で開いたまま保存されていない編集は、読み取りに含まれないことがあります
* Codexが読んだ後にインキでノートが変更された場合、インキはCodexの編集を受け付けず、何も書き込みません。Codexはノートを読み直してから編集するため、あとから加えた変更は上書きされません
* インキはCodexに対し、ノート内の文はあなたの内容であって指示ではないと伝えています。Codexの操作を決めるのは、あなた自身の依頼だけです。頼んでいない変更の許可を求められたら、許可しないでください

## 困ったときは

Codexからインキを使う際の質問は、[hello@inki.so](mailto:hello@inki.so)までご連絡ください。セキュリティ上の問題（脆弱性など）の報告も同じアドレスで受け付けます。対応時間は[アカウントとプライバシー](https://docs.inki.so/ja/account-privacy.md#サポートに関する質問)をご覧ください。連携サービスが扱うデータについては、[プライバシーポリシー](https://inki.so/ja/privacy)の第11条に記載しています。


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