Kanera MCP 用の GitHub Copilot のセットアップ

VS Code の GitHub Copilot は、 モデルコンテキストプロトコル。このガイドでは、VS Code デスクトップ アプリケーションについて説明します。 Copilot CLI と GitHub.com コーディング エージェントは、異なる MCP 構成の場所を使用します。

GitHub Copilot および VS Code 1.99 以降にアクセスする必要があります。 Copilot がビジネス組織またはエンタープライズ組織から提供されている場合、その管理者は Copilot の MCP サーバー ポリシー。

OAuth で接続する (推奨)

リモート接続の場合は、Kanera の MCP アドレスを追加し、ブラウザで認証します。 API キーを作成または保存する必要はありません。

1. 実行 MCP: サーバーの追加 コマンド パレットから、 HTTP、入力してください https://mcp.kanera.app/mcp、名前を付けてください kaneraをクリックして、ユーザー プロファイルに保存します。または、実行します MCP: オープンユーザー構成 そしてKaneraを手動で追加するか、 .vscode/mcp.json 現在のワークスペースの場合。

2. 手動構成の場合は、Kanera をリモート HTTP サーバーとして追加します。

   {
     "servers": {
       "kanera": {
         "type": "http",
         "url": "https://mcp.kanera.app/mcp"
       }
     }
   }

3. サーバーを起動し、その構成が信頼できることを確認します。 VS Code は OAuth 要件を検出し、ブラウザーの認証フローを開きます。インラインアクションが表示される場合 認証、それを選択します。

4. Kanera にサインインし、要求されたアクセスを確認し、選択します アクセスを許可する.

5. 実行 MCP: サーバーのリスト Kaneraが接続されていることを確認します。次でCopilot Chatを開きます： エージェント モードに移動し、Kanera ツールがツール ピッカーに表示されることを確認します。

参照 AIエージェントを接続する スコープとエージェントの切断について。

Kaneraスキルをインストールする

MCP 接続により、Copilot はKanera のツールにアクセスできるようになります。オプションの Kaneraエージェントのスキル これらのツールを確実に使用する方法を教えます。名前を安定した ID に解決すること、作業を報告または変更する前にライブ状態を読み取ること、完了した作業と新しく作成された作業を区別すること、冪等キーを使用すること、許可またはレート制限のエラーを安全に処理することです。

開いているエージェント スキル インストーラーを使用してスキルをグローバルにインストールします。

npx -y skills add https://github.com/happendev/Kanera/tree/main/integrations/skills/kanera --yes --global

手動インストールの場合は、完全なファイルをダウンロードしてください。 kanera スキル ディレクトリを作成し、次のいずれかの場所に配置します。

• ~/.agents/skills/kanera/ または ~/.copilot/skills/kanera/ プロジェクト全体で利用できる個人スキルの場合。
• .agents/skills/kanera/ または .github/skills/kanera/ リポジトリに保存して、そのプロジェクトとスキルを共有します。

副操縦士チャットでは、次を使用します。 /skills スキルが利用可能であることを確認します。Kaneraに関する依頼ではCopilotが自動的に読み込むほか、次を呼び出すこともできます： kanera 明示的にスキル。

例外: API キーを使用して接続する

:::注意 可能な限り OAuth を使用してください API キーは、ユーザー自身が保存および更新する長期の秘密であり、個人キーを使用して行われた作業は、個人キーを使用せずにユーザーとして記録されます。 <agent>経由 ラベル。 OAuth が本当に機能しない場合にのみ使用してください。

• VS Code セットアップではリモート OAuth フローを完了できません。
• ローカルの標準入出力サーバーが必要ですが、 Kanera CLI. kanera auth login OAuth でサインインし、 kanera mcp そのサインインで標準出力を提供します。キーは必要ありません。
• マシンにはサインイン用のブラウザがありません。試してみる デバイスの認証 まずクライアントがサポートしている場合。

キーを使用する場合は、キーを作成します 読み取り専用 エージェントが作業を変更する必要がある場合を除きます。キーはコミットするファイルではなく、環境変数に保存してください。 :::

交換する kanera_live_... 次の場所で発行した個人キーを使用します： プロファイル設定 -> API キー またはからのワークスペースキー ワークスペース設定 -> API、設定します KANERA_PUBLIC_API_URL 次へ： https://api.kanera.app。個人用 VS Code セットアップの場合、ワークスペース間での独自のボード アクセスに従うため、通常は個人キーが適切です。

VS Code デスクトップ アプリ

GitHub Copilot は MCP サーバーを .vscode/mcp.json ワークスペース内のファイル。プロジェクト全体で使用できる個人用構成については、次を実行します。 MCP: オープンユーザー構成 コマンドパレットからユーザーを編集します mcp.json ファイル。

ローカル標準入出力サーバーの場合は、次のコマンドを実行します。 Kanera CLI サーバーとして(ノード22以降)。すでに実行している場合 kanera auth login、省略できます env; kanera mcp 保存された資格情報を再利用します。

{
  "servers": {
    "kanera": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@kanera/cli", "mcp"],
      "env": {
        "KANERA_API_KEY": "kanera_live_...",
        "KANERA_PUBLIC_API_URL": "https://api.kanera.app"
      }
    }
  }
}

静的 API キーを持つリモート HTTP エンドポイントの場合:

{
  "servers": {
    "kanera": {
      "type": "http",
      "url": "https://mcp.kanera.app/mcp",
      "headers": {
        "Authorization": "Bearer kanera_live_..."
      }
    }
  }
}

ツールを使用する

Copilot Chat ビューを開き、次のいずれかに切り替えます。 エージェント モードで、サーバーが起動すると、Kanera ツールがツール ピッカーに表示されます。

API キーをコミットしないでください .vscode/mcp.json。ユーザーレベルのファイルに個人設定を入れるか、VS Code の入力変数サポートを使用して、シークレットがリポジトリに保存される代わりに要求されるようにします。

クライアントのリファレンス

• IDE での Copilot に関する GitHub の現在の MCP ガイド
• VS Code の現在の MCP セットアップ ガイド