Kanera MCP用のAntigravityのセットアップ
Google Antigravityは、 Model Context Protocol。OAuthの検出と動的クライアント登録に対応したリモートのStreamable HTTPサーバーをサポートしているため、事前登録済みのクライアントもAPIキーも不要です。同じ設定がAntigravityのアプリ、IDE、Antigravity CLIで使えます。
OAuthで接続する(推奨)
グローバルのAntigravity MCP設定にKaneraを追加します。追加先は ~/.gemini/config/mcp_config.json、またはプロジェクト内の .agents/mcp_config.json (接続をそのプロジェクトでのみ使いたい場合)に追加します:
{
"mcpServers": {
"kanera": {
"serverUrl": "https://mcp.kanera.app/mcp"
}
}
}
ファイルにすでに他のサーバーが記載されている場合は、 kanera エントリを既存の mcpServers オブジェクト内に追加してください。IDEでは、エージェントのサイドパネルからこのファイルを開けます。 … -> MCP Servers -> Manage MCP Servers -> View raw config.
次に認証します。
- Antigravityアプリで Customizations -> Installedを開きます。 MCP Servers、次を選択します: 認証する を選びます。
- ブラウザーでKaneraにログインし、要求されたアクセス内容を確認して、次を選択します: アクセスを許可.
- Antigravityに表示された認可コードをコピーして Enter authorization code、そして次を選択します: Submit.
Antigravityは、トークンの期限が切れると自動的に更新してKaneraに再接続します。Antigravity CLIでは /mcp と入力してMCPマネージャーを開き、Kaneraが接続されていることを確認して、接続ログを読みます。
Antigravityは、権限ルールのないMCPツールを実行する前に確認を求めます。毎回確認せずにKaneraのツールを使わせるには、 mcp(kanera/*) をAntigravityの権限で許可します。クライアントの設定にかかわらず、Kaneraはリクエストごとに、各ボードでのあなたのロールと組織の AIエージェントポリシー を確認します。
詳しくは AIエージェントを接続する でスコープとエージェントの接続解除について説明しています。
Kaneraスキルをインストールする
MCP接続により、AntigravityはKaneraのツールにアクセスできます。オプションの Kaneraエージェントのスキル は、名前を安定したIDに解決すること、報告や変更の前に最新の状態を読み取ること、完了した作業と作成アクティビティを区別すること、べき等キーを使うこと、権限やレート制限による失敗を安全に処理することを教えます。
オープン標準のAgent Skillsインストーラーで、スキルをグローバルにインストールします:
npx -y skills add https://github.com/happendev/Kanera/tree/main/integrations/skills/kanera -a antigravity --yes --global
手動でインストールする場合は、 kanera スキルのディレクトリ全体をダウンロードして、次のいずれかの場所に配置します:
~/.gemini/config/skills/kanera/は、プロジェクトをまたいで使える個人用スキルの場所です。.agents/skills/kanera/は、リポジトリ内に置いて、そのプロジェクトとスキルを共有する場所です。
Antigravityはエージェントにスキルを提示し、関連するリクエストのときに指示全体を読み込みます。プロンプトでスキル名を指定するか、アプリやCLIで /kanera と入力して呼び出すこともできます。CLIでは /skills reload を実行します(セッション中にスキルを追加した場合)。
例外:APIキーで接続する
API キーは、ご自身で保管・ローテーションする長期有効のシークレットで、個人キーで行った作業はご本人の操作として記録され、 <agent>経由 のラベルなしで、あなたとして記録されます。OAuthが本当に使えない場合にのみ使用してください:
- 使用しているAntigravityのバージョンでは、リモートOAuthフローを完了できない。
- ローカルのstdioサーバーが必要で、次を使えない場合: Kanera CLI.
kanera auth loginはOAuthでログインし、kanera mcpはそのログインでstdioを提供するため、キーは不要です。 - ログイン用のブラウザーがないマシンの場合。まず次を試してください: デバイス認証 (クライアントが対応している場合)。
キーを使う場合は、次の設定で作成します: 読み取り専用 で作成してください。ただし、エージェントが作業を変更する必要がある場合は除きます。
Antigravityはヘッダーの値を記述どおりに送信するため、キーは設定ファイル自体に保存されます。プロジェクトのファイルではなくグローバルの ~/.gemini/config/mcp_config.json を使い、決してコミットしないでください。
{
"mcpServers": {
"kanera": {
"serverUrl": "https://mcp.kanera.app/mcp",
"headers": {
"Authorization": "Bearer YOUR_KANERA_API_KEY"
}
}
}
}
個人用キーは次の場所で作成します: プロフィール設定 -> APIキー 、ワークスペースキーの作成場所: ワークスペース設定 -> API.