Perfiles MCP
Code Mode, Code Mode UI y Full — cómo verxion expone sus herramientas y por qué el modo por defecto es una sola tool, no cientos.
verxion entrega toda su funcionalidad a través de tres perfiles MCP. El perfil lo decide el snippet que copias en la página de setup — la mayoría de los usuarios nunca lo tocan. Esta página existe para que sepas qué pasa bajo el capó.
Los tres perfiles
| Perfil | Tools expuestas | Cuándo usarlo |
|---|---|---|
| Code Mode (por defecto) | 1 (execute_code) | Día a día. El perfil recomendado. |
| Code Mode UI | 1 + renderers de widgets | ChatGPT, cuando quieres tarjetas visuales inline |
| Full | Todas las tools individuales | Debug, integraciones a medida |
Code Mode (por defecto)
En vez de exponer cada tool como una función MCP separada, Code Mode expone una única execute_code. Tu agente escribe un snippet corto de TypeScript — verxion lo ejecuta en un sandbox aislado donde cada helper queda protegido por los mismos scopes OAuth que aplicarían a una tool directa.
Por qué es el modo por defecto:
- ChatGPT limita las apps personalizadas a ~100 tools. Sin Code Mode, los catálogos grandes simplemente no caben.
- Menos round-trips. Una llamada
execute_codepuede fanout a varias operaciones internas (leer tu rutina, iniciar la sesión, registrar la primera serie) en vez de tres llamadas separadas. - Menos prompt bloat. El agente no tiene que escanear una lista enorme de tools cada turno.
Lo que cedes:
- Los widgets visuales solo se renderizan en Code Mode UI (ver abajo).
- Para comandos one-shot muy simples, las tools individuales serían marginalmente más rápidas. Lo hemos medido — es marginal.
Code Mode UI
El perfil híbrido: execute_code más un set curado de tools-widget. ChatGPT renderiza las tarjetas inline; todo lo demás pasa por execute_code como siempre.
Usa Code Mode UI cuando:
- Estás en ChatGPT y quieres resúmenes de sesión, gráficos de macros y contribution grids renderizados como tarjetas visuales en vez de tablas markdown.
Es la elección correcta para los ajustes de la App de ChatGPT. Claude Desktop y Claude Code no renderizan widgets, así que usan Code Mode por defecto.
Modo Full
Expone cada tool como una función MCP discreta — sin sandbox, sin execute_code. Útil cuando:
- Construyes una integración a medida y quieres control fino sobre cada llamada
- Estás depurando el comportamiento de una tool y quieres aislarla
- Pasas por middleware que necesita ver los nombres de tool directamente
No verás Full mode en los snippets por defecto — está disponible bajo petición.
Cómo se elige el perfil
El servidor MCP al que apunta tu cliente decide el perfil. La página de setup te entrega la URL correcta por cliente:
- Claude Desktop / Claude Code → endpoint Code Mode
- ChatGPT → endpoint Code Mode UI
- Integración a medida → solicita un endpoint Full mode
Cambiar de perfil significa cambiar la URL en el config de tu cliente y reiniciar la conversación/sesión.
Nota de seguridad
Independientemente del perfil, cada llamada a tool aplica los scopes OAuth. El agente nunca obtiene acceso de escritura ambiental — cada operación está gateada por los scopes que lleva tu token. Ver Scopes OAuth.