Qué puede hacer
Deja que el agente lea las especificaciones antes de escribir código
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.Fundamenta el Goal Mode y los Subagents en materiales reales
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.
Comparte una única base de conocimiento en todos los workspaces
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.
Requisitos previos
- ZCode instalado
- Linkly AI Desktop en ejecución con el servicio MCP activo
Pasos de configuración
- MCP HTTP local (Recomendado)
- MCP remoto
- CLI Stdio (Alternativo)
1
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.
2
Elegir el ámbito
Selecciona User para que Linkly AI esté disponible en todos los
workspaces, o Workspace para limitarlo al proyecto actual.
3
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
linkly-ai está activado en la lista de servidores.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:$ en el
cuadro de entrada y selecciona linkly-ai para invocarlo.
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
Los servidores configurados en .agents/mcp.json han desaparecido
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.Falla la conexión con el método HTTP
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.El servidor aparece en la lista pero sus herramientas no están disponibles
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.El método stdio dice que no encuentra el comando linkly
El método stdio dice que no encuentra el comando linkly
Asegúrate de haber instalado Linkly AI CLI y de que el
comando
linkly esté disponible en tu PATH. Verifícalo con linkly --version.