> ## 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.

# Usar Linkly AI en Kimi Code

> Conecta tu base de conocimiento local de Linkly AI a Kimi Code CLI para que el agente de Kimi pueda buscar y leer tus documentos privados

## Qué puede hacer

<AccordionGroup>
  <Accordion title="Responde a partir de tus propios materiales, no de la memoria del modelo">
    Kimi Code llama a la herramienta `search` de Linkly AI para encontrar los
    documentos relevantes en tu ordenador y luego a `read` para extraer las
    secciones exactas — de modo que la respuesta se basa en tus notas,
    especificaciones e informes en lugar de en conocimiento general.
  </Accordion>

  <Accordion title="De la búsqueda al esquema y al texto completo, capa por capa">
    Usa `search` para localizar candidatos, `outline` para ver la estructura de
    un documento largo y `read` para recorrer solo las secciones que importan.
    Los informes extensos se gestionan sin inundar la ventana de contexto.
  </Accordion>

  <Accordion title="Delimítalo por proyecto o compártelo en todas partes">
    Configura Linkly AI una sola vez a nivel de usuario y todos los proyectos lo
    heredarán, o coloca una configuración a nivel de proyecto en un repositorio
    concreto. Las entradas con el mismo nombre a nivel de proyecto tienen
    prioridad sobre las de nivel de usuario.
  </Accordion>
</AccordionGroup>

## Requisitos previos

* [Kimi Code CLI](https://www.kimi.com/code) instalado (requiere Node.js 22.19.0
  o posterior)
* Linkly AI Desktop en ejecución con el servicio MCP activo

<Note>
  Esta guía cubre **Kimi Code CLI**. La aplicación de escritorio Kimi Work
  ofrece actualmente solo un centro de plugins curado y no tiene ningún punto de
  entrada para añadir tus propios servidores MCP, por lo que Linkly AI todavía
  no puede conectarse ahí.
</Note>

## Pasos de configuración

Kimi Code lee los servidores MCP desde `mcp.json`:

* Ámbito de usuario: `~/.kimi-code/mcp.json`
* Ámbito de proyecto: `.kimi-code/mcp.json` en la raíz de tu proyecto

<Tabs>
  <Tab title="MCP HTTP local (Recomendado)" icon="globe">
    Añade lo siguiente a `~/.kimi-code/mcp.json`:

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

    Una entrada con un campo `url` y sin `transport` se trata como un servidor
    HTTP.
  </Tab>

  <Tab title="MCP remoto" icon="cloud">
    Completa primero la [configuración de acceso remoto](/docs/es/use-in-remote), con
    el túnel de escritorio mostrando <Badge stroke color="green">● Conectado</Badge>.

    Añade lo siguiente a `~/.kimi-code/mcp.json`:

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

    Tu API Key se crea en el
    [panel de Linkly AI](https://linkly.ai/dashboard/integrations) y empieza por
    `lkai_`.
  </Tab>

  <Tab title="CLI Stdio (Alternativo)" icon="terminal">
    [Instala primero Linkly AI CLI](/docs/es/use-cli) y luego añade lo siguiente a
    `~/.kimi-code/mcp.json`:

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

    Una entrada con un campo `command` se trata como un servidor stdio.
  </Tab>
</Tabs>

<Tip>
  También puedes ejecutar `/mcp-config` dentro de la TUI de Kimi Code para
  añadir, editar o eliminar servidores de forma interactiva en lugar de editar
  el archivo JSON a mano.
</Tip>

## Instalar Skills

Kimi Code busca Agent Skills en `~/.agents/skills/`, así que puedes instalar las
Skills de Linkly AI para enseñar al agente a usar estas herramientas de forma
eficiente:

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

Invócalo con `/skill:linkly-ai`. Consulta [Usar Skills](/docs/es/use-skills) para
conocer otros métodos de instalación.

## Verificar la conexión

Ejecuta `/mcp` en la TUI de Kimi Code para comprobar el estado de la conexión —
`linkly-ai` debería aparecer como conectado junto con sus herramientas.

Después prueba con una instrucción:

```
Busca en mis documentos contenido sobre el diseño del proyecto
```

Si la configuración es correcta, Kimi Code llamará a la herramienta `search` de
Linkly AI y devolverá los resultados.

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="`kimi mcp add` informa de un comando desconocido">
    Esa sintaxis pertenece al antiguo `kimi-cli`, que está siendo retirado. Kimi
    Code CLI no tiene el subcomando `mcp` — configura los servidores mediante
    `/mcp-config` en la TUI o editando `mcp.json` directamente.
  </Accordion>

  <Accordion title="Falla la conexión con el método HTTP">
    Comprueba si Linkly AI Desktop está en ejecución y si el servicio MCP está
    activo. Puedes ejecutar `curl http://127.0.0.1:60606/mcp` en una terminal
    para probar la conectividad.
  </Accordion>

  <Accordion title="El servidor aparece en la lista pero nunca se llama a sus herramientas">
    Confirma que la entrada no lleva `"enabled": false` y que ninguna lista
    `disabledTools` está filtrando las herramientas de Linkly AI. Instalar las
    Skills de Linkly AI también hace mucho más probable que el agente recurra a
    estas herramientas.
  </Accordion>

  <Accordion title="El método stdio dice que no encuentra el comando linkly">
    Asegúrate de haber [instalado Linkly AI CLI](/docs/es/use-cli) y de que el
    comando `linkly` esté disponible en tu PATH. Verifícalo con `linkly     --version`.
  </Accordion>
</AccordionGroup>