Configuración y ayuda14 / 16
Añadir servidores MCP y Skills
En esta página
Añade un servidor MCP cuando un Agente necesite herramientas adicionales o conexiones a servicios. Añade un Skill cuando quieras reutilizar instrucciones y recursos para un tipo de trabajo. Noea gestiona estas extensiones de forma centralizada para los chats normales de todos los Agentes.
Las extensiones son opcionales: no las necesitas para empezar. Las tareas de Explicar y de organización no utilizan las extensiones añadidas aquí.
Elige la extensión que necesitas
| Tipo | Propósito | Configuración |
|---|---|---|
| Servidor MCP | Proporcionar herramientas adicionales o conexiones a servicios. | Configuración → Servidores MCP |
| Skill | Proporcionar instrucciones y recursos de apoyo para un tipo de trabajo. | Configuración → Skills |
La disponibilidad de un servidor también depende de si el Agente admite su método de conexión. Para los comandos de Skills, utiliza la lista que realmente aparece en el chat.
Añade un servidor MCP
Abre Configuración → Servidores MCP, añade un servidor, introduce un nombre y elige su método de conexión.
- stdio: inicia un servicio localmente. Introduce su comando, argumentos y variables de entorno necesarias, con un argumento por línea.
- HTTP: conecta con un servicio por URL. Introduce la dirección del servidor y los encabezados necesarios.
Si el servicio proporciona una configuración JSON compatible, utiliza Pegar JSON para rellenar el formulario. Comprueba el comando, la dirección y los campos de autenticación antes de guardar.
Los nombres deben ser únicos, sin distinguir mayúsculas y minúsculas. Los nombres que empiezan por noea están reservados. La primera fila es el servidor integrado de Noea, que siempre está activado y no se puede eliminar.
Prueba la conexión
Probar conexión en el panel de edición utiliza los valores actuales del formulario. La prueba desde la lista utiliza la configuración guardada.
Una prueba correcta muestra los nombres de las herramientas y su cantidad. Un fallo identifica la etapa, como un comando ausente, la salida del proceso, un tiempo de espera agotado, una solicitud rechazada o un fallo en la negociación de conexión. Si un servicio HTTP requiere autorización, sigue el proceso del Agente seleccionado.
Una prueba correcta significa que la configuración permite conectar. No garantiza que todos los Agentes sean compatibles ni activa automáticamente el servidor para un chat.
Activa un servidor para un chat
El ajuste de uso predeterminado en chats nuevos de la lista de servidores determina la selección inicial. También puedes elegir servidores MCP para un chat concreto en su menú de configuración.
La elección se guarda con el chat. Un Agente conectado no recarga inmediatamente los ajustes modificados; se aplican en su próxima conexión. Para utilizar una configuración nueva, inicia un chat nuevo y comprueba la selección de servidores.
El menú explica por qué un servidor no está disponible, por ejemplo, por una variable de entorno ausente o un método de conexión no compatible.
Utiliza variables de entorno
Los valores de variables de entorno y encabezados admiten referencias ${VAR} a variables del entorno de ejecución de Noea. Los valores se leen al conectar. Prueba la conexión después de configurar. Ejecutar export en un terminal no garantiza que un proceso de Noea ya en ejecución disponga de ese valor.
Los campos ocultan los valores por defecto y permiten mostrarlos al pulsar. Ocultar un valor solo impide que se vea; no cambia cómo se guarda o utiliza la configuración.
Añade un Skill
Abre Configuración → Skills, elige la acción de añadir y selecciona una carpeta que contenga SKILL.md. La aplicación explica cualquier problema de formato.
El Skill se añade a la biblioteca de Noea. Las adiciones y eliminaciones se aplican en chats nuevos. Puedes mostrar su ubicación en el gestor de archivos. Al eliminarlo se borra la copia de la biblioteca, no la carpeta original seleccionada.
La misma página muestra Skills de solo lectura, a nivel de usuario y de proyecto, encontrados en los directorios de los Agentes. Consulta sus ubicaciones o elige Copiar a Noea. Esta lista no incluye todos los Skills integrados en los Agentes o proporcionados por sus complementos.
Utiliza extensiones en un chat
Inicia un chat nuevo y escribe / al principio del cuadro de entrada para explorar los Skills de Noea y los comandos del Agente. Selecciona un elemento disponible, añade los requisitos de la tarea actual y envía.
Si falta una extensión, comprueba que hayas iniciado un chat nuevo y que el Agente sea compatible; después consulta Solución de problemas.