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

Kanera MCP のカーソルを設定する

カーソルは、 モデルコンテキストプロトコル。 Cursor は OAuth を使用したリモート Streamable HTTP サーバーをサポートしているため、API キーを作成または保存せずにブラウザ経由で接続できます。

ワンクリックインストール​

Cursor がインストールされたら、このリンクを開いて、ワンステップで Kanera を Cursor に追加します。

カーソルにKaneraを追加

カーソルは追加しようとしているサーバーを示します (https://mcp.kanera.app/mcp) と確認を求められます。次に、以下で説明するブラウザーへのサインインを完了します。リンクで Cursor が開かない場合、またはKanera を自己ホストしている場合は、代わりに手動で設定を追加してください。の MCP 構成ジェネレーター セルフホステッド アドレスのリンクも構築します。

手動構成​

Kanera は、MCP アドレスが入力されたこの構成を次の場所に示します。 プロファイル設定 -> API キー -> または手動で設定します -> カーソル.

Kanera をグローバル Cursor MCP 構成に追加します。 ~/.cursor/mcp.json、または .cursor/mcp.json プロジェクト内で接続がそこでのみ利用可能である必要がある場合:

{
"mcpServers": {
"kanera": {
"url": "https://mcp.kanera.app/mcp"
}
}
}

カーソルは、Kanera に OAuth が必要であることを検出し、認証を要求します。 Cursor Agent では、ブラウザ フローを明示的に開始できます。

cursor-agent mcp login kanera

Kanera にサインインし、要求されたアクセスを確認し、選択します アクセスを許可する。次に、接続と利用可能なツールを確認します。

cursor-agent mcp list
cursor-agent mcp list-tools kanera

カーソルエディタで開きます。 設定 -> ツールと MCP サーバーとツールを確認します。参照: AIエージェントを接続する スコープとエージェントの切断について。

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

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

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

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

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

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

スキルが表示されない場合はカーソルを再起動してください。カーソルは、関連するリクエストに対して自動的にロードすることも、ユーザーが呼び出すこともできます。 /kanera 明示的に。

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

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

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

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

キーをプロジェクト構成にコミットするのではなく、環境変数から読み取ります。

{
"mcpServers": {
"kanera": {
"url": "https://mcp.kanera.app/mcp",
"headers": {
"Authorization": "Bearer ${env:KANERA_API_KEY}"
}
}
}
}

セット KANERA_API_KEY Cursor を起動する環境。個人キーを作成します プロファイル設定 -> API キー またはワークスペースキー ワークスペース設定 -> API.

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