AIエージェント向けクイックスタート — llms.txtとMCP

概要

Findy Libraryは、人間だけでなくAIエージェントが直接読むことを前提に公開しています。すべてのページはプレーンなMarkdownとして取得でき、サイト全体がエージェント向けにインデックス化されています。本ページでは、エージェントが用いる3つのアクセス経路を説明します。

llms.txtは全ページを短い説明付きで列挙するインデックスで、エージェントは何を読むかを事前に判断できます。llms-full.txtはサイト全体を1ファイルにまとめたものです。

curl https://lib.findy.co.jp/llms.txt        # 全ページのインデックス
curl https://lib.findy.co.jp/llms-full.txt   # サイト全体を 1 ファイルに

任意のページパスに.mdを付けると、生のMarkdownが得られます。返るのは人間が見るのと同じ内容で、HTMLを解析する必要はありません。

curl https://lib.findy.co.jp/development/pull-request.md

Findy Libraryは検索MCPサーバーをhttps://lib.findy.co.jp/mcpで公開しており、MCP対応エージェントはページを1つずつ取得する代わりにドキュメントを直接検索できます。認証は不要です。利用するMCPクライアントにサーバーを登録します。

claude mcp add --transport http findy-library https://lib.findy.co.jp/mcp

{
  "mcpServers": {
    "findy-library": {
      "url": "https://lib.findy.co.jp/mcp"
    }
  }
}

{
  "servers": {
    "findy-library": {
      "type": "http",
      "url": "https://lib.findy.co.jp/mcp"
    }
  }
}

接続後は質問を投げるだけで、エージェントがsearchツールを通じて質問に最も関連する箇所を取得します。

手順3の検索サーバーが何の上に成り立っているか、エージェントが外部のツールへ接続する仕組みを扱います。

アクセス経路を整えたあと、最初に読む（またはMarkdownで取得する）ページとして適しています。

このライブラリを読めるようになったAIコーディングエージェントと、日々どう進めるかを扱います。