Cómo crear una acción de código tipo MCP
Las acciones de código tipo MCP (Model Context Protocol) permiten definir funciones personalizadas que los agentes pueden ejecutar de forma estructurada y entendible por los modelos de IA.
Crear una acción de código MCP
- Ingresa a la sección “Código” de la barra lateral izquierda.
- Haz clic en Crear nueva acción de código.
- Elige el tipo AI Function
- Se generará una plantilla base con la estructura mínima que debe cumplir.
Al clickear en "Guardar" la acción se publicará automaticamente.
Estructura obligatoria
Toda acción MCP debe cumplir las siguientes condiciones:
Elemento | Descripción |
Una sola función exportada por defecto | Debe existir un único export default function. |
Parámetros definidos | Cada parámetro debe tener un nombre, tipo de dato y descripción. |
Documentación JSDoc | La función y sus parámetros deben estar documentados usando el formato estándar JSDoc. |
Ejemplo básico
/**
* this function multiply by 2
*
* @param myNumber the number to multiply by 2
*
* @return the double
*/
export default function double(myNumber: number): number {
return myNumber * 2;
}
Desglose del ejemplo:
Elemento | Descripción |
| Indica el bloque de documentación JSDoc. |
| Descripción general de la función. Explica qué hace. |
| Parámetro: nombre (myNumber), tipo (number) y descripción. |
| Valor devuelto: explica qué retorna la función. |
| Define la única función exportada que ejecutará el código MCP. |
Recomendaciones
- Incluye siempre una descripción clara de la función y de cada parámetro.
- Utiliza nombres simples y expresivos (en inglés o español, según el estándar interno).
- Prueba tu código con ejemplos simples antes de implementarlo en producción.
- Si recibes un error, verifica que tu función cumpla con todos los puntos anteriores.
Limitaciones actuales (modo beta)
- Solo funciona con modelos compatibles con MCP (ChatGPT-4).
- No se pueden importar otras funciones.
- No accede a variables de usuario ni permite referencias cruzadas entre acciones.
- Algunas funciones del entorno todavía no están disponibles.
Importante
Las acciones de código tipo MCP están disponibles en modo beta. Su funcionamiento puede cambiar en futuras versiones.
Recuerda visitar nuestro Centro de Ayuda para mayor información