Servidores MCP personalizados
Más allá de los connectors del catálogo de Rephlo, puedes conectar un servidor MCP personalizado que tú mismo operes, o uno gestionado por alguien de tu confianza. Esto es para usuarios avanzados que ya cuentan con un servidor MCP y un token para acceder a él.
Los servidores personalizados se agregan en la aplicación de escritorio, en Settings → Connectors → Add custom connector. No hay una interfaz web para esto; todo ocurre localmente en tu equipo.
Antes de empezar
Necesitarás:
- Un servidor MCP al que puedas acceder (su comando, o su URL).
- Un token bearer para ese servidor, si requiere autenticación.
Por ahora, la autenticación es solo mediante token bearer. Los servidores personalizados actualmente se autentican con un único token bearer precompartido: pegas un token y Rephlo lo envía con cada solicitud. Los servidores personalizados basados en OAuth (donde inicias sesión a través de un navegador, como con Notion) aún no son compatibles y llegarán en una versión posterior.
Agregar un servidor personalizado
- Abre Settings → Connectors y haz clic en Add custom connector.
- Asígnale un nombre al servidor para poder reconocerlo más adelante.
- Elige un transporte: la forma en que Rephlo se comunica con el servidor:
- Streamable HTTP — Rephlo se conecta a una URL del servidor a través de la red.
- Stdio — Rephlo ejecuta un ejecutable local y se comunica con él directamente en tu equipo.
- Completa la configuración específica del transporte (consulta la tabla a continuación).
- Pega el token bearer del servidor.
- Save. Rephlo se conecta, le pregunta al servidor qué herramientas ofrece, y las herramientas del servidor quedan disponibles en el chat.
El panel de Add custom connector, con la selección de transporte y el campo del token bearer.
Configuración de transporte
| Transporte | Obligatorio | Opcional |
|---|---|---|
| Streamable HTTP | URL del servidor | Un token bearer para autenticación |
| Stdio | Ruta del ejecutable a iniciar | Argumentos |
El propio catálogo de connectors de Rephlo fija algunos servidores a un hash binario SHA-256 para una verificación adicional, pero eso se gestiona del lado de Rephlo — no es un campo que configures al agregar tu propio connector personalizado.
Dónde vive tu información
- Los servidores personalizados y sus tokens bearer se almacenan en tu dispositivo, cifrados en reposo. No se envían al backend de Rephlo.
- Las llamadas a herramientas de servidores personalizados se ejecutan directamente desde tu escritorio hacia el servidor — no pasan por la nube de Rephlo.
- Como con todos los connectors, los resultados de las herramientas viven en memoria durante la sesión, y el registro de auditoría local solo guarda el nombre de la herramienta, la duración y el estado — nunca los argumentos ni el contenido.
Solución de problemas
El servidor rechaza la conexión (401 / no autorizado). El token bearer es incorrecto o ha sido rotado. Elimina el servidor y vuelve a agregarlo con el token correcto.
La conexión agota el tiempo de espera (timeout). Verifica que la URL del servidor sea accesible y que el servidor responda con rapidez razonable — las llamadas a herramientas tienen un límite de tiempo fijo. Si el servidor simplemente es lento, revisa su rendimiento o disponibilidad.
Las herramientas no aparecen, o las llamadas a herramientas fallan al analizarse. El servidor debe hablar MCP válido y declarar sus herramientas cuando Rephlo se conecta. Confirma que el servidor emita definiciones y respuestas de herramientas MCP bien formadas.