• DATOS CRUDOS
  • ANÁLISIS
  • REPORTES
  • HUMANO

Cómo consultar subgraphs personalizados con tu IA

Conecta The Graph a tu cliente de IA una sola vez. Después, podrás extraer datos on-chain específicos usando sintaxis GraphQL estándar.

Pregunta a la IA sobre esta página

Respuesta rápida

¿Cómo puedo ejecutar consultas GraphQL con mi IA?

Solo tienes que darle al agente un ID de subgraph y una cadena de consulta GraphQL. El agente usa el conector para obtener los datos de la red descentralizada. Recibirás los resultados en JSON puro o un resumen en lenguaje natural del estado on-chain.

Resultados de datos

Dónde terminan tus datos.

Lo que obtienes tras ejecutar una consulta con tu IA.

DATOS CRUDOS

Resultados JSON directos

La IA extrae la respuesta JSON exacta del subgraph. Puedes copiarla directamente en tu código o herramientas de análisis.

ANÁLISIS

Información on-chain

Tu agente interpreta los datos consultados para responder preguntas sobre saldos de tokens, volumen de transacciones o pools de liquidez.

REPORTES

Resúmenes formateados

La IA convierte las respuestas complejas del subgraph en tablas o listas limpias y fáciles de leer en tu chat.

HUMANO

Ajuste manual de consultas

Si una consulta falla por errores de sintaxis, deberás corregir la cadena GraphQL tú mismo antes de pedirle a la IA que lo intente de nuevo.

El flujo

Qué hace tu IA cuando llega una consulta.

La IA gestiona la comunicación con la red para que no tengas que escribir peticiones fetch.

  1. Identificar el subgraph

    La IA identifica el ID de subgraph específico que buscas a partir de tu instrucción.

    query_subgraph
  2. Ejecutar GraphQL

    El agente envía tu consulta GraphQL a la red a través del conector.

    query_subgraph
  3. Procesar respuesta

    La IA recibe el paquete JSON y lo relaciona con tu pregunta original.

    query_subgraph
  4. Entregar respuesta

    El agente presenta los datos como una respuesta clara o un bloque de datos estructurado.

    query_subgraph

Pruébalo

Copia estos ejemplos para empezar.

Usa estos prompts para comenzar a consultar datos on-chain.

Puntos de partida

Sustituye el ID del subgraph y los campos de la consulta por tus propios requisitos.

The Graph Connector

Todo listo. Elige tu cliente MCP y sigue las instrucciones de configuración.

Enlace del conectorhttps://edge.vinkius.com/vk_preview_lKCcPQtDzEbLkEyQdpLNknTGhTDgro8TIiVVYvos/mcp

Claude Desktop

Sigue los pasos siguientes para conectarte en 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.
Configuración · claude_desktop_config.jsonCopiar
{
  "mcpServers": {
    "the-graph-web3-indexing-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_lKCcPQtDzEbLkEyQdpLNknTGhTDgro8TIiVVYvos/mcp"
    }
  }
}
Copia en el chat04
  • Consulta el subgraph '0x123...' para obtener las últimas 10 transacciones de este token.

  • Obtén el volumen total del subgraph de Uniswap V3 usando esta consulta: { ... }

  • Busca el saldo actual de la dirección de billetera 0xabc... en este subgraph.

  • Usa el ID de subgraph '0x456...' para listar todos los proveedores de liquidez activos.

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

Empieza aquí

Conecta The Graph una vez y luego pregunta.

Haz clic en el enlace para conectar tu cliente. Tus credenciales permanecen cifradas y podrás empezar a consultar de inmediato.

Conecta The Graph a tu IA

FAQ

Funcionamiento de la tarea

  • 01

    ¿Puede la IA cambiar datos en la blockchain?

    No. Este conector es de solo lectura. Solo puede extraer datos de los subgraphs; no puede ejecutar transacciones ni modificar el estado on-chain.

  • 02

    ¿Debo escribir yo mismo el GraphQL?

    Puedes hacerlo. Si proporcionas una cadena de consulta GraphQL válida, la IA la ejecutará exactamente como la hayas escrito.

  • 03

    ¿Puede la IA corregir mi sintaxis GraphQL si falla?

    La IA puede sugerir correcciones, pero no puede obligar al subgraph a devolver datos si la consulta es lógicamente imposible.

  • 04

    ¿Puede la IA crear nuevos subgraphs?

    No. La herramienta se limita a consultar subgraphs existentes mediante sus IDs únicos.

  • 05

    ¿La IA almacena mis IDs de subgraph?

    La IA solo utiliza los IDs que incluyes en tus prompts para realizar las búsquedas.

Conecta The Graph a Claude, Cursor, ChatGPT y más