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

# Codex、Claude、ChatGPT で Kanaeru を使う

> Codex、Claude、ChatGPT の中から Kana セッションと会話し、質問に答え、ブループリントを開きます。

Kanaeru は、Kana での作業を Codex、Claude Desktop、Claude Code、ChatGPT に持ち込む **MCP アプリ** を提供しています。アプリからは、会話を開く、任意の Kana セッションにメッセージを送る、Kana の質問ラウンドに答える、ブループリントを表示する、といった操作ができます。作業自体は引き続き各セッションのエージェントマシンとランタイムで実行され、ホストアプリはそれを表示し、指示を出せるようにするだけです。

Claude Desktop のように MCP アプリのインターフェースに対応したアプリでは、Kanaeru 独自のインタラクティブなビュー（セッション、質問カード、ブループリントビューアー）が表示されます。Claude Code のように対応していないアプリでは、同じツールをプレーンテキストで使えます。

アプリは Streamable HTTP で Kanaeru のクライアントサーバー `https://api.kanaeru.ai/mcp/client` に接続します。サインインは OAuth で行うため、トークンを貼り付ける必要はありません。

<Note>
  あなたが接続するための Kanaeru の MCP サーバーは、このクライアントサーバーだけです。Kana のエージェントは、Kana セッション内のツール用に別のサーバーを使います。そちらには自分のエージェントを接続しないでください。
</Note>

<Note>
  有効な Kanaeru アカウントが必要です。先に招待を承諾し、Web アプリでオンボーディングを完了してください。オンボーディングが完了するまで、そのアカウントからの MCP リクエストは拒否されます。
</Note>

## アプリに Kanaeru を追加する

<Tabs>
  <Tab title="Codex">
    **Kanaeru for Codex** プラグインをインストールします。このプラグインはクライアントサーバーに接続し、Codex が自身の会話、ブラウザ、ファイルの各ビューでアウトカム、セッション、ブループリント、レビューを表示できるようにします。

    プラグインを使わずにサーバーを接続するには、次を実行します。

    ```bash theme={null}
    codex mcp add kanaeru-client --url https://api.kanaeru.ai/mcp/client
    codex mcp login kanaeru-client
    ```
  </Tab>

  <Tab title="Claude Desktop">
    URL に `https://api.kanaeru.ai/mcp/client` を指定してカスタムコネクタを追加し、Claude に求められたらサインインします。Kanaeru のビューは会話の中で直接開きます。
  </Tab>

  <Tab title="ChatGPT">
    <Note>近日公開予定です。ChatGPT 向けの Kanaeru アプリはまだ公開されていません。</Note>

    公開されると、セッション、質問カード、ブループリントを ChatGPT のチャット内で開けるようになり、ブループリントをファイルとしてエクスポートできるようになります。
  </Tab>

  <Tab title="Claude Code">
    ```bash theme={null}
    claude mcp add --transport http kanaeru https://api.kanaeru.ai/mcp/client
    ```

    次に Claude Code で `/mcp` を実行し、**kanaeru** を選んで認証します。ブラウザで **Kanaeruに接続** ページが開きます。Claude Code ではインタラクティブなビューなしでツールを使えます。
  </Tab>
</Tabs>

## コーディングエージェントから Kana を操作する

Claude Code や Codex など、コマンドを実行できるコーディングエージェントであれば、[Kana CLI](/ja/cli/overview) を直接使うこともできます。会話の作成、メッセージの送信、質問への回答、作業の承認が可能です。エージェントマネージャー経由で接続されたコンピューターでは、`kana` はマシンの認証情報にフォールバックするため、別途サインインしなくても使えます。それ以外の環境では、一度 `kana login` を実行してください。

| エージェントの実行場所 | 使うもの |
| - | - |
| Codex、Claude、ChatGPT などのアプリ内 | `/mcp/client` の Kanaeru アプリ |
| ターミナルやスクリプト | [Kana CLI](/ja/cli/overview) |

## サインイン

クライアントが接続すると、ブラウザで **Kanaeruに接続** が開きます。Web アプリと同じアカウントでサインインしてください。

トークンの有効期間は 30 日で、自動的に更新されます。

### 別のデバイスからサインインする

SSH 経由やコンテナ内など、ブラウザのない環境で動くクライアントは、代わりにデバイスフローを使えます。クライアントに URL とコードが表示されます。任意のデバイスで URL を開き、**MCPクライアントを承認** ページに同じコードが表示されていることを確認してから **承認** を選びます。コードの有効期限は 10 分です。

<Warning>
  承認すると、そのクライアントにあなたの Kanaeru アカウントへのアクセスを許可することになります。自分で接続を開始した覚えがなければ、**拒否** を選んでください。
</Warning>

## ディスカバリーエンドポイント

クライアント開発者向けの OAuth メタデータエンドポイントは次のとおりです。

| エンドポイント | 用途 |
| - | - |
| `https://api.kanaeru.ai/.well-known/oauth-protected-resource/mcp` | 保護リソースのメタデータ（RFC 9728） |
| `https://api.kanaeru.ai/.well-known/oauth-authorization-server` | 認可サーバーのメタデータ |
| `https://api.kanaeru.ai/.well-known/openid-configuration` | OpenID 形式の設定 |

対応するグラントは、PKCE 付き認可コード（S256 のみ）、リフレッシュトークン、デバイス認可グラントです。スコープは `mcp:tools`、`openid`、`email` です。アクセストークンは不透明なトークンで、ID トークンは発行されません。

サーバーはステートレスです。`POST` のみを受け付け、Server-Sent Events のストリームは開きません。

## 次のステップ

<CardGroup cols={2}>
  <Card title="ツールリファレンス" icon="wrench" href="/ja/mcp/tools">
    Kanaeru アプリでできること。
  </Card>

  <Card title="Kana CLI" icon="terminal" href="/ja/cli/overview">
    同じアカウントをターミナルから。
  </Card>
</CardGroup>


## Related topics

- [Kanaeruの概要](/ja/index.md)
- [ブループリントエディターとツール](/ja/guides/blueprint-editor.md)
- [マシンを接続する](/ja/machines/connect-a-machine.md)


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