Conectar Claude a Caryvane
El servidor MCP de Caryvane es un único endpoint HTTPS; Claude necesita su URL y su clave. Cinco minutos, y «¿qué copias de seguridad fallaron anoche?» pasa a ser una pregunta en lugar de un informe.
1. Crear una clave #
Consola → su nombre → Claves de acceso de IA → Nueva clave. Llámela «Claude», elija el nivel (Solo lectura para preguntas, Lectura + control para que pueda iniciar y cancelar ejecuciones, Lectura + control + edición para que pueda crear tareas y montar unidades) y copie la clave; solo se muestra una vez. Los niveles se detallan en Asistentes de IA y API.
2a. Claude Code #
Desde el terminal, en el proyecto en el que quiera tenerlo disponible (o con --scope user para todos):
claude mcp add --transport http caryvane https://console.caryvane.com/mcp/rpc \
--header "Authorization: Bearer <key>"
O cree .mcp.json en el proyecto:
{
"mcpServers": {
"caryvane": {
"type": "http",
"url": "https://console.caryvane.com/mcp/rpc",
"headers": { "Authorization": "Bearer <key>" }
}
}
}
Deje el archivo fuera del control de versiones: contiene la clave. Reinicie Claude Code; /mcp muestra el servidor y sus herramientas.
2b. Claude Desktop y claude.ai #
Aquí se equivoca mucha gente, porque el botón que parece obvio es el que no es. Caryvane se autentica con una clave que usted pega como encabezado, no con un inicio de sesión, así que no hay dónde iniciar sesión y no se abrirá ninguna ventana. Siga el panel que le mostró la consola al crear la clave: tiene un botón de copiar junto a cada uno de los tres valores.
- Configuración → Conectores → Añadir conector personalizado (en inglés, Settings → Connectors → Add custom connector).
- Llámelo
Caryvane. - Pegue la URL del servidor:
https://console.caryvane.com/mcp/rpc(o la dirección de su propia consola, si es otra). - No inicie sesión y deje vacíos los campos de OAuth. No hay ID de cliente ni secreto de cliente. Si pulsa Conectar esperando un inicio de sesión, fallará.
- Añada un encabezado personalizado. Nombre
Authorization. ValorBearerseguido de su clave, con un espacio entre ambos y nada más. La consola lo ofrece ya montado: si copia Valor del encabezado, se ahorra escribirlo. - Guárdelo y actívelo para la conversación. Las herramientas de Caryvane aparecen en el menú de herramientas.
El error más habitual, con diferencia, es pegar la clave sola como valor del encabezado. La palabra Bearer y el espacio forman parte de él.
2c. ChatGPT #
ChatGPT llega al mismo endpoint de la misma forma, en Settings → Connectors → Create (con los nombres traducidos en la interfaz en español; en algunos planes está tras el modo de desarrollador). Indique el nombre y la misma URL /mcp/rpc, elija como autenticación la opción de token de acceso o clave de API en lugar de OAuth y pegue su clave. ChatGPT la envía como Authorization: Bearer <key>, que es exactamente lo que espera Caryvane. Los nombres de los menús cambian de una versión a otra; los tres valores, nunca.
Caryvane no ofrece OAuth, así que un cliente que lo exija no puede conectarse. Si es su caso, use en su lugar la interfaz REST sencilla descrita en Asistentes de IA y API: las mismas herramientas, los mismos niveles, llamadas HTTP normales con el mismo encabezado bearer.
3. Usarlo #
Las descripciones de las herramientas le dicen a Claude qué hace cada una y qué debe comprobar primero, así que funcionan las peticiones sencillas:
- «¿Qué tareas terminaron con error o advertencia en las últimas 24 horas, y por qué?»:
get_dashboard,list_jobs,get_job_runs. - «¿Está HHSRV1 en línea y qué versión tiene?»:
list_agents. - «Enséñame el registro del agente de BTBS2 hacia las 2 de la madrugada.»:
get_agent_logs. - «Ejecuta ahora la tarea nocturna de Henderson.»:
run_job(nivel Lectura + control). - «Crea una copia de seguridad nocturna de D:\Shares en HHSRV1 al bucket de Henderson y conserva 5 versiones.»:
create_job(nivel Lectura + control + edición). - «Hazme un token de registro para Modobloc.»:
create_enrollment_token(nivel Acceso completo).
Claude ve exactamente lo que ve usted. No puede descargar el contenido de los archivos, ni eliminar o mover archivos del almacenamiento; examinar devuelve solo nombres y fechas.
Si no se conecta #
- 401: la clave es incorrecta, está revocada o se pegó con un espacio al final.
- Faltan herramientas tras un cambio por nuestra parte: vuelva a conectar el servidor (Claude guarda la lista de herramientas al conectarse).
- «Not allowed» en una herramienta: el nivel de la clave es insuficiente; emita una clave de nivel superior.