Cada conexión corresponde a un espacio de trabajo y no hay ninguna herramienta para cambiar de uno a otro. Vuelve a conectarte y elige el otro espacio de trabajo en la pantalla de consentimiento.
MCP
El servidor MCP de Ferndesk permite que herramientas de IA como Claude, ChatGPT, Cursor y Codex actúen en tu espacio de trabajo como si fueras tú. Pueden buscar y editar artículos, preparar cambios para su revisión, gestionar conversaciones de Soporte y consultar informes. Su dirección es https://mcp.ferndesk.com. Inicias sesión con OAuth, así que no necesitas una clave de API.
Los propietarios y administradores encontrarán los pasos específicos para cada cliente en Integraciones > Clientes de IA. Los colaboradores también pueden conectarse con la misma URL. Tu centro de ayuda también tiene un servidor MCP independiente y de solo lectura para los lectores; consulta Search, SEO and AI tools.
Conectar un cliente
Añade la URL a tu cliente y, luego, inicia sesión en Ferndesk en la ventana del navegador que se abre. En la pantalla de consentimiento, selecciona el espacio de trabajo y aprueba el acceso.
claude mcp add --transport http ferndesk https://mcp.ferndesk.comClaude (claude.ai y escritorio): añade un conector personalizado con la URL. En los planes Team y Enterprise, primero debe añadirlo el propietario de la organización. La guía de conectores personalizados de Anthropic explica los pasos.
Claude Code: ejecuta el comando, inicia una sesión, ejecuta
/mcp, seleccionaferndesky elige Autenticar.ChatGPT: activa el modo de desarrollador en Configuración > Aplicaciones > Configuración avanzada y, luego, crea una aplicación con la URL. El modo de desarrollador depende de tu plan de ChatGPT.
Cursor: usa Añadir a Cursor en la página de clientes de IA o añade el JSON anterior a
~/.cursor/mcp.jsono al archivo.cursor/mcp.jsonde un proyecto.Codex CLI: los servidores remotos deben añadirse a
config.toml, porquecodex mcp addsolo añade servidores locales. Luego, ejecutacodex mcp login ferndesk.Otros clientes: cualquier cliente compatible con Streamable HTTP y OAuth 2.1 con registro dinámico de clientes y PKCE (S256). Debe ser un cliente público: no funcionará si necesita un secreto de cliente fijo.
Qué puede hacer una conexión
Una conexión actúa como un miembro en un espacio de trabajo. Puede hacer todo lo que permitan tu rol y los permisos que aprobaste. Tu rol se verifica en cada solicitud, por lo que cualquier cambio de rol se aplica de inmediato.
Permiso | Qué permite |
|---|---|
| Leer y buscar artículos, borradores, revisiones, solicitudes de revisión y tareas de Fern. |
| Crear y editar borradores, mover y eliminar artículos, gestionar colecciones y su orden, preparar cambios en una solicitud de revisión y gestionar usuarios del centro de ayuda. |
| Publicar borradores y solicitudes de revisión, retirar publicaciones y restaurar revisiones. Solo para propietarios y administradores. |
| Leer conversaciones del asistente de IA de tu centro de ayuda. |
| Leer conversaciones de Soporte, clientes, compañeros de equipo, etiquetas y respuestas guardadas. |
| Añadir notas internas. Los propietarios y administradores también pueden asignar, etiquetar, cerrar, reabrir, posponer y marcar como prioritarias. |
| Enviar respuestas a los clientes en tu nombre. Está desactivado de forma predeterminada; actívalo en la pantalla de consentimiento. |
| Leer informes de Soporte y del centro de ayuda. |
| Leer la configuración del centro de ayuda, el widget, el agente de IA, el manual, la bandeja de entrada, las etiquetas, las respuestas guardadas y el equipo. Nunca se devuelven secretos. |
| Cambiar esa configuración, añadir bandejas de entrada de correo electrónico y activar Soporte. Solo para propietarios y administradores. |
| Invitar a compañeros de equipo. Está desactivado de forma predeterminada y solo está disponible para propietarios y administradores. |
Los clientes que no solicitan permisos específicos los reciben todos, excepto los dos que están desactivados de forma predeterminada. Para añadir un permiso más adelante, vuelve a conectarte y apruébalo.
Los cambios se someten a revisión
En un centro de ayuda que ya tiene artículos publicados, las ediciones se preparan en una solicitud de revisión. Nada se publica hasta que alguien lo aprueba, ya sea en Ferndesk o desde el cliente con tu confirmación. Al enviar una solicitud, se envía un correo electrónico a los propietarios y administradores. Las solicitudes de revisión que incluyan cambios en referencias de API solo se pueden publicar en Ferndesk.
Conservar la URL de un artículo
La URL de un artículo consta de su slug y un ID corto, por ejemplo, /connect-intercom-a1b2c. Si no tiene un slug personalizado, el slug se actualiza para seguir el título cada vez que se publica el artículo, y la URL anterior redirige a la nueva con un código 301.
Para elegir el slug, pasa slug a save_article al preparar el cambio en una solicitud de revisión. En el modo directo, guarda el borrador sin ese valor y pasa slug a publish_article. El slug se convierte en el slug personalizado del artículo, por lo que se mantiene aunque se cambie el título. Para conservar la URL actual al cambiar el título, pasa el slug actual. get_article devuelve customSlug, cuyo valor es true una vez que se establece un slug personalizado.
El slug debe tener al menos 2 caracteres: letras minúsculas, números y guiones simples, sin guiones al principio ni al final. Si el slug no es válido, se rechazará y se sugerirá una corrección.
El MCP no exige que los slugs sean únicos, porque todas las URL terminan con el ID corto.
No puedes pasar un slug para una traducción (cámbialo en Ferndesk), para eliminar un artículo ni en un centro de ayuda publicado a través de una plataforma externa.
El MCP no puede desactivar un slug personalizado. Para que la URL vuelva a seguir el título, desactiva Slug personalizado en Configuración del artículo > SEO.
La API pública acepta el mismo campo slug en POST /v1/review_requests/:id/changes, POST /v1/articles y PATCH /v1/articles/:id, con el mismo formato.
Enlazar colecciones y cambiar sus URL
Los enlaces de texto también pueden apuntar a una colección, una sección o una referencia de API publicada en el mismo centro de ayuda. Usa internal://coll_..., internal://sect_... o internal://apiref_... con los ID de get_helpdesk_overview (los ID de las referencias de API se obtienen con get_order en la sección).
Para cambiar la URL de una colección, pasa slug a save_collection junto con su collection_id. El ID corto no cambia, por lo que la URL anterior redirige a la nueva con un código 301.
Límites
No puede iniciar una tarea de Fern. Puede mostrar y descartar las tareas de Fern.
No hay ninguna herramienta para subir imágenes. Añade las imágenes al HTML o al markdown del artículo: las imágenes
data:insertadas se suben al guardar el artículo, y las imágenes alojadas en otros sitios se copian a tu centro de ayuda cuando se publica.No puede crear ni eliminar secciones, gestionar la facturación, las claves de API ni los webhooks.
El cuerpo de un artículo puede tener hasta 500.000 caracteres.
Las escrituras comparten el límite de la API: 1.000 por minuto por conexión y 3.000 por minuto por espacio de trabajo. Las lecturas no cuentan para el límite.
Si no hay una suscripción activa, los cambios están desactivados.
Gestionar conexiones
Los propietarios y administradores pueden ver todas las conexiones en la página de clientes de IA, una fila por espacio de trabajo, y revocar cualquiera de ellas. Si un colaborador quiere que se elimine una conexión, debe pedírselo a un propietario o administrador. Los tokens de acceso duran una hora y se renuevan durante 7 días, así que si no usas un cliente durante una semana, tendrás que volver a iniciar sesión.
¿Puede un cliente usar varios espacios de trabajo?
¿Por qué se rechazó mi guardado?
La mayoría de los rechazos indican qué debes cambiar: falta un permiso (vuelve a conectarte y apruébalo), tu rol solo permite guardar borradores, otro redactor tiene un borrador abierto del artículo o una edición eliminaría accidentalmente el encabezado del título, las imágenes o los bloques.
¿Puede publicar un colaborador?
No. El cliente de un colaborador guarda borradores y envía solicitudes de revisión; un propietario o administrador las publica.