Kanera MCP 用の Gemini CLI のセットアップ
Gemini CLI は、 モデルコンテキストプロトコル。リモート HTTP サーバー、自動 OAuth 検出、動的クライアント登録、およびトークンの更新をサポートします。
OAuth で接続する (推奨)
Kanera をリモート HTTP サーバーとして追加します。
gemini mcp add --scope user --transport http kanera https://mcp.kanera.app/mcp
Gemini CLI を起動し、対話型プロンプトから認証します。
/mcp auth kanera
Gemini CLI を使用すると、ブラウザーで Kanera が開きます。サインインし、要求されたアクセスを確認し、選択します アクセスを許可する。走る gemini mcp list シェルからサーバーが接続されていることを確認するか、次を使用します。 /mcp Gemini CLI 内で検査します。
Gemini CLI で直接 Kanera を設定することもできます。 settings.json:
{
"mcpServers": {
"kanera": {
"httpUrl": "https://mcp.kanera.app/mcp"
}
}
}
インタラクティブ OAuth には、ローカル ブラウザとローカルホスト コールバックが必要です。コールバックを完了できないヘッドレス環境またはリモート環境では、次を使用します。 デバイスの認証 クライアントがデバイス許可をサポートしている場合、またはフォールバックする場合 APIキー。参照 AIエージェントを接続する スコープとエージェントの切断について。
Kaneraスキルをインストールする
MCP 接続により、Gemini CLI はKanera のツールにアクセスできるようになります。オプションの Kaneraエージェントのスキル 名前を安定した ID に解決すること、作業を報告または変更する前にライブ状態を読み取ること、完了した作業と作成アクティビティを区別すること、べき等キーを使用すること、許可またはレート制限の失敗を安全に処理することを教えます。
開いているエージェント スキル インストーラーを使用してスキルをグローバルにインストールします。
npx -y skills add https://github.com/happendev/Kanera/tree/main/integrations/skills/kanera --yes --global
手動インストールの場合は、完全なファイルをダウンロードしてください。 kanera スキル ディレクトリを作成し、次のいずれかの場所に配置します。
~/.agents/skills/kanera/または~/.gemini/skills/kanera/プロジェクト全体で利用できる個人スキルの場合。.agents/skills/kanera/または.gemini/skills/kanera/リポジトリに保存して、そのプロジェクトとスキルを共有します。
実行 /skills list Gemini CLI 内でスキルが利用可能であることを確認し、 /skills reload 変更した後。 Gemini CLI は、スキルをアクティブ化するときに確認を求めます。
例外: API キーを使用して接続する
:::注意 可能な限り OAuth を使用してください API キーは、ユーザー自身が保存および更新する長期の秘密であり、個人キーを使用して行われた作業は、個人キーを使用せずにユーザーとして記録されます。 <agent>経由 ラベル。 OAuth が本当に機能しない場合にのみ使用してください。
- Gemini CLI 環境では、localhost OAuth コールバックを完了できません。
- ローカルの標準入出力サーバーが必要ですが、 Kanera CLI.
kanera auth loginOAuth でサインインし、kanera mcpそのサインインで標準出力を提供します。キーは必要ありません。 - マシンにはサインイン用のブラウザがありません。試してみる デバイスの認証 まずクライアントがサポートしている場合。
キーを使用する場合は、キーを作成します 読み取り専用 エージェントが作業を変更する必要がある場合を除きます。キーはコミットするファイルではなく、環境変数に保存してください。 :::
認可ヘッダーを追加します settings.json 環境変数からキーを読み取ります：
{
"mcpServers": {
"kanera": {
"httpUrl": "https://mcp.kanera.app/mcp",
"headers": {
"Authorization": "Bearer $KANERA_API_KEY"
}
}
}
}
個人キーを作成します プロファイル設定 -> API キー またはワークスペースキー ワークスペース設定 -> API。キーを直接差し込むのは避けてください settings.json.