Empezar

Configura tu agente desde tu agente de código

Identidad, modelo, archivos de conocimiento, skills y servidores MCP — todo por API con el token del agente, y una skill para que Claude Code, Cursor o Codex lo hagan por ti.

Actualizado 2026-09-16

En Ghosty Studio la configuración no vive en formularios: vive en una API pequeña sobre la máquina del agente, y quien la usa es tu agente de código. Le instalas una skill, le das el token, y le pides las cosas en tu idioma.

1. Copia el token de tu agente

En Agentes → tu agente → Conexión con tu editor → Generar token. El token empieza por gat_ y sólo alcanza a ese agente. El id está en la URL: /app/agents/<id>.

Guárdalos como variables de entorno en tu terminal; nunca en argumentos ni en archivos del repo:

2. Instala la skill en tu agente de código

Funciona con Claude Code, Cursor, Codex y el resto de agentes que leen . La skill sabe qué endpoint llamar, en qué orden y qué no hacer (por ejemplo, reiniciar una sola vez al final).

3. Pídeselo

Abre tu agente de código en cualquier carpeta y habla normal:

Le dices	Lo que hace
«Ponle esta identidad a mi agente de Ghosty: es Nora, asistente de la clínica, contesta corto y nunca diagnostica.»	`PATCH` con `prompt`, luego `restart`. La identidad se anexa a lo que el cerebro lee al arrancar.
«Súbele los PDFs de la carpeta `precios/`.»	Un `PUT …/files/<nombre>` por archivo. Caen en el workspace del agente; los ve con `ls`.
«Instálale la skill de cotizaciones que está en `skills/cotizaciones/`.»	`PUT …/skills/cotizaciones` con el `SKILL.md` y sus assets, luego `restart`.
«Conéctalo al MCP de Notion con este token.»	`GET …/mcp`, añade el servidor a la lista y `PUT` completo. Se reinicia solo.
«Cámbialo a Sonnet.»	`GET` para ver los modelos válidos, `PATCH` con `model`.
«¿Qué tiene configurado?»	`GET …?full=1`: identidad, modelo, archivos, skills y MCPs.

Después, pruébalo en el chat: «¿qué archivos tienes en tu workspace?» o «¿quién eres?».

Qué hay debajo

Todo pasa por https://www.ghosty.studio/api/v2/agents/<id> con Authorization: Bearer gat_…:

Ruta	Para qué
`GET /` · `PATCH /`	leer y cambiar `name`, `model`, `prompt`, `webSearch`, `channels`
`PUT /files/<ruta>` · `DELETE` · `GET /files`	archivos en `/data/work/` (bytes crudos, ≤10 MB)
`PUT /skills/<slug>` · `DELETE` · `GET /skills`	`SKILL.md` + assets en `/data/agent/skills/<slug>/`
`GET /mcp` · `PUT /mcp`	servidores MCP propios (`http` con URL o `stdio` con comando); reinicia
`POST /restart`	reinicia el proceso del agente; corta un turno en vuelo, el disco sobrevive

Detalle de cada cuerpo y respuesta en la (tag Configuración) y en el .

Lo que conviene saber

Identidad y modelo funcionan en todos los motores. Archivos, skills y MCPs propios necesitan máquina propia (Ghosty · Lite y Goose); en Claude o DeepSeek esas rutas responden 409 agente_sin_maquina hasta que lleguen.
La identidad y las skills entran al reiniciar. Un PATCH de prompt y un PUT de skill quedan guardados en la máquina; el cerebro los lee cuando arranca. Por eso la skill agrupa cambios y reinicia una vez.
Los archivos no necesitan reinicio: están en el disco en cuanto termina el PUT.
Un PUT /mcp reemplaza la lista entera. Para añadir uno, manda la lista existente más el nuevo.
El token es la llave del agente: quien lo tenga puede hablar con él y usar su terminal. Si se filtra, rótalo desde la ficha; el anterior muere al instante.
La máquina puede estar dormida: la primera llamada la despierta y tarda unos segundos.

← Anterior

Conceptos