La API que Mycel no conoce se conecta igual
Un catálogo de integraciones siempre deja fuera alguna API: el ERP del taller, la intranet de la asesoría, el servicio que montó alguien de dentro. Esta conexión sirve para esas: se guarda su URL base y su clave, con el mismo cifrado que el resto de conectores.
Ficha técnica
| Rama | Integraciones |
|---|---|
| Qué hace | Cualquier API REST que no esté en el catálogo se conecta igual: guardas su URL base y su clave, cifradas en tu Nodo, y el agente la llama por el nombre. |
| Pasos para ponerlo en marcha | 4 |
| Requisitos | 3 |
| Entrega | 3 |
| Actualizado | 6 de agosto de 2026 |
Qué resuelve esta conexión
Antes de que existiera, la respuesta del producto era «no puedo guardar esa credencial», y lo que pasaba después era peor que no tener la función: el agente acababa pidiéndote que pegaras la clave en un fichero del workspace para poder leerla. La credencial quedaba en texto plano en tu disco y, si trabajabas con un modelo en la nube, viajaba dentro del historial.
Ahora esa clave entra por la misma puerta que la de Holded: se guarda cifrada con AES-256-GCM en tu Nodo, no llega a nuestro servidor y no aparece en el contexto del modelo.
Por qué sigue siendo seguro si el destino lo eliges tú
En los otros conectores el destino es una constante del código y nadie lo mueve. Aquí lo eliges tú al guardar la conexión. Lo que no cambia es que el modelo sigue sin poder elegirlo: la herramienta con la que llama no tiene un hueco donde meter un host.
Y hay un segundo cierre encima: la credencial se guarda atada a su dominio, así que si el modelo intentara usarla en una petición dirigida a otro sitio (porque un correo o una página que ha leído se lo sugirió), el Nodo se niega y devuelve un error explicándolo. El destino lo decide quien guarda la conexión, nunca quien escribe el texto que el agente lee.
Los tres campos opcionales, y cuándo tocarlos
Obligatorios hay dos: la URL base de esa API y su clave. Con eso basta si la documentación dice «Authorization: Bearer», que es el caso más común. Los tres opcionales cubren el resto: otra cabecera (X-API-Key, por ejemplo), otro esquema, o la clave como parámetro en la URL.
Se preguntan en el alta y no en cada llamada a propósito: en el alta lo contesta una persona con la documentación delante, y así el agente no tiene que deducirlo cada vez ni equivocarse.
Cómo se pone en marcha
- 1
Busca en la documentación de esa API dos cosas: dónde empiezan sus rutas y cómo se manda la clave.
- 2
En Mycel, abre Tus cuentas, elige API personalizada (REST) y pega la URL base y la clave.
- 3
Si esa API no usa Authorization: Bearer, rellena la cabecera, el esquema o el parámetro que sí use; si lo usa, déjalos en blanco.
- 4
Encárgale la tarea nombrando la conexión: «saca de mi ERP los albaranes de agosto y móntame el Excel».
Dónde ocurre cada cosa
Tu equipo
Hace el encargo
Tu Nodo
Pone el cómputo
La red
Aporta el conocimiento
Preguntas frecuentes
- ¿Y si no sé qué rutas tiene mi API?
- El conector no declara operaciones, porque no se pueden conocer de antemano y declarar rutas inventadas sería peor que no declarar ninguna. El agente busca la documentación de esa API en la web o te pregunta a ti, y luego llama la ruta que corresponda.
- ¿Puede el agente cambiar la URL a la que manda mi clave?
- No. La herramienta con la que llama recibe el nombre de la conexión y una ruta; el host lo pone el Nodo desde la conexión guardada. Y si un secreto apareciera en una petición hacia otro dominio, el Nodo se niega a reponerlo y aborta la llamada.
- ¿Sirve para una API sin clave, pública?
- Para leer una API pública no hace falta ni conexión: el agente hace peticiones HTTP corrientes. Esta conexión existe justo para el caso contrario, el de la API que pide una credencial que no debería andar suelta.
- ¿Se puede conectar un servicio de mi red interna?
- Con el Nodo dentro de esa red, sí, pero hay que saber que el guard bloquea por defecto toda dirección privada, también en las llamadas a conexiones, para que un texto malicioso no pueda hacer que el agente sondee tu intranet. Levantar ese bloqueo para un host concreto es una decisión del dueño del Nodo al arrancarlo, nunca del modelo.
Pruébalo con tus propios documentos
Creas la cuenta, abres el Nodo y le encargas la primera tarea. Es gratis e ilimitado: el cómputo lo pone tu equipo, así que no hay nada que racionar.