• MAPEAMENTO
  • BUSCA
  • VALIDAÇÃO
  • HUMANO

Como consultar e inspecionar o schema com sua IA

Conecte o Hygraph ao seu cliente de IA para que ele mapeie suas estruturas de conteúdo e busque dados via GraphQL.

Pergunte à IA sobre esta página

Resposta rápida

Como minha IA visualiza os modelos de conteúdo do Hygraph?

Sua IA usa introspecção para mapear tipos de conteúdo e campos. Assim que ela entende o schema, escreve e executa consultas GraphQL para buscar exatamente o que você precisa. Você recebe conteúdo estruturado sem precisar escrever código.

Resultados

O que você ganha com esta conexão

A IA cuida da parte complexa de navegar no seu CMS headless.

MAPEAMENTO

Visibilidade total do schema

A IA lê todo o seu modelo de conteúdo. Ela identifica quais modelos existem e quais campos eles possuem.

BUSCA

Acesso direto aos dados

Seu agente executa consultas GraphQL para buscar entradas ou listas específicas, trazendo o conteúdo direto para o chat.

VALIDAÇÃO

Precisão dos campos

A IA verifica tipos de campos e requisitos. Isso garante que as consultas criadas funcionem corretamente no seu Hygraph.

HUMANO

Supervisão manual

Você mantém o controle dos dados. Você decide quais consultas rodar e revisa os resultados antes de usá-los.

O fluxo

O que sua IA faz quando a conexão está ativa.

A IA passa da descoberta para a execução em três etapas lógicas.

  1. Descobrir o schema

    A IA analisa sua instância do Hygraph para entender como o conteúdo está organizado, identificando modelos e seus relacionamentos.

    list_schema_introspection

  2. Mapear campos específicos

    Ao encontrar um modelo, a IA detalha os campos específicos, aprendendo os nomes e tipos exatos de cada atributo.

    get_model_fields

  3. Executar consultas GraphQL

    A IA constrói uma consulta baseada no seu pedido, envia a requisição ao Hygraph e retorna os dados no chat.

    execute_graphql_query

  4. Refinar pedidos de dados

    Se uma consulta falhar ou trouxer dados errados, a IA usa as informações do schema para corrigir a query e tentar novamente.

    list_schema_introspectionexecute_graphql_query

Teste

Copie estes exemplos para começar.

Use estes comandos para iniciar o processo.

Pontos de partida

Substitua o texto entre colchetes pelos nomes reais dos seus modelos ou campos do Hygraph.

Hygraph Connector

Tudo pronto. Escolha seu cliente MCP e siga as instruções de configuração.

Link do conectorhttps://edge.vinkius.com/vk_preview_E2kDf3rmUJJgcNZKXaOKQyqaD4p2MZcV1xyGfKJa/mcp

Claude Desktop

Siga os passos abaixo para conectar em segundos.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Hygraph capabilities are ready to use.
Configuração · claude_desktop_config.jsonCopiar
{
  "mcpServers": {
    "hygraph-headless-cms-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_E2kDf3rmUJJgcNZKXaOKQyqaD4p2MZcV1xyGfKJa/mcp"
    }
  }
}
Copie no chat04

  • Liste todos os modelos de conteúdo disponíveis no meu schema do Hygraph.

  • Mostre os campos do modelo 'Product' para eu saber o que posso consultar.

  • Execute uma consulta GraphQL para obter o título e o slug de todas as entradas do modelo 'Blog Post'.

  • Encontre o ID da entrada chamada 'Summer Campaign' na minha biblioteca de conteúdo.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Comece aqui

Conecte o Hygraph uma vez e comece a perguntar.

Basta fornecer suas credenciais do Hygraph. A conexão é segura e você pode começar imediatamente a explorar seu conteúdo com a IA.

Conectar Hygraph à sua IA

FAQ

Como funciona esta tarefa

  • 01

    A IA pode alterar meu conteúdo no Hygraph?

    Não. Este conector foi projetado para leitura e inspeção de schema e dados. Ele não pode criar, atualizar ou excluir conteúdo.

  • 02

    A IA escreve as consultas GraphQL sozinha?

    Sim. Após inspecionar seu schema, ela escreve as consultas necessárias para buscar os dados que você pedir.

  • 03

    A IA pode excluir um modelo se eu pedir?

    Não. As ferramentas fornecidas permitem apenas a introspecção do schema e a recuperação de dados. Ela não tem permissão para modificar sua estrutura no Hygraph.

  • 04

    Como a IA sabe quais campos usar em uma consulta?

    Ela utiliza as ferramentas de introspecção de schema para ver exatamente quais campos existem nos seus modelos antes de tentar rodar uma consulta.

  • 05

    Posso ver a resposta bruta do GraphQL?

    Sim. O seu cliente de IA mostrará os dados que ele recuperou após a execução da consulta.

  • Mais dúvidas sobre o Hygraph? Veja tudo o que o MCP do Hygraph pode fazer

Conecte Hygraph ao Claude, Cursor, ChatGPT e outros