Hygraph

Servidor MCP

Aprende qué es el servidor MCP de Hygraph, qué puede hacer y cómo conecta asistentes de IA a tu proyecto.

El servidor MCP de Hygraph conecta asistentes de IA a tu proyecto de Hygraph mediante el Protocolo de Contexto de Modelo (MCP). Conecta el mismo proyecto desde Claude (Connector o Claude Code), Cursor, VS Code o Windsurf, a través de una interfaz estandarizada hacia las API de Hygraph.

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

Beneficios clave

• Consciente de permisos por defecto: Las operaciones MCP siguen los permisos de tu Token de Autenticación Permanente (PAT), o de tu propia cuenta de usuario de Hygraph cuando te conectas a través del endpoint global, 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 únicos 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 son compatibles 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 vs producción, para respaldar procesos de despliegue y revisión más seguros. Puedes conectarte al servidor MCP a través de un endpoint con ámbito de proyecto con un Token de Autenticación Permanente, o el endpoint global en https://mcp.hygraph.com/mcp con tu cuenta de Hygraph, para que el asistente pueda listar cada proyecto y entorno al que tengas acceso.

Lo que puedes hacer

Operaciones de contenido

Con los permisos apropiados (por ejemplo, un PAT de Servidor MCP General o Servidor MCP de Contenido), 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 Servidor MCP General o Servidor MCP de Gestión), 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

Operaciones de agentes

Un agente guardado en Studio con Usar en ejecuciones de Agente está disponible para usar con MCP. Estos agentes están disponibles desde la tabla de contenido y el formulario de entrada. Los agentes guardados con Usar en flujos de trabajo solo se ejecutan cuando una entrada llega a ese paso del flujo de trabajo en Studio; MCP no puede iniciarlos.

Con una conexión MCP a un entorno que tenga al menos un agente, los asistentes de IA pueden:

• Listar los agentes configurados en ese entorno
• Activar el agente en una o más entradas
• Verificar el estado de ejecución de esas entradas

Las ejecuciones de agentes desde MCP siguen las mismas reglas que las ejecuciones manuales de agentes en Studio: los cambios llegan a BORRADOR y esperan revisión editorial. MCP no publica la salida de los agentes.

Directrices de IA

Con directrices configuradas en el proyecto, puedes cargar el tono de marca, glosario, audiencia y contexto de cumplimiento antes de crear o actualizar entradas. Esto es de solo lectura. No crea, edita ni asigna directrices. Consulta Directrices de IA para más información.

Disponibilidad

• Todos los proyectos de Hygraph

Permisos

Todas las operaciones MCP están gobernadas por los permisos de tu Token de Autenticación Permanente (PAT), o por tus propios permisos de usuario de Hygraph cuando te conectas a través del endpoint global. Usa esta tabla para elegir el tipo de token correcto para tu flujo de trabajo.

Tipo de PAT	Leer	Crear	Actualizar	Publicar	Gestión de esquema	Eliminar
Servidor MCP General	✓	✓	✓	✓	✓	✗
Servidor MCP de Gestión	—	—	—	—	✓	✗
Servidor MCP de Contenido	✓	✓	✓	✓	—	✗
Solo lectura (personalizado)	✓	—	—	—	—	✗

Para obtener detalles completos sobre cómo crear y configurar tokens, consulta 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 campos name, bio y avatar.
• Añade un campo obligatorio SEO Title a todos los modelos en Hygraph que representen páginas.
• Añade una nueva enumeración en Hygraph llamada Priority con valores Low, Medium, High.

Ejecuciones de agentes:

• Lista los agentes de IA en este entorno de Hygraph y dime cuáles puedo activar desde aquí.
• Ejecuta el agente traductor en estas publicaciones de blog en borrador, luego verifica el progreso hasta que estén listas para revisión.

Directrices de IA:

• Carga las directrices de generación de contenido para este proyecto de Hygraph, luego redacta una nueva entrada Product que las siga.

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 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 son compatibles 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.

Qué sigue

• Configuración del servidor MCP: Conecta tu asistente de IA a tu proyecto de Hygraph y elige entre un endpoint con ámbito de proyecto y el endpoint global.
• Referencia de herramientas MCP: Consulta cada herramienta MCP, qué hace y en qué endpoint está disponible.
• Agentes de IA: Comprende los tipos de agentes disponibles en Studio y cómo difieren los agentes manuales y los vinculados a flujos de trabajo.
• Directrices de IA: Crea y asigna directrices que las herramientas de IA puedan leer.