Usar Forjar

Extensiones

Skills, conectores MCP y plugins que tu equipo instala para el chat y para los agentes de sus runs.

Las extensiones son del equipo: lo que instala un equipo llega a su chat y a los sandboxes de sus runs, y a nada de otro equipo. Solo un propietario instala, quita o cambia lo que los agentes pueden escribir. Están en Factory › Conexiones › Extensiones.

Skills

Una skill es un directorio con un SKILL.md (con name y description en el frontmatter) y los ficheros que traiga. Es el mismo formato que leen Claude Code y Codex.

  • De dónde: un repositorio o directorio de GitHub (https://github.com/owner/repo/tree/<ref>/<ruta>) o cualquier URL https:// a un solo fichero.
  • Primero una vista previa: nombre, ficheros, si trae scripts, el commit y el hash del contenido. Al instalar, Forjar descarga ese commit exacto y lo guarda solo si el hash coincide con el que viste.
  • Límites: 200 ficheros, 256 KiB cada uno, 2 MiB en total.
  • En los runs: el agente la encuentra en su home del sandbox, nunca en el clon, así que nada se commitea con el trabajo.

Nunca ejecuto los scripts de una skill. Instalar es descargar, comprobar y guardar. Un agente puede ejecutarlos con sus propias herramientas dentro de su sandbox, que ya está aislado.

Conectores (MCP)

Un conector es un servidor MCP remoto que conectas por nombre y dirección, con una credencial opcional.

  • La credencial solo entra por el formulario de la cabina. El chat nunca la pide ni la muestra.
  • Si el servidor pide iniciar sesión (OAuth), basta con la dirección: Forjar te manda al servidor para autorizar y guarda los tokens cifrados.
  • Lecturas y escrituras. Una herramienta es de lectura si el servidor la marca así o si tú la declaras. El chat llama a las lecturas por su cuenta; una escritura es una propuesta que confirmas.
  • En los runs, los agentes llegan a los conectores a través de Forjar, sin ver su credencial. Leen libremente; una escritura solo se permite si la marcas por herramienta.
  • Solo direcciones públicas por https. En self-hosted, FORJA_MCP_ALLOW_PRIVATE_ENDPOINTS=true permite servidores de tu red.

Plugins

Un plugin con el formato de Claude Code no se instala de una pieza. Forjar lo desmonta:

ParteQué pasa
skills/*Cada una se instala como skill
Servidores de .mcp.json con urlCada uno se conecta como conector sin credencial; si pide un secreto, se lo das en la cabina
Hooks, comandos, agentes, servidores localesNo se instalan para el asistente. Se listan en la vista previa y se guardan

Las partes ejecutables (hooks) quedan apagadas. Solo corren en un sandbox, solo con Claude Code, y solo si el equipo enciende el interruptor y la instalación ha pasado la prueba de escape del sandbox. Encenderlo es aceptar el código del plugin: un hook corre con las credenciales y la red del run.