Documentación

Servidor MCP

Conecta asistentes de IA a tus proyectos mediante Model Context Protocol. Explora, lee, busca y edita con las mismas comprobaciones de conflictos que el editor.

Un asistente inicia el servidor MCP de IWE Code con --mcp y usa los flujos estándar. Las herramientas de lectura pueden conectarse a los servidores configurados.

Cómo funciona

  • El asistente lanza el binario de IWE Code con el indicador --mcp. El proceso sirve Model Context Protocol por sus flujos estándar.
  • El servidor lee el mismo archivo de espacio de trabajo que la aplicación. Los proyectos que añadas o selecciones en IWE Code aparecen de inmediato.
  • Las herramientas cubren exploración, lectura, búsqueda y edición. Las herramientas de Git informan de ramas, archivos cambiados y commits recientes.
  • Editar exige un token de revisión de la última lectura. La escritura falla si el archivo cambió después de leerlo, así que nada se sobrescribe a ciegas.

Conecta un asistente

Apunta el cliente al binario de la aplicación y añade el indicador --mcp. La ruta del binario depende de tu método de instalación.

Claude Code acepta un comando:

claude mcp add iwe -- /path/to/iwe --mcp

Claude Desktop, Cursor y otros clientes leen una configuración mcpServers:

{
  "mcpServers": {
    "iwe": {
      "command": "/path/to/iwe",
      "args": ["--mcp"]
    }
  }
}

Herramientas

El servidor MCP ofrece once herramientas. Solo write_file cambia archivos de texto locales existentes. La solicitud tools/list devuelve los esquemas de entrada.

list_projects
Lista espacios y proyectos, con el proyecto seleccionado marcado.
list_files
Lista archivos y carpetas de un nivel de un proyecto.
read_file
Lee un archivo de texto. La respuesta incluye un token de revisión para editar.
write_file
Sustituye el contenido de un archivo de texto existente usando su token de revisión.
search_files
Encuentra archivos por búsqueda difusa de nombre y ruta.
git_status
Muestra la rama actual y los archivos cambiados.
git_log
Muestra commits recientes con autores, fechas y referencias.
list_deployments
Enumera conexiones, claves SSH registradas y perfiles. El resultado omite los secretos.
resolve_deployment_path
Indica profile y una ruta: local o remote. Devuelve la asignación sin conectarse.
deployment_read_remote
Indica profile y un path remoto absoluto. Lee un archivo UTF-8 de hasta 512 KiB.
deployment_compare
Indica profile y un path relativo al proyecto. Devuelve localText, remoteText e identical. Cada archivo admite hasta 512 KiB.

El flujo de edición

  1. Lee el archivo. La respuesta incluye el contenido y un token de revisión.
  2. Envía el contenido cambiado de vuelta con el mismo token.
  3. El servidor comprueba el archivo contra el token antes de escribir. Rechaza la escritura si el archivo cambió tras tu lectura.
  4. Vuelve a leer el archivo y repite cuando se rechace una escritura.

Seguridad

  • Las herramientas usan los proyectos del espacio de trabajo. Las rutas locales deben permanecer dentro del proyecto.
  • MCP usa credenciales guardadas para leer archivos remotos. Los resultados omiten las credenciales.
  • Los metadatos del espacio y los archivos remotos permanecen intactos. Usa la CLI para gestionar despliegues y transferir archivos.
  • El servidor rechaza líneas JSON-RPC entrantes de más de 1 MiB. Cada texto de una lectura remota tiene un límite de 512 KiB.

Compila desde el código fuente

Usa el binario instalado de la aplicación o compila desde el fuente:

cargo build --release
# The binary lands in target/release/iwe

Documentación para desarrolladores

La documentación para desarrolladores describe el protocolo, las herramientas y sus límites en detalle.