エンドポイント

https://suz-lab.co.jp/api/mcp

仕様

トランスポート

Streamable HTTP（MCP 標準）

認証

不要（誰でも叩ける公開エンドポイント）

権限

読み取り専用（データを書き換えるツールは無い）

データの出所

サイト本体と同一（content/*）。コンテンツ更新がそのまま応答に反映される

使えるツール

一覧系ツールは本文を返さず、URL と read_article へ誘導します。

• get_vmost({ step? })

  VMOST（Vision / Mission / Objectives / Strategy / Tactics ＋行動原則）。step で 1 階層に絞る

• get_roadmap({ group?, status? })

  次の一手。各 TODO の VMOST への紐づき（serves）・実施ログ逆リンク・全体の進捗を含む

• search_topics({ query?, tag? })

  解説トピック（常設の読み物）を検索

• search_logs({ query?, pillar?, tag? })

  実験ログ（時系列の一次情報）を新しい順に検索

• get_glossary()

  主要用語（VMOST の各階層・Roadmap・Log・MCP など）の一行定義と正規 URL。本文を読む前の語彙合わせに使う

• read_article({ type, slug })

  トピック／ログの本文（Markdown）を取得（type は "topic" か "log"）

対応クライアントでは、次の固定 URI を索引としてブラウズできます。

• suzlab://vmost
• suzlab://roadmap
• suzlab://topics
• suzlab://logs
• suzlab://glossary

設定例

MCP 対応クライアントへの登録は 2 通り。どちらも本番エンドポイントを指すだけです。

json{
  "mcpServers": {
    "suz-lab": {
      "type": "http",
      "url": "https://suz-lab.co.jp/api/mcp"
    }
  }
}

bashclaude mcp add --transport http suz-lab https://suz-lab.co.jp/api/mcp

bashnpx @modelcontextprotocol/inspector

使用例

全体像から本文まで、一覧 → 詳細の順に辿るのが基本の流れです。

1. 1

   get_vmost()

   理念（なぜ）から日々の行動（どう）までの全体像を掴む

2. 2

   get_roadmap({ status: "doing" })

   いま進行中の「次の一手」に絞る。各 TODO は実施結果ログへ逆リンクしている

3. 3

   search_logs({ query: "ショーケース" })

   その取り組みに関する実験ログを新しい順に探す

4. 4

   read_article({ type: "log", slug: "building-showcase-gallery" })

   見つけたログ「制作物ショーケースに AI 生成カバーのギャラリーを追加」の本文（Markdown）を読む

会話例

ツールをつないだ AI に問いかけると、一次情報だけを根拠に（例えば）こう答えます。