> ## Documentation Index
> Fetch the complete documentation index at: https://linkly.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Kimi Code で Linkly AI を使う

> Linkly AI のローカルナレッジベースを Kimi Code CLI に接続して、Kimi エージェントがあなたのプライベートドキュメントを検索・閲覧できるようにします

## 何ができるか

<AccordionGroup>
  <Accordion title="モデルの記憶ではなく、自分の資料に基づいて回答させる">
    Kimi Code は Linkly AI の `search`
    ツールを呼び出してあなたのコンピューター上の関連ドキュメントを探し、`read`
    で該当箇所を正確に取り込みます。一般的な知識ではなく、あなたのノート・仕様書・レポートに基づいた回答が得られます。
  </Accordion>

  <Accordion title="検索からアウトライン、そして全文へと段階的に掘り下げる">
    `search` で候補を絞り込み、`outline`
    で長いドキュメントの構造を把握し、`read`
    で必要な箇所だけをページ送りで読みます。長大なレポートでもコンテキストウィンドウを圧迫せずに扱えます。
  </Accordion>

  <Accordion title="プロジェクト単位でも全体共有でも設定できる">
    ユーザーレベルで Linkly AI
    を一度設定すればすべてのプロジェクトが継承します。特定のリポジトリにプロジェクトレベルの設定を置くこともできます。同名のエントリはプロジェクトレベルがユーザーレベルを上書きします。
  </Accordion>
</AccordionGroup>

## 前提条件

* [Kimi Code CLI](https://www.kimi.com/code) がインストール済みであること（Node.js
  22.19.0 以降が必要）
* Linkly AI Desktop が起動しており、MCP サービスが実行中であること

<Note>
  このガイドは **Kimi Code CLI** を対象としています。デスクトップアプリの Kimi
  Work は現在、厳選されたプラグインセンターのみを提供しており、独自の MCP
  サーバーを追加する導線がないため、Linkly AI をまだ接続できません。
</Note>

## 設定手順

Kimi Code は `mcp.json` から MCP サーバーを読み込みます：

* ユーザースコープ: `~/.kimi-code/mcp.json`
* プロジェクトスコープ: プロジェクトルートの `.kimi-code/mcp.json`

<Tabs>
  <Tab title="ローカル MCP HTTP（推奨）" icon="globe">
    `~/.kimi-code/mcp.json` に以下を追加します：

    ```json theme={null}
    {
      "mcpServers": {
        "linkly-ai": {
          "url": "http://127.0.0.1:60606/mcp"
        }
      }
    }
    ```

    `url` フィールドがあり `transport` がないエントリは HTTP
    サーバーとして扱われます。
  </Tab>

  <Tab title="リモート MCP" icon="cloud">
    先に[リモートアクセス設定](/docs/ja/use-in-remote)を完了し、デスクトップトンネルが
    <Badge stroke color="green">● 接続済み</Badge> と表示されていることを確認してください。

    `~/.kimi-code/mcp.json` に以下を追加します：

    ```json theme={null}
    {
      "mcpServers": {
        "linkly-ai": {
          "url": "https://mcp.linkly.ai/mcp",
          "headers": {
            "Authorization": "Bearer <あなたの API Key>"
          }
        }
      }
    }
    ```

    API Key は [Linkly AI
    ダッシュボード](https://linkly.ai/dashboard/integrations) で作成でき、`lkai_`
    で始まります。
  </Tab>

  <Tab title="CLI Stdio（代替手段）" icon="terminal">
    先に [Linkly AI CLI をインストール](/docs/ja/use-cli)してから、`~/.kimi-code/mcp.json`
    に以下を追加します：

    ```json theme={null}
    {
      "mcpServers": {
        "linkly-ai": {
          "command": "linkly",
          "args": ["mcp"]
        }
      }
    }
    ```

    `command` フィールドがあるエントリは stdio サーバーとして扱われます。
  </Tab>
</Tabs>

<Tip>
  JSON ファイルを手で編集する代わりに、Kimi Code の TUI で `/mcp-config`
  を実行して、対話的にサーバーを追加・編集・削除することもできます。
</Tip>

## Skills のインストール

Kimi Code は `~/.agents/skills/` から Agent Skills を読み込むため、Linkly AI
Skills をインストールしてエージェントにこれらのツールの効率的な使い方を教えられます：

```bash theme={null}
git clone https://github.com/LinklyAI/linkly-ai-skills.git ~/.agents/skills/linkly-ai
```

`/skill:linkly-ai` で呼び出せます。その他のインストール方法については [Skills
の使い方](/docs/ja/use-skills)をご覧ください。

## 接続を確認する

Kimi Code の TUI で `/mcp` を実行して接続状態を確認します。`linkly-ai`
がツール一覧とともに接続済みとして表示されるはずです。

続いて、次のように尋ねてみてください：

```
Search my documents for content about project design
```

正しく設定されていれば、Kimi Code は Linkly AI の `search`
ツールを呼び出して結果を返します。

## よくある質問

<AccordionGroup>
  <Accordion title="`kimi mcp add` で unknown command と表示される">
    その構文は旧来の `kimi-cli` のもので、現在は段階的に廃止されています。Kimi
    Code CLI に `mcp` サブコマンドはありません。TUI の `/mcp-config`
    を使うか、`mcp.json` を直接編集して設定してください。
  </Accordion>

  <Accordion title="HTTP 方式で接続に失敗する">
    Linkly AI Desktop が起動しており、MCP
    サービスが実行中かどうかを確認してください。ターミナルで `curl
            http://127.0.0.1:60606/mcp` を実行して接続をテストできます。
  </Accordion>

  <Accordion title="サーバーは一覧にあるがツールが呼び出されない">
    エントリに `"enabled": false` が付いていないこと、そして `disabledTools`
    リストで Linkly AI のツールが除外されていないことを確認してください。Linkly
    AI Skills
    をインストールすると、エージェントがこれらのツールを使う可能性が大幅に高まります。
  </Accordion>

  <Accordion title="Stdio 方式で linkly コマンドが見つからないと表示される">
    [Linkly AI CLI をインストール](/docs/ja/use-cli)済みで、`linkly` コマンドが PATH
    から利用できることを確認してください。`linkly --version` で検証できます。
  </Accordion>
</AccordionGroup>