• マッピング
  • データ取得
  • 検証
  • コントロール

AIでHygraphのスキーマを照会・確認する方法

HygraphをAIクライアントに接続すれば、AIがコンテンツ構造を把握し、GraphQLを使用してデータを取得できるようになります。

このページについてAIに聞く

すぐに答え

AIはどのようにHygraphのコンテンツモデルを把握するのですか？

AIはイントロスペクション（内省）機能を用いて、コンテンツタイプやフィールドの構成をマッピングします。スキーマを理解した後は、AIがGraphQLクエリを自動生成して実行し、必要なデータを正確に抽出します。コードを書くことなく、構造化されたデータを取得できます。

実現できること

この接続によって得られるメリット

ヘッドレスCMSの複雑な操作は、すべてAIが引き受けます。

マッピング

スキーマの全容把握

AIがコンテンツモデル全体を読み取ります。どのモデルが存在し、どのようなフィールドが含まれているかを正確に把握します。

データ取得

データへの直接アクセス

エージェントがGraphQLクエリを実行し、特定のエンティティやリストを抽出します。取得したコンテンツはそのままチャットに表示されます。

検証

フィールドの正確性

AIがフィールドの型や必須条件を確認します。これにより、構築されたクエリがHygraphの設定に対して正しく動作することを保証します。

コントロール

人間による管理

データの制御権は常にあなたにあります。どのクエリを実行するかを決定し、結果を確認してから利用できます。

ワークフロー

接続完了後、AIが行うプロセス

AIは「探索」から「実行」まで、3つの論理的なステップで動作します。

  1. スキーマの探索

    AIがHygraphのインスタンスを確認し、コンテンツがどのように構成されているかを分析します。利用可能なすべてのモデルとそのリレーションシップを特定します。

    list_schema_introspection

  2. 特定フィールドの解析

    モデルを特定した後、AIはその中の詳細なフィールドまで踏み込みます。各属性の正確な名前や型を学習します。

    get_model_fields

  3. GraphQLクエリの実行

    ユーザーのリクエストに基づき、AIがクエリを構築します。Hygraphにリクエストを送信し、結果をチャットに返します。

    execute_graphql_query

  4. リクエストの最適化

    クエリが失敗したり、意図しないデータが返された場合、AIはスキーマ情報を活用してクエリを修正し、再試行します。

    list_schema_introspectionexecute_graphql_query

試してみる

以下のプロンプトをコピーして開始してください。

これらのプロンプトを使ってプロセスを開始できます。

出発点

括弧内のテキストは、実際のHygraphのモデル名やフィールド名に書き換えてください。

Hygraph Connector

準備完了です。MCPクライアントを選択し、セットアップ手順に従ってください。

コネクタリンクhttps://edge.vinkius.com/vk_preview_E2kDf3rmUJJgcNZKXaOKQyqaD4p2MZcV1xyGfKJa/mcp

Claude Desktop

以下の手順で数秒で接続できます。

  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.
設定 · claude_desktop_config.jsonコピー
{
  "mcpServers": {
    "hygraph-headless-cms-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_E2kDf3rmUJJgcNZKXaOKQyqaD4p2MZcV1xyGfKJa/mcp"
    }
  }
}
チャットにコピー04

  • Hygraphスキーマ内で利用可能なすべてのコンテンツモデルをリストアップして。

  • 'Product'モデルのフィールドを教えて。どのようなクエリが可能か確認したいです。

  • 'Blog Post'モデルの全エントリについて、titleとslugを取得するGraphQLクエリを実行して。

  • コンテンツライブラリの中から、名前が'Summer Campaign'であるエントリのIDを見つけて。

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

ここから始める

Hygraphを接続して、すぐに質問を開始しましょう。

Hygraphの認証情報を入力するだけです。接続は安全に行われ、すぐにAIによるコンテンツの探索を開始できます。

HygraphをAIに接続する

FAQ

動作に関する詳細

  • 01

    AIがHygraph内のコンテンツを変更することはありますか？

    いいえ。このコネクターはスキーマとデータの読み取りおよび照会用に設計されています。コンテンツの作成、更新、削除を行うことはできません。

  • 02

    AIがGraphQLクエリを自ら作成するのですか？

    はい。スキーマを解析した後、リクエストされたデータを取得するために必要なクエリをAIが自動的に作成します。

  • 03

    指示を出せば、AIがモデルを削除することはありますか？

    いいえ。提供されるツールはスキーマの照会とデータの取得のみを許可しています。Hygraphの構造を変更する権限は持っていません。

  • 04

    AIはクエリでどのフィールドを使うべきか、どうやって判断するのですか？

    クエリを実行する前に、スキーマ照会ツールを使用して、モデル内にどのフィールドが存在するかを正確に確認します。

  • 05

    生のGraphQLレスポンスを確認することはできますか？

    はい。クエリ実行によって取得されたデータは、お使いのAIクライアント上に表示されます。

  • Hygraphについてさらに質問がありますか？ Hygraph Connectorの全機能を見る

『Hygraph』を Claude、Cursor、ChatGPT などに接続