3行でいうと

  • Kimi Code CLIは、MCPクライアントです。MCPサーバーは mcp.json の mcpServers に書くか、/mcp-config で足します。置き場所は、ユーザー全体の ~/.kimi-code/mcp.json と、プロジェクトの .kimi-code/mcp.json の2つで、同じ名前ならプロジェクトが優先されます。
  • プロジェクト側の mcp.json のstdio(ローカルのコマンド)の記述は、セッションの開始時に、手元のコマンドを実行します。公式は、信頼できるリポジトリでだけ有効にするよう書いています。
  • IDEからは kimi acp で呼びます。公式の設定例があるのは、Zed、JetBrains、Paseoです。VS Codeの拡張は別の仕組みで、Cursorの手順は読んだ範囲に見つかりませんでした。
  • スキルは SKILL.md を含むフォルダ、プラグインは kimi.plugin.json を持つフォルダかzipです。プラグインのMCPサーバーは再読み込みか新しいセッションのあとに起動し、フックはイベントが起きたときだけ動く、と公式にあります。
  • ブラウザ拡張(旧WebBridge)は、ChromeとEdge用です。公式の製品ページは、操作は手元で行われ、ログイン状態とページの内容は端末から出ない、と運営側の説明として書いています。

この記事は、公式の資料を2026年10月25日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。運営者はKimiを入れていますが、使い心地はこの記事には書いていません。手順は公式の手順を順に並べたものです。設定の例は、公式ページに載る内容をもとにしていますが、公式のページは取得ツールの要約を経由して読んでいます。設定ファイルに貼る前に、公式ページの原文と見比べてください。「この記事の案」「この記事で組んだ例」と書いたものは、公式の記載に合わせて組んだもので、動作は確かめていません。画面や設定の表記は変わります。手元の画面と照らして読んでください。

先に結論

前提:用語をそろえる

A. MCPサーバーをKimi Codeにつなぐ

公式のKimi Code CLIの「Model Context Protocol」のページの内容です。デスクトップ版も、同じ mcp.json を使い、新しいセッションが変更を拾う、と公式のDesktopのページにあります。

設定ファイルの書き方(公式のページの例の内容)

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
    },
    "linear": {
      "url": "https://mcp.linear.app/mcp"
    },
    "legacy-events": {
      "transport": "sse",
      "url": "https://mcp.example.com/sse"
    }
  }
}

置き場所

範囲 ファイル 効く範囲
ユーザー ~/.kimi-code/mcp.json($KIMI_CODE_HOME/mcp.json でも) すべてのプロジェクト
プロジェクト 作業ディレクトリの .kimi-code/mcp.json そのリポジトリだけ

名前が重なるときは、プロジェクトが優先されます。

主な任意の項目(公式の表)

項目 対象 役割
env stdio 子プロセスの環境変数
cwd stdio 子プロセスの作業ディレクトリ
headers HTTP、SSE 毎回送る固定のヘッダ
bearerTokenEnvVar HTTP、SSE ベアラートークンを入れた環境変数の名前
enabled すべて false で無効にする
enabledTools/disabledTools すべて 使うツールの許可リスト/禁止リスト
startupTimeoutMs/toolTimeoutMs すべて 接続と1回の呼び出しの時間切れ(接続の既定は30000)

手順1:ファイルを書いて足す

  1. 上のユーザーかプロジェクトの mcp.json を、エディタで作ります。
  2. mcpServers に、サーバーの名前と、command/args か url を書きます。トークンは、ファイルに直接書かず、bearerTokenEnvVar で環境変数の名前を指す形を、公式の項目として使えます。
  3. 新しいセッションを始めます。途中で足したサーバーは、あとから作ったセッションにだけ入ります。
  4. /mcp で、接続の状態を確かめます。

手順2:画面で足す

  1. セッションの中で /mcp-config を打ちます。TUIの画面で、サーバーの追加、編集、削除ができます。
  2. OAuthが要るサービスは、/mcp-config login <サーバー名> を打ち、ブラウザで認可します。固定のトークンは、headers か bearerTokenEnvVar で渡します。
  3. kimi mcp add のようなCLIのサブコマンドは、公式のページに載っていません。

信頼の確認

呼び出しの権限(公式の記載)

```toml [[permission.rules]] decision = "allow" pattern = "mcp__github__*"

[[permission.rules]] decision = "deny" pattern = "mcp__filesystem__write_file" ```

渡るデータ

ツールの結果(テキスト、structuredContent、添付)が、エージェントに渡ります。大きな添付や埋め込みのメディアは、セッションの保存場所に置かれ、kimi-file:// のパスで参照されます。リソースのリンクは自動ではダウンロードされません。外のサーバーに何が送られるかは、ツールの呼び出しとその引数以外は、公式のページに十分には書かれていません。

外し方

B. IDEから使う(ACP)

前提は、Kimi Code CLIを入れて、一度ターミナルで /login を済ませておくことです。ACPのサーバーは、そのログインの状態を使います。macOSでは、IDEのアプリが、シェルのPATHを引き継がないことが多く、kimi が標準の場所(/usr/local/bin など)になければ、絶対パスを書きます(which kimi で調べます)。

Zed

  1. ~/.config/zed/settings.json に、公式のページの例の内容を足します。

json { "agent_servers": { "Kimi Code CLI": { "type": "custom", "command": "kimi", "args": ["acp"], "env": {} } } }

  1. kimi がPATHにないときは、command をフルパスにします。env は空のままにします(Zedが標準の環境を入れる、とあります)。
  2. 保存して、Agentパネルで新しい会話を開き、Kimi Code CLI のサーバーを選びます。

agent_servers に宣言したMCPサーバーは、ACPでKimiに渡されます。

JetBrains系のIDE

  1. JetBrainsのAIの契約がない場合は、レジストリの llm.enable.mock.response を有効にすると、ACPだけのためにAIチャットのパネルに入れる、と公式にあります(Shiftを2回押して「Registry」を検索)。
  2. AIチャットのパネルのメニューで「Configure ACP agents」を選び、公式の例の内容を足します。command は絶対パスで書きます(JetBrainsは厳しい、とあります)。

json { "agent_servers": { "Kimi Code CLI": { "command": "~/.local/bin/kimi", "args": ["acp"], "env": {} } } }

  1. 保存後、AIチャットのエージェント選択から Kimi Code CLI を選びます。

Paseo

Paseoは、自分で動かすオーケストレーターです。「Kimi Code CLI」を内蔵のACPプロバイダの一覧から選ぶか、~/.paseo/config.json にカスタムのプロバイダを足します(kimi acp を呼ぶ形。全文は公式で確認)。先にターミナルでログインを済ませないと、Authentication required で失敗する、と書かれています。

渡るデータ・外し方・つまずき

C. VS Code拡張とCursor

VS Codeの拡張「Kimi Code」の入れ方と最初の作業は、05の節Eと06の場面7にあります。ここでは、連携に関わる点だけです。

D. スキルを足す(Kimi Code CLI・Desktop)

公式の「Agent Skills」のページの内容です。DesktopはCLIと、形式、保存場所、優先順位が同じ、と書かれています。

形式

```yaml


name: code-style description: Project code style guidelines defining naming, indentation, comments, and file organization type: prompt whenToUse: When the user asks me to write, modify, or review project source code disableModelInvocation: false arguments: - target - mode


```

置き場所(公式の優先順位。上が優先)

  1. プロジェクト:プロジェクトの根(.git のある最も近いディレクトリ)の .kimi-code/skills/ と .agents/skills/。
  2. ユーザー:$KIMI_CODE_HOME/skills/(既定は ~/.kimi-code/skills/)と ~/.agents/skills/。
  3. 追加:config.toml の extra_skill_dirs に書いた場所。
  4. 内蔵:CLIに同梱。優先順位は最も低い。

公式は、~/.agents/skills/ と .agents/skills/ を、Kimi専用ではない汎用の場所と説明し、他のツールと共有できる、としています。他のツールの具体的なフォルダ名(たとえば .claude/skills)は、そのページには書かれていませんでした。

呼び出し・外し方

E. プラグインを足す(Kimi Code CLI・Desktop)

公式の「Plugins」のページの内容です。

CLIの手順

  1. /plugins で、Installed、Official、Curated、Customの4つのタブの画面を開きます(Tab/Shift-Tab で切り替え)。
  2. 入れる:/plugins install <パスかURL>。ローカルのディレクトリ、zipのURL、GitHubのリポジトリのURLに対応します。GitHubは、リポジトリ(最新のリリース、なければ既定のブランチ)のほか、ブランチ、タグ、コミットのURLも指せます。
  3. ローカルから入れたものは $KIMI_CODE_HOME/plugins/managed/<id>/ にコピーされ、CLIはそのコピーだけを実行します。元のファイルを直したら、入れ直します。
  4. 有効・無効・削除:Installedのタブで、Space が有効/無効、D が削除、M がMCPサーバーの管理、R が再読み込み、I が詳細です。コマンドは /plugins enable <id>、/plugins disable <id>、/plugins remove <id> です(削除は確認が出ます)。
  5. 変更は、/reload か新しいセッション(/new)で効きます。

公式が書く性質

渡るデータ・権限

外し方

/plugins remove <id> か、Installedのタブの D。削除は、インストールの記録だけを消し、managed のコピーと元のファイルはディスクに残ります(公式の記載)。

F. ブラウザ拡張(旧Kimi WebBridge)

公式の製品ページと、ヘルプの一覧の内容です。FAQの本文は取得できず、細かい操作は読めていません。

G. ウェブ・アプリのKimiのプラグイン(要点)

手順は06の場面4です。ウェブのKimiが扱うのはプラグインのうちMCPとスキルだけです。Kimi WorkとKimi Codeは、より完全な組み合わせに対応する、とヘルプにあります(どの部品に対応するかの一覧は、読んだ範囲に見つかりませんでした)。許可した範囲の中でだけ使われ、第三者のプラグインのデータは提供元の規約に従うので、許可する前に読むよう案内されています。外すには、アンインストールか権限の取り消しで、アンインストールするとOAuthの権限も取り消されます。一部は会員のクレジットを使います。

H1. OpenCodeを、Kimi Codeの会員でKimiにつなぐ(07の経路B)

公式の「OpenCode」(Kimi Code Docs、第三者のツール)の順です。

手順

  1. OpenCodeを入れる。 curl -fsSL https://opencode.ai/install | bash、またはnpmで npm install -g opencode-ai。スクリプトの原文は、公式で確かめてください。
  2. キーを入れる。 opencode auth login を実行し、プロバイダの一覧から「Kimi For Coding」を選び、Kimi For CodingのAPIキーを入力します。キーはKimi Code Consoleで作ります(最大5本、表示は作成時の1回だけ)。
  3. 起動してモデルを選ぶ。 opencode で起動し、セッションの中で /models を打ち、「Kimi For Coding」の下から選びます。
  4. 選べるモデル(ページの記載)。 K3.1 Pro、K3.1 Pro Highspeed、K3、K3-256K、K2.8 Preview、K2.7 Code HighSpeed。会員の種類で使える範囲が違います。
  5. 思考の強さ(任意)。 K3.1 Pro、K3系、K2.8 Previewでは /variants を打ちます。選択肢は Default、low、high、max で、ページは high を recommended と書きます(公式が書く言い方)。
  6. 確かめる。 ページに専用の確認コマンドはありません。/models にKimi For Codingのモデルが出て、プロンプトに返事が来ることが目安です。

公式が書く注意と、読めなかった点

H2. Hermes Agentを、Kimi Codeの会員でKimiにつなぐ(07の経路B)

公式の「Hermes Agent」(Kimi Code Docs、第三者のツール)の順です。Hermes Agentは他社のツールで、この記事では、Kimiの文書が説明している範囲だけを扱います。

手順

  1. 前提。 Hermes Agentを入れるか更新します(Kimiのページが、Hermesの公式のインストールの案内にリンクしています)。キー(先頭は sk-kimi-)をKimi Code Consoleで作ります。
  2. プロバイダとモデルを選ぶ。

sh hermes model

「Kimi / Moonshot」を選び、次に「Kimi / Kimi Coding Plan」を選びます。キーを、伏せ字の入力欄に貼ります。Hermesは先頭の sk-kimi- を見て、Kimi Codeの呼び出し先(https://api.kimi.ai/coding)を自動で使うので、ベースURLの設定は要らない、と書かれています。一覧か「Enter custom model name」でモデルを選びます。k3-256k は一覧に出ないので、手入力します。ウィザードの「kimi-k3」と、設定の k3 は同じモデルで、設定ファイルや手入力には、kimi- を付けない書き方を使う、とあります。 3. 設定を書く。 hermes config edit で ~/.hermes/config.yaml を開き、公式の指示に従って、次の内容を取り込みます(既存のカスタムプロバイダは残します)。

```yaml custom_providers: - name: kimi-coding-plan base_url: https://api.kimi.ai/coding/v1 key_env: KIMI_API_KEY api_mode: chat_completions model: k3.1-pro extra_body: reasoning_effort: max models: k3.1-pro: context_length: 262144 supports_vision: true

model: provider: custom:kimi-coding-plan default: k3.1-pro context_length: 262144 supports_vision: true

agent: reasoning_effort: max

auxiliary: vision: provider: main model: k3.1-pro extra_body: reasoning_effort: max ```

公式のページは、base_url が /coding/v1 で終わること(Hermesが /chat/completions を足す)、1Mの文脈にするにはモデルIDと2つの context_length を 1048576 にすること、Plus/Moderatoは256Kのままであることを書いています。YAMLの字下げは、貼る前に原文と見比べてください。 4. (任意)動画・画像。 動画の解析(hermes tools enable video)と画像(/image、/paste)の手順がありますが、この記事は省きます。公式のページで確認してください。k3-256k は動画に対応しない、とあります。 5. 起動して確かめる。 hermes で新しいセッションを始め、ステータスバーに、期待するモデルと文脈(例:k3.1-pro と 256K)が出ることを確かめ、簡単な依頼を送ります。

公式が書く注意

渡るデータ・権限・外し方のまとめ

部品 渡るもの(読んだ範囲) 権限の制御 外し方
MCPサーバー ツールの呼び出しと引数、結果がエージェントに渡る。外のサーバーに何が送られるかは十分には書かれていない config.toml の permission.rules、enabledTools/disabledTools、信頼の確認 /mcp-config で削除、enabled: false。/mcp に「removed」と残る
ACP(IDE) IDEが kimi acp に渡す情報。詳細は記載なし CLI側の承認の仕組み(読んだページには記載なし) IDEの設定の項目を消す
スキル スキルの本文が、指示としてモデルに渡る(公式の「必要なときだけ読み込む」との説明は03) disableModelInvocation、type: flow フォルダを消す
プラグイン プラグインが宣言した部品(スキル、MCP、フックなど)が有効になる /plugins の有効/無効。信頼の確認 /plugins remove <id>。ファイルはディスクに残る
ブラウザ拡張 公式の自己説明は「ログイン状態とページの内容は端末から出ない」。AIに聞くために送る内容は読み切れていない ブラウザの権限の一覧は記載が見つからない 記載が見つからない
OpenCode/Hermes Agent ツールが会話に含めた内容が、Kimi Codeの呼び出し先に送られる(見立て。公式は説明していない) 各ツール側の文書の範囲 Hermesは追加項目を消す。OpenCodeは記載が見つからない。Kimi Code Console側でキーを取り消す手順は記載が見つからない

つまずきの早見表

症状 確認すること(公式の記載)
MCPサーバーが出ない 新しいセッションか。/mcp の状態。プロジェクトのサーバーは信頼の確認を通したか。画面なしの実行は、信頼済みでないと無効
MCPの呼び出しが毎回承認になる 規則に当たっていない。permission.rules のパターン(mcp__<サーバー>__<ツール>)を確かめる
スキルが読まれない name と description があるか。置き場所と優先順位。同名の単体ファイルとの重複
403(Kimi Code) 枠や速度の上限。会員の種類の範囲外のモデルを呼んでいないか

気をつけること

出典