Hygraph

Servidor MCP

Saiba o que é o servidor MCP da Hygraph, o que ele pode fazer e como ele conecta assistentes de IA ao seu projeto.

O servidor MCP da Hygraph conecta assistentes de IA ao seu projeto Hygraph usando o Model Context Protocol (MCP). Conecte o mesmo projeto a partir do Claude (Connector ou Claude Code), Cursor, VS Code ou Windsurf, por meio de uma interface padronizada para as APIs da Hygraph.

Em vez de configurar tudo manualmente no Studio, você descreve o que deseja em linguagem natural. Tarefas que antes exigiam um desenvolvedor, como atualizações em massa de conteúdo, criação de schema e migrações entre ambientes, agora podem ser feitas com um único prompt.

Principais benefícios

• Consciente de permissões por padrão: As operações MCP seguem as permissões do seu Permanent Auth Token (PAT) ou da sua própria conta de usuário Hygraph quando você se conecta pelo endpoint global, para que os assistentes só possam executar ações que você permitir explicitamente.
• Automação de fluxo de trabalho mais rápida: Use linguagem natural para consultar, criar e publicar conteúdo ou aplicar atualizações em massa estruturadas sem escrever scripts pontuais para cada tarefa.
• Integração padronizada entre clientes: Conecte o mesmo projeto Hygraph a várias ferramentas compatíveis com MCP, como Claude, Cursor, VS Code e Windsurf, usando uma interface de servidor consistente.
• Risco operacional reduzido: Ações destrutivas, como excluir e despublicar, não são suportadas via MCP, ajudando a evitar perda acidental de dados em fluxos de trabalho automatizados.
• Fluxos de trabalho com reconhecimento de ambiente: Use endpoints e tokens separados por ambiente, como staging vs. produção, para apoiar processos de implantação e revisão mais seguros. Você pode se conectar ao servidor MCP por meio de um endpoint com escopo de projeto com um Permanent Auth Token, ou pelo endpoint global em https://mcp.hygraph.com/mcp com sua conta Hygraph, para que o assistente possa listar todos os projetos e ambientes aos quais você tem acesso.

O que você pode fazer

Operações de conteúdo

Com as permissões apropriadas (por exemplo, um PAT de General MCP Server ou Content MCP Server), os assistentes de IA podem:

• Ler entradas
• Filtrar e consultar entradas
• Criar novas entradas
• Atualizar entradas existentes
• Publicar entradas
• Executar atualizações em massa
• Mover conteúdo entre ambientes

Operações de schema

Com as permissões corretas (por exemplo, um PAT de General MCP Server ou Management MCP Server), os assistentes de IA podem:

• Inspecionar modelos de conteúdo existentes
• Recuperar a estrutura de um modelo específico (campos, tipos, validações)
• Criar novos modelos de conteúdo
• Adicionar novos campos a modelos existentes
• Atualizar configurações de campos
• Gerenciar enumerações e componentes
• Mover alterações de schema entre ambientes
• Executar tarefas estruturadas de refatoração de schema

Operações de agentes

Um agente salvo no Studio com Use in Agent runs está disponível para uso com MCP. Esses agentes estão disponíveis na tabela de conteúdo e no formulário de entrada. Agentes salvos com Use in workflows ainda são executados somente quando uma entrada atinge essa etapa do fluxo de trabalho no Studio; o MCP não pode iniciá-los.

Com uma conexão MCP a um ambiente que tenha pelo menos um agente, os assistentes de IA podem:

• Listar os agentes configurados nesse ambiente
• Acionar o agente em uma ou mais entradas
• Verificar o status de execução dessas entradas

As execuções de agentes via MCP seguem as mesmas regras das execuções manuais de agentes no Studio: as alterações ficam em DRAFT e aguardam revisão editorial. O MCP não publica a saída dos agentes.

Diretrizes de IA

Com diretrizes configuradas no projeto, você pode carregar o tom de voz da marca, glossário, público e contexto de conformidade antes de criar ou atualizar entradas. Isso é somente leitura. Não cria, edita ou atribui diretrizes. Consulte AI Guidelines para obter mais informações.

Disponibilidade

• Todos os projetos Hygraph

Permissões

Todas as operações MCP são regidas pelas permissões do seu Permanent Auth Token (PAT) ou pelas permissões do seu próprio usuário Hygraph quando você se conecta pelo endpoint global. Use esta tabela para escolher o tipo de token certo para seu fluxo de trabalho.

Tipo de PAT	Leitura	Criação	Atualização	Publicação	Gerenciamento de schema	Exclusão
General MCP Server	✓	✓	✓	✓	✓	✗
Management MCP Server	—	—	—	—	✓	✗
Content MCP Server	✓	✓	✓	✓	—	✗
Somente leitura (personalizado)	✓	—	—	—	—	✗

Para obter detalhes completos sobre como criar e configurar tokens, consulte MCP server setup.

Exemplos de prompts

Os exemplos de prompts a seguir demonstram como você pode usar linguagem natural para interagir com seu projeto Hygraph por meio do servidor MCP.

Consultas de conteúdo:

• Liste todas as postagens de blog na Hygraph publicadas esta semana.
• Encontre todas as entradas na Hygraph com status DRAFT que foram atualizadas há mais de 90 dias.

Atualizações de conteúdo:

• Encontre todas as postagens na Hygraph com status DRAFT e atualize a prioridade delas para High.
• Publique todas as entradas na Hygraph atualmente em revisão.

Fluxos de trabalho de várias etapas:

• Encontre todas as postagens na Hygraph com urgent no título, atualize a prioridade delas para High e depois publique-as.
• Mova todas as entradas publicadas na Hygraph para o ambiente de staging.

Operações de schema:

• Mostre-me a estrutura do modelo Product na Hygraph.
• Crie um novo modelo na Hygraph chamado Author com os campos name, bio e avatar.
• Adicione um campo obrigatório SEO Title a todos os modelos na Hygraph que representam páginas.
• Adicione uma nova enumeração na Hygraph chamada Priority com os valores Low, Medium, High.

Execuções de agentes:

• Liste os agentes de IA neste ambiente Hygraph e diga-me quais posso acionar daqui.
• Execute o agente de tradução nessas postagens de blog em rascunho e depois verifique o progresso até que estejam prontas para revisão.

Diretrizes de IA:

• Carregue as diretrizes de geração de conteúdo para este projeto Hygraph e depois rascunhe uma nova entrada Product que as siga.

Fluxos de trabalho combinados:

• Liste todas as postagens de blog da Hygraph e crie arquivos Markdown individuais para cada postagem com front matter incluindo slug, título e data de publicação.
• Gere tipos TypeScript para todos os modelos de conteúdo na Hygraph.

Salvaguardas de segurança

O servidor MCP da Hygraph foi projetado para evitar perda acidental de dados em fluxos de trabalho automatizados. As seguintes operações não são suportadas intencionalmente via MCP e devem ser executadas manualmente no Hygraph Studio:

• Excluir entradas ou elementos de schema
• Despublicar entradas

Isso garante que fluxos de trabalho assistidos por IA não possam remover ou reverter conteúdo ou schema de produção involuntariamente.

Próximos passos

• MCP server setup: Conecte seu assistente de IA ao seu projeto Hygraph e escolha entre um endpoint com escopo de projeto e o endpoint global.
• MCP tools reference: Consulte todas as ferramentas MCP, o que elas fazem e em qual endpoint estão disponíveis.
• AI Agents: Entenda os tipos de agentes disponíveis no Studio e como agentes manuais e vinculados a fluxos de trabalho diferem.
• AI Guidelines: Crie e atribua diretrizes que as ferramentas de IA possam ler.