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

> Conecta tu base de conocimiento local de Linkly AI a ZCode para que el agente de programación impulsado por GLM pueda buscar y leer tus documentos privados

## Qué puede hacer

<AccordionGroup>
  <Accordion title="Deja que el agente lea las especificaciones antes de escribir código">
    Usa la herramienta `search` de Linkly AI para encontrar registros de
    decisiones de arquitectura y documentos de requisitos, y luego `read` para
    leer las secciones relevantes. El agente de ZCode escribe código con las
    convenciones de tu proyecto en la mano, en lugar de adivinarlas.
  </Accordion>

  <Accordion title="Fundamenta el Goal Mode y los Subagents en materiales reales">
    ZCode ejecuta tareas de larga duración de forma autónoma mediante Goal Mode
    y Subagents. Con Linkly AI conectado, esas ejecuciones pueden recuperar
    materiales locales bajo demanda — de modo que una refactorización o
    migración de varios pasos permanece anclada a tu documentación real.
  </Accordion>

  <Accordion title="Comparte una única base de conocimiento en todos los workspaces">
    Configura Linkly AI una sola vez en el ámbito de usuario y todos los
    workspaces de ZCode podrán acceder a los mismos documentos locales. Sin
    volver a subir archivos adjuntos, sin configuración por proyecto.
  </Accordion>
</AccordionGroup>

## Requisitos previos

* [ZCode](https://zcode.z.ai) instalado
* Linkly AI Desktop en ejecución con el servicio MCP activo

## Pasos de configuración

<Tabs>
  <Tab title="MCP HTTP local (Recomendado)" icon="globe">
    <Steps>
      <Step title="Abrir la página MCP Servers">
        Abre los **Settings** de ZCode, ve a la página **MCP Servers** y haz clic
        en **New MCP Server**.
      </Step>

      <Step title="Elegir el ámbito">
        Selecciona **User** para que Linkly AI esté disponible en todos los
        workspaces, o **Workspace** para limitarlo al proyecto actual.
      </Step>

      <Step title="Rellenar la configuración y añadir">
        Rellena la siguiente información:

        * **Type**: `HTTP`
        * **Name**: `linkly-ai`
        * **URL**: `http://127.0.0.1:60606/mcp`

        Haz clic en **Add** para terminar y luego confirma que el interruptor
        junto a `linkly-ai` está activado en la lista de servidores.
      </Step>
    </Steps>
  </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>.

    <Steps>
      <Step title="Abrir la página MCP Servers">
        Abre los **Settings** de ZCode, ve a la página **MCP Servers** y haz clic
        en **New MCP Server**.
      </Step>

      <Step title="Rellenar la configuración remota">
        Rellena la siguiente información:

        * **Type**: `HTTP`
        * **Name**: `linkly-ai`
        * **URL**: `https://mcp.linkly.ai/mcp`
      </Step>

      <Step title="Añadir la cabecera de autenticación">
        Despliega **Request headers (optional)** y añade:

        * **Key**: `Authorization`
        * **Value**: `Bearer <tu API Key>`

        Tu API Key se crea en el
        [panel de Linkly AI](https://linkly.ai/dashboard/integrations) y empieza
        por `lkai_`. Haz clic en **Add** para terminar.
      </Step>
    </Steps>
  </Tab>

  <Tab title="CLI Stdio (Alternativo)" icon="terminal">
    [Instala primero Linkly AI CLI](/docs/es/use-cli) y luego edita directamente el
    archivo de configuración de ZCode:

    * Ámbito de usuario: `~/.zcode/cli/config.json`
    * Ámbito de workspace: `<raíz del proyecto>/.zcode/config.json`

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

    <Note>
      Los dos archivos comparten el mismo nombre pero se encuentran en niveles
      distintos — la configuración de usuario vive en `.zcode/cli/`, mientras que
      la de workspace está directamente en `.zcode/`. Editar el archivo
      equivocado es el error más habitual aquí.
    </Note>

    Puedes lograr el mismo resultado desde la interfaz: en la página **MCP
    Servers** haz clic en **New MCP Server**, mantén **Type** como `stdio`,
    establece **Command** en `linkly` y **Args** en `mcp`.
  </Tab>
</Tabs>

## Instalar Skills

ZCode admite Agent Skills, así que también 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 ~/.zcode/skills/linkly-ai
```

Vuelve a **Settings → Skills** y haz clic en **Refresh**, luego escribe `$` en el
cuadro de entrada y selecciona `linkly-ai` para invocarlo.

<Tip>
  Consulta [Usar Skills](/docs/es/use-skills) para conocer más métodos de instalación
  y cómo funcionan las Skills.
</Tip>

## Primeros pasos

Una vez configurado, haz tus preguntas directamente en ZCode y el agente llamará
a las herramientas de Linkly AI por su cuenta. Por ejemplo:

* «Busca en mis documentos las decisiones de arquitectura sobre este módulo»
* «Lee mi especificación de API y comprueba si esta implementación coincide con
  ella»

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="Los servidores configurados en .agents/mcp.json han desaparecido">
    Dentro del mismo ámbito, la configuración de `.zcode` tiene prioridad: en
    cuanto ZCode lee cualquier servidor MCP del archivo de configuración de
    `.zcode`, el archivo `.agents/mcp.json` de ese ámbito se omite por completo
    en lugar de fusionarse. Mueve esos servidores al archivo de configuración de
    `.zcode`.
  </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 sus herramientas no están disponibles">
    Un servidor deshabilitado se marca con `"enable": false` en el objeto de
    configuración. Vuelve a activarlo desde la página **MCP Servers** o elimina
    ese campo del archivo de configuración.
  </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>