• DADOS BRUTOS
  • ANÁLISE
  • RELATÓRIOS
  • HUMANO

Como consultar subgraphs personalizados com sua IA

Conecte o The Graph ao seu cliente de IA uma única vez. Depois, você poderá extrair dados on-chain específicos usando a sintaxe padrão do GraphQL.

Pergunte à IA sobre esta página

Resposta rápida

Como posso rodar consultas GraphQL pela minha IA?

Você fornece um ID de subgraph e uma string de consulta GraphQL ao seu agente. Ele usa o conector para buscar os dados solicitados na rede descentralizada. Você recebe os resultados em JSON bruto ou um resumo em linguagem natural sobre o estado on-chain.

Resultados de dados

Onde seus dados chegam.

O que você recebe após a IA executar uma consulta.

DADOS BRUTOS

Resultados JSON diretos

A IA extrai a resposta JSON exata do subgraph. Você pode copiar esse conteúdo diretamente para seu código ou ferramentas de análise.

ANÁLISE

Insights on-chain

Seu agente interpreta os dados consultados para responder perguntas sobre saldos de tokens, volume de transações ou pools de liquidez.

RELATÓRIOS

Resumos formatados

A IA transforma respostas complexas do subgraph em tabelas ou listas limpas e fáceis de ler na sua janela de chat.

HUMANO

Ajuste manual de consultas

Se uma consulta falhar por erro de sintaxe, você precisará refinar a string GraphQL antes de pedir para a IA tentar novamente.

O fluxo

O que sua IA faz ao receber uma consulta.

A IA cuida da comunicação com a rede para que você não precise escrever requisições de fetch.

  1. Identificar o subgraph

    A IA identifica o ID do subgraph específico que você deseja consultar através do seu prompt.

    query_subgraph

  2. Executar GraphQL

    O agente envia sua consulta GraphQL bruta para a rede via conector.

    query_subgraph

  3. Processar resposta

    A IA recebe o payload JSON e o correlaciona com a sua pergunta original.

    query_subgraph

  4. Entregar resposta

    O agente apresenta os dados como uma resposta clara ou um bloco de dados estruturado.

    query_subgraph

Teste

Copie estes exemplos para começar.

Use estes prompts para iniciar suas consultas de dados on-chain.

Pontos de partida

Substitua o ID do subgraph e os campos da consulta pelos seus dados específicos.

The Graph Connector

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

Link do conectorhttps://edge.vinkius.com/vk_preview_lKCcPQtDzEbLkEyQdpLNknTGhTDgro8TIiVVYvos/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 — The Graph capabilities are ready to use.
Configuração · claude_desktop_config.jsonCopiar
{
  "mcpServers": {
    "the-graph-web3-indexing-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_lKCcPQtDzEbLkEyQdpLNknTGhTDgro8TIiVVYvos/mcp"
    }
  }
}
Copie no chat04

  • Consulte o subgraph '0x123...' para obter as últimas 10 transações deste token.

  • Obtenha o volume total do subgraph Uniswap V3 usando esta consulta: { ... }

  • Encontre o saldo atual do endereço de carteira 0xabc... neste subgraph.

  • Use o ID do subgraph '0x456...' para listar todos os provedores de liquidez ativos.

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

Comece aqui

Conecte o The Graph uma vez e pronto.

Clique no link para conectar seu cliente. Suas credenciais ficam criptografadas e você pode começar a consultar imediatamente.

Conectar o The Graph à sua IA

FAQ

Como o processo funciona

  • 01

    A IA pode alterar dados na blockchain?

    Não. Este conector é apenas de leitura. Ele serve para buscar dados em subgraphs, não para executar transações ou modificar o estado on-chain.

  • 02

    Eu preciso escrever o GraphQL sozinho?

    Você pode. Se você fornecer uma string de consulta GraphQL válida, a IA a executará exatamente como foi escrita.

  • 03

    A IA consegue corrigir minha sintaxe GraphQL se estiver errada?

    A IA pode sugerir correções, mas não consegue forçar o subgraph a retornar dados se a consulta for logicamente impossível.

  • 04

    A IA pode criar novos subgraphs?

    Não. A ferramenta é limitada a consultar subgraphs já existentes através de seus IDs únicos.

  • 05

    A IA armazena meus IDs de subgraph?

    A IA utiliza apenas os IDs que você fornece nos seus prompts para realizar as buscas.

  • Mais dúvidas sobre o The Graph? Veja tudo o que o conector do The Graph pode fazer

Conecte The Graph ao Claude, Cursor, ChatGPT e outros