Kanera MCP 用にクロードをセットアップする
Web 上の Claude、Claude Desktop、および Claude Code は、 モデルコンテキストプロトコル.
クロードとクロード デスクトップ: OAuth で接続する
Kanera は公開されたクロード コネクタです。検索する Kanera 次の下: カスタマイズ -> コネクタ そして選択します 接続する。クロードはブラウザーのサインインと同意画面を開きます。 API キーを作成したり貼り付けたりする必要はありません。無料を含む、ホストされているすべての Kanera プランで動作します。
公開されたコネクタが現在のアカウントまたはワークスペースに表示されない場合は、同じ運用エンドポイントをカスタム コネクタとして追加します。
-
開く カスタマイズ -> コネクタ.
-
選択 + -> カスタムコネクタを追加.
-
Kanera の MCP アドレスを入力してください:
https://mcp.kanera.app/mcp -
選択 追加、その後 接続する.
コネクタを制限するチームまたはエンタープライズ組織の場合、所有者またはプライマリ所有者は、次の条件でKaneraを有効にする必要がある場合があります。 組織設定 -> コネクタ メンバーが接続する前に。
クロードは「Kanera」タブを開きます。サインインし、エージェントができることを確認して選択します アクセスを許可する。 Kanera との会話を有効にする + -> コネクタ コンポーザーの横にあるメニュー。
後でエージェントを管理または切断する プロファイル設定 -> API キー。参照 AIエージェントを接続する 詳細については。 OAuth がオプションでない場合は、次を参照してください。 APIキーの例外 以下。
クロード コード: OAuth で接続する
Claude Code が同じ Claude アカウントでサインインしている場合、最初に実行します claude mcp list。公開されたKaneraコネクタがすでに存在する場合は、Claude Codeを起動し、次のように入力します。 /mcpをクリックし、そこで接続または認証します。重複したサーバーを追加しないでください。
Kanera が存在しない場合は、ユーザーのホスト サーバーを追加して、プロジェクト間で利用できるようにします。
claude mcp add --transport http kanera --scope user https://mcp.kanera.app/mcp
クロードコードを起動して入力します /mcp。 Kanera を選択し、ブラウザ認証フローを完了します。走る claude mcp list 次の表示を確認します: 接続済み.
シェルのみのフォールバック
エージェントがシェル コマンドを実行できるが MCP を使用できない場合は、Web インターフェイスを自動化するのではなく、Kanera CLI をインストールします。
npx -y @kanera/cli commands # inspect it without a global install
npm install --global @kanera/cli # persistent command; requires Node 22+
kanera auth login
kanera setup claude --global
kanera whoami --json
CLI は、同じ Kanera ツール層を公開します。 kanera auth login コネクタと同じ方法で OAuth を使用してブラウザ経由でサインインするため、キーを作成する必要はありません。使う --with-api-key 無人エージェントの場合。公開されたコネクタはインストールする必要がないため、利用可能な場合はそれを優先します。
Kaneraスキルをインストールする
MCP 接続により、クロードはKanera のツールにアクセスできるようになります。オプションの Kaneraエージェントのスキル 名前を安定した ID に解決すること、作業を報告または変更する前に現在の状態を読み取ること、べき等キーを使用すること、障害を安全に処理することを教えます。
npx -y skills add https://github.com/happendev/Kanera/tree/main/integrations/skills/kanera --yes --global
スキルが表示されない場合はクロードを再起動してください。クロードは、関連する作業のためにこれを自動的にロードすることも、明示的に呼び出すこともできます。
例外: API キーを使用して接続する
:::注意 可能な限り OAuth を使用してください API キーは、ユーザー自身が保存および更新する長期の秘密であり、個人キーを使用して行われた作業は、個人キーを使用せずにユーザーとして記録されます。 <agent>経由 ラベル。 OAuth が本当に機能しない場合にのみ使用してください。
- Claude セットアップでは、OAuth で公開コネクタまたはカスタム コネクタを使用できません。
- ローカルの標準入出力サーバーが必要ですが、 Kanera CLI.
kanera auth loginOAuth でサインインし、kanera mcpそのサインインで標準出力を提供します。キーは必要ありません。 - マシンにはサインイン用のブラウザがありません。試してみる デバイスの認証 まずクライアントがサポートしている場合。
キーを使用する場合は、キーを作成します 読み取り専用 エージェントが作業を変更する必要がある場合を除きます。キーはコミットするファイルではなく、環境変数に保存してください。 :::
交換する kanera_live_... 次の場所で発行した個人キーを使用します: プロファイル設定 -> API キー またはからのワークスペースキー ワークスペース設定 -> API。個人用のクロード設定の場合、ワークスペース間での独自のボード アクセスに従うため、通常は個人キーが適切です。
クロード・コード
静的キーを持つホストされた HTTP エンドポイントの場合:
claude mcp add --transport http kanera --scope user https://mcp.kanera.app/mcp \
--header "Authorization: Bearer kanera_live_..."
ローカル標準入出力サーバーの場合は、次のコマンドを実行します。 Kanera CLI サーバーとして:
claude mcp add kanera --scope user \
--env KANERA_API_KEY=kanera_live_... \
--env KANERA_PUBLIC_API_URL=https://api.kanera.app \
-- npx -y @kanera/cli mcp
すでに実行している場合 kanera auth login、両方をドロップします --env フラグ。 kanera mcp 保存された資格情報を再利用します。走る claude mcp list サーバーが接続されていることを確認します。
クロードデスクトップ
開く 設定 -> 開発者 -> 構成の編集が開きます claude_desktop_config.jsonにサーバーを追加します。 mcpServers:
{
"mcpServers": {
"kanera": {
"command": "npx",
"args": ["-y", "@kanera/cli", "mcp"],
"env": {
"KANERA_API_KEY": "kanera_live_...",
"KANERA_PUBLIC_API_URL": "https://api.kanera.app"
}
}
}
}
保存後に Claude Desktop を再起動し、新しい会話を開いて Kanera ツールが利用できることを確認します。この構成では、stdio を介してサーバーをローカルで実行し、ノード 22 以降が必要です。
Claude Desktop でKanera をすでに構成しており、後で Claude Code をインストールした場合、Claude Code は以下を使用してデスクトップ構成をインポートできます。
claude mcp add-from-claude-desktop
このインポート コマンドは、macOS および Windows Subsystem for Linux (WSL) で使用できます。
