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

Kanera MCP 用にクロードをセットアップする

Web 上の Claude、Claude Desktop、および Claude Code は、 モデルコンテキストプロトコル.

クロードとクロード デスクトップ: OAuth で接続する​

Kanera は公開されたクロード コネクタです。検索する Kanera 次の下: カスタマイズ -> コネクタ そして選択します 接続する。クロードはブラウザーのサインインと同意画面を開きます。 API キーを作成したり貼り付けたりする必要はありません。無料を含む、ホストされているすべての Kanera プランで動作します。

公開されたコネクタが現在のアカウントまたはワークスペースに表示されない場合は、同じ運用エンドポイントをカスタム コネクタとして追加します。

  1. 開く カスタマイズ -> コネクタ.

  2. 選択 + -> カスタムコネクタを追加.

  3. Kanera の MCP アドレスを入力してください:

    https://mcp.kanera.app/mcp
  4. 選択 追加、その後 接続する.

コネクタを制限するチームまたはエンタープライズ組織の場合、所有者またはプライマリ所有者は、次の条件で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 login OAuth でサインインし、 kanera mcp そのサインインで標準出力を提供します。キーは必要ありません。
  • マシンにはサインイン用のブラウザがありません。試してみる デバイスの認証 まずクライアントがサポートしている場合。

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

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

Kanera MCP のワークスペース 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) で使用できます。

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