Hygraph

Servidor MCP

El servidor MCP de Hygraph está disponible para todos los proyectos y actualmente se encuentra en Acceso Anticipado. Las funciones pueden cambiar y el uso en producción debe evaluarse en consecuencia.

El servidor MCP de Hygraph conecta asistentes de IA a tu proyecto de Hygraph mediante el Protocolo de Contexto de Modelo (MCP). Brinda a asistentes de IA como Claude, Cursor, Windsurf y VS Code una conexión directa y consciente de permisos a tu proyecto de Hygraph a través de una interfaz estandarizada hacia las API de Hygraph.

En lugar de configurar todo manualmente en Studio, describes lo que deseas en lenguaje natural. Tareas que antes requerían un desarrollador, como actualizaciones de contenido masivas, creación de esquemas y migraciones entre entornos, ahora pueden realizarse con un solo prompt.

#Beneficios clave

• Consciente de permisos por defecto: Las operaciones MCP siguen los permisos definidos en tu Token de Autenticación Permanente (PAT), por lo que los asistentes solo pueden realizar acciones que tú permitas explícitamente.
• Automatización de flujos de trabajo más rápida: Usa lenguaje natural para consultar, crear y publicar contenido o aplicar actualizaciones masivas estructuradas sin escribir scripts desechables para cada tarea.
• Integración estandarizada entre clientes: Conecta el mismo proyecto de Hygraph a múltiples herramientas compatibles con MCP, como Claude, Cursor, VS Code y Windsurf, usando una interfaz de servidor consistente.
• Riesgo operativo reducido: Las acciones destructivas como eliminar y despublicar no se admiten a través de MCP, lo que ayuda a prevenir la pérdida accidental de datos en flujos de trabajo automatizados.
• Flujos de trabajo conscientes del entorno: Usa endpoints y tokens separados por entorno, como staging frente a producción, para respaldar procesos de implementación y revisión más seguros.

#Lo que puedes hacer

#Operaciones de contenido

Con los permisos adecuados (por ejemplo, un PAT de General MCP Server o Content MCP Server), los asistentes de IA pueden:

• Leer entradas
• Filtrar y consultar entradas
• Crear nuevas entradas
• Actualizar entradas existentes
• Publicar entradas
• Realizar actualizaciones masivas
• Mover contenido entre entornos

#Operaciones de esquema

Con los permisos correctos (por ejemplo, un PAT de General MCP Server o Management MCP Server), los asistentes de IA pueden:

• Inspeccionar modelos de contenido existentes
• Recuperar la estructura de un modelo específico (campos, tipos, validaciones)
• Crear nuevos modelos de contenido
• Añadir nuevos campos a modelos existentes
• Actualizar configuraciones de campos
• Gestionar enumeraciones y componentes
• Mover cambios de esquema entre entornos
• Realizar tareas estructuradas de refactorización de esquemas

#Permisos

Todas las operaciones MCP están gobernadas por los permisos de tu Token de Autenticación Permanente (PAT). Usa esta tabla para elegir el tipo de token adecuado para tu flujo de trabajo.

Tipo de PAT	Leer	Crear	Actualizar	Publicar	Gestión de esquemas	Eliminar
General MCP Server	✓	✓	✓	✓	✓	✗
Management MCP Server	—	—	—	—	✓	✗
Content MCP Server	✓	✓	✓	✓	—	✗
Read-only (custom)	✓	—	—	—	—	✗

Para obtener detalles completos sobre cómo crear y configurar tokens, consulta la configuración del servidor MCP.

#Ejemplos de prompts

Los siguientes ejemplos de prompts demuestran cómo puedes usar lenguaje natural para interactuar con tu proyecto de Hygraph a través del servidor MCP.

Consultas de contenido:

• Lista todas las publicaciones de blog en Hygraph publicadas esta semana.
• Encuentra todas las entradas en Hygraph con estado DRAFT que se actualizaron por última vez hace más de 90 días.

Actualizaciones de contenido:

• Encuentra todas las publicaciones en Hygraph con estado DRAFT y actualiza su prioridad a High.
• Publica todas las entradas en Hygraph que están actualmente en revisión.

Flujos de trabajo de múltiples pasos:

• Encuentra todas las publicaciones en Hygraph con urgent en el título, actualiza su prioridad a High y luego publícalas.
• Mueve todas las entradas publicadas en Hygraph al entorno de staging.

Operaciones de esquema:

• Muéstrame la estructura del modelo Product en Hygraph.
• Crea un nuevo modelo en Hygraph llamado Author con los campos name, bio y avatar.
• Añade un campo SEO Title obligatorio a todos los modelos en Hygraph que representen páginas.
• Añade una nueva enumeración en Hygraph llamada Priority con los valores Low, Medium y High.

Flujos de trabajo combinados:

• Lista todas las publicaciones de blog de Hygraph y crea archivos Markdown individuales para cada publicación con front matter que incluya slug, título y fecha de publicación.
• Genera tipos de TypeScript para todos los modelos de contenido en Hygraph.

#Salvaguardas de seguridad

El servidor MCP de Hygraph está diseñado para prevenir la pérdida accidental de datos en flujos de trabajo automatizados. Las siguientes operaciones no se admiten intencionalmente a través de MCP y deben realizarse manualmente en Hygraph Studio:

• Eliminar entradas o elementos de esquema
• Despublicar entradas

Esto garantiza que los flujos de trabajo asistidos por IA no puedan eliminar o revertir involuntariamente contenido o esquema de producción.

#Próximos pasos

¿Listo para conectar tu asistente de IA? Consulta la guía de configuración del servidor MCP.