メインコンテンツにスキップ

Kanera MCP の OpenCode をセットアップする

OpenCode は、 モデルコンテキストプロトコル。自動 OAuth 検出とリモート MCP サーバーの動的なクライアント登録をサポートしているため、事前に登録されたクライアントや API キーは必要ありません。

Kanera を OpenCode 構成に追加します。

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "kanera": {
      "type": "remote",
      "url": "https://mcp.kanera.app/mcp",
      "enabled": true
    }
  }
}

Kanera が最初に認証を必要とするときに、OpenCode は OAuth を自動的に開始します。ブラウザ フローを明示的に開始することもできます。

opencode mcp auth kanera

Kanera にサインインし、要求されたアクセスを確認し、選択します アクセスを許可する。走る opencode mcp list 接続を確認します。検出や認証に失敗した場合は、次を使います： opencode mcp debug kanera 処理の流れを確認します。

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

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

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

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

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

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

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

OpenCode はエージェントにスキルをリストし、必要に応じてその完全な命令をロードします。 OpenCode 権限を通じてツールやスキルを制限する場合は、次のことを確認してください。 skill ツールと次の kanera_* MCP ツールは否定されません。

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

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

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

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

キーを構成に保存する代わりに、環境変数を参照します。

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "kanera": {
      "type": "remote",
      "url": "https://mcp.kanera.app/mcp",
      "oauth": false,
      "headers": {
        "Authorization": "Bearer {env:KANERA_API_KEY}"
      }
    }
  }
}

個人キーを作成します プロファイル設定 -> API キー またはワークスペースキー ワークスペース設定 -> API.

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