Kanera MCP のコーデックスをセットアップする
ChatGPT デスクトップ アプリ、Codex CLI、および Codex IDE 拡張機能は、 モデルコンテキストプロトコル。これらは同じ Codex ホストの MCP 設定を共有するため、通常は Kanera を 1 回追加するだけで済みます。
Kanera プラグインをインストールします (推奨)
ChatGPT デスクトップ アプリで、次のように開きます。 プラグイン、検索してください Kanera によって ハペン・ソフトウェア・リミテッドを選択してインストールします。プロンプトが表示されたら、OAuth 経由で Kanera アカウントに接続し、新しい Codex チャットを開始して、Kanera を使用するように依頼します。このプラグインには MCP 接続とスキルがバンドルされているため、個別のスキルのインストールや手動のサーバー登録は必要ありません。
Codex CLI で、次のように入力します。 /plugins プラグイン一覧を開き、利用可能なマーケットプレイスからKaneraをインストールして新しいセッションを開始します。利用可否はアカウント、ワークスペースのポリシー、設定済みのマーケットプレイスに依存します。
IDE 拡張機能はプラグインをサポートしていません。を使用します。 手動接続 IDE、セルフホスト型 Kanera デプロイメント、またはプラグインが使用できないクライアント用の以下のスタンドアロン スキル。プラグインがすでに接続されている場合は、2 番目のホストされたサーバーを登録しないでください。
プラグインが利用できない場合: OAuth による手動接続
Kanera がプラグイン マーケットプレイスにない場合、またはプラグインのインストールが利用できない場合は、MCP サーバーを直接追加し、Kanera アカウントを OAuth に接続します。ホストされる MCP アドレスは次のとおりです。 https://mcp.kanera.app/mcp。セルフホスティングの場合は、展開の MCP アドレスを次の場所からコピーします。 プロファイル設定 -> API キー 代わりに。 API キーを作成または保存する必要はありません。
codex mcp add kanera --url https://mcp.kanera.app/mcp
codex mcp login kanera
ログイン コマンドにより、ブラウザでKaneraが開きます。サインインし、要求されたアクセスを確認し、選択します アクセスを許可する。走る codex mcp list サーバーの登録を確認するか、次を使用します： /mcp Codex CLI で接続を検査します。
ChatGPT デスクトップ アプリで、次のように開きます。 設定 -> MCP サーバー -> サーバーの追加。 IDE 拡張機能で、歯車メニューを開いて選択します。 MCP サーバー -> サーバーの追加。入力してください Kanera、選択してください ストリーミング可能なHTTP、同じ URL を使用します。プロンプトが表示されたら保存して再起動し、選択します 認証する Kaneraへのサインインが必要な場合。
リモートサーバーを直接設定することもできます。 ~/.codex/config.toml:
[mcp_servers.kanera]
url = "https://mcp.kanera.app/mcp"
それから実行します codex mcp login kanera。参照 AIエージェントを接続する スコープとエージェントの切断について。
手動接続用のスキルをインストールする
プラグインをインストールしている場合は、バンドルされているスキルがすでに利用可能です。手動セットアップの場合、MCP 接続により、Codex がKanera のツールにアクセスできるようになります。の Kaneraエージェントのスキル これらのツールを確実に選択する方法を教えます。次のような正確なカードキーをルーティングします。 DEV-938 Kanera に直接送信し、サポートされている作業ではブラウザ自動化よりも MCP を優先し、名前を安定した ID に解決し、作業を報告または変更する前にライブ状態を読み取り、べき等キーを使用し、許可またはレート制限の失敗を安全に処理します。
開いているエージェント スキル インストーラーを使用してスキルをグローバルにインストールします。
npx -y skills add https://github.com/happendev/Kanera/tree/main/integrations/skills/kanera --yes --global
手動インストールの場合は、完全なファイルをダウンロードしてください。 kanera スキルディレクトリ（以下を含む） SKILL.md そして agents/openai.yamlを選択し、次のいずれかの場所に配置します。
~/.agents/skills/kanera/プロジェクト全体で利用できる個人スキルの場合。.agents/skills/kanera/リポジトリに保存して、そのプロジェクトとスキルを共有します。
通常、Codex はスキルの変更を自動的に検出します。表示されない場合は、Codex を再起動してください。言及 $kanera プロンプトで明示的にロードして強制的にロードするか、Kanera が動作するように Codex に自動的に選択させます。
使用する /apps Kaneraアプリを接続するには、 /plugins Kaneraプラグインと同梱スキルが利用できるか確認し、 /mcp verbose ツールの接続を確認します。例：
$kanera Update DEV-938 with the investigation findings and agreed implementation plan.
コーデックスはそのカードを最後まで読み取る必要があります cards.get そして、要求された変更を適用します
cards.update。明示的に視覚化されたタスクまたは MCP が公開しない管理操作の場合にのみ、Kanera Web インターフェイスを開く必要があります。
例外: API キーを使用して接続する
:::注意 可能な限り OAuth を使用してください API キーは、ユーザー自身が保存および更新する長期の秘密であり、個人キーを使用して行われた作業は、個人キーを使用せずにユーザーとして記録されます。 <agent>経由 ラベル。 OAuth が本当に機能しない場合にのみ使用してください。
- お使いの Codex のバージョンでは、リモート OAuth フローを完了できません。
- ローカルの標準入出力サーバーが必要ですが、 Kanera CLI.
kanera auth loginOAuth でサインインし、kanera mcpそのサインインで標準出力を提供します。キーは必要ありません。 - マシンにはサインイン用のブラウザがありません。試してみる デバイスの認証 まずクライアントがサポートしている場合。
キーを使用する場合は、キーを作成します 読み取り専用 エージェントが作業を変更する必要がある場合を除きます。キーはコミットするファイルではなく、環境変数に保存してください。 :::
交換する kanera_live_... 次の場所で発行した個人キーを使用します： プロファイル設定 -> API キー またはからのワークスペースキー ワークスペース設定 -> API、設定します KANERA_PUBLIC_API_URL 次へ： https://api.kanera.app。個人的な Codex セットアップの場合、ワークスペース全体での独自のボード アクセスに従うため、通常は個人キーが適切です。
ChatGPT デスクトップ アプリ
開く 設定 -> MCP サーバーを選択し、 サーバーの追加。そこにローカル stdio サーバーを追加するか、編集することができます。 config.toml 以下の設定を使用します。サーバーを保存し、次を選択します： 再起動.
Kanera を追加した後、新しい会話を開始し、そのツールが利用可能であることを確認します。
構成ファイル (アプリ、CLI、および IDE 拡張機能)
Codex はユーザーレベルの MCP サーバーを次の場所に保存します。 ~/.codex/config.toml。追加 [mcp_servers.kanera] ローカル標準入出力サーバーのテーブル。 Kanera CLI サーバーとして(ノード22以降)。すでに実行している場合 kanera auth login、省略できます env; kanera mcp 保存された資格情報を再利用します。
[mcp_servers.kanera]
command = "npx"
args = ["-y", "@kanera/cli", "mcp"]
env = { KANERA_API_KEY = "kanera_live_...", KANERA_PUBLIC_API_URL = "https://api.kanera.app" }
静的 API キーを持つホストされた HTTP サーバーの場合、キーをファイルに書き込むのではなく、環境変数に保持します。
[mcp_servers.kanera]
url = "https://mcp.kanera.app/mcp"
bearer_token_env_var = "KANERA_API_KEY"
セット KANERA_API_KEY Codex を起動する環境で、アプリ、CLI、または IDE 拡張機能を再起動します。
コマンドライン
または、コマンドラインから追加します。
codex mcp add kanera \
--env KANERA_API_KEY=kanera_live_... \
--env KANERA_PUBLIC_API_URL=https://api.kanera.app \
-- npx -y @kanera/cli mcp
デスクトップ アプリで、に戻ります 設定 -> MCP サーバー 接続を確認します。IDE拡張機能では、歯車メニューから次を選択します： MCPサーバー.