接続と道具の使い方
MCP接続先は https://mcp.headlesson.com/mcp 。Streamable HTTPのJSON応答を使い、SSEと購読は提供しません。新しいstateless MCPと従来の初期化手順の互換経路を分けて扱います。ネイティブClaudeでの登録・会話確認は未実施です。
ローカル開発の接続先: http://127.0.0.1:8787/mcp
探す・比べる
headlesson_search の例: {"query":"scheduling posts","axes":["auth","pricing","remote_mcp"]}
whereは軸間AND、値の配列内ORです。unknownは確認済み条件に一致しません。既知の別名 licence / local_mcp_server / remote_mcp_server は正規化します。並び替えは {"axis":"last_release","order":"desc"}。unknownは最後です。query / ids / whereの実質的な指定がない場合は使い方案内エラーになります。
取得する
headlesson_get の例: {"id":"app:postiz","sections":["lesson","gotchas","axes"]}
sections省略時は説明、入口、主要6軸です。axes指定で全17軸、relationsで関係、changesで変更を返します。ID axes は定義一覧、search-guide は検索規則、feature:since-2025 は最初の特集です。手順のtested:falseは実行済みを意味しません。
変更・feedback
headlesson_whats_new の例: {"since":"2025-01-01","about":"proto:mcp"}。日付は変化の日で、省略時は直近90日です。
headlesson_feedback の例: {"text":"The lesson needs a clearer owner-login prerequisite.","kind":"comment","about":"app:postiz"}。本文は運営者へ送られ保存されます。個人情報・会話本文・秘密を含めないでください。受領は検証・採用・公開を意味しません。
連絡先
LLMからはMCPの headlesson_feedback で運営者へ連絡できます。人間向けの公式・公開窓口は Threads @head.lesson です。プライバシーの問い合わせ先と未開通の状態は プライバシーポリシー に記載しています。
出典
公開URLは保持します。公開で確認できない原典は operator-provided; not publicly verifiable、編集判断は headlesson editorial judgement と表示し、確認日・確かさ・作成者と値の位置を保持します。運営観察のoperator_ownとlesson.testedは出典既定を継承しません。
比較軸
主要軸は auth / pricing / license / cli / local_mcp / remote_mcp。各値の確認日と根拠も確認してください。
- license: SPDX identifier or proprietary
- open_source: Source code published under an open source license
- pricing: Main pricing model
- has_human_gui: Role of the human GUI
- non_interactive: All operations without interactive prompts
- machine_output: Machine readable output, such as JSON
- local_mcp: Local stdio MCP interface
- remote_mcp: Remote MCP interface
- cli: Command line interface
- rest_api: REST API interface
- auth: Authentication needed to start
- self_hostable: Can run on your own infrastructure
- embeds_llm: LLM inside the app or delegated to user AI
- refusal_contract: Documented refusal or approval contract
- audit_log: Records actions performed
- last_release: Most recent published release date
- ja_support: Japanese UI, documentation or support