概要
Snipphy MCP Tool は10個のツールで構成されており、記事・モジュールの作成から取得・更新・並び替えまで一通りの操作をチャットから行える。
ツール一覧
| ツール名 | カテゴリ | 概要 |
|---|---|---|
get_markdown_format_guide | ガイド | Snipphy 推奨の Markdown 構成を取得 |
create_module | モジュール | 新規モジュールを作成 |
list_my_modules | モジュール | 自分のモジュール一覧を取得 |
get_module_logic_tree | モジュール | モジュールの構造・記事一覧を取得 |
attach_article_to_module | モジュール | 既存記事をモジュールに追加 |
reorder_module_articles | モジュール | モジュール内の記事順を変更 |
create_markdown_article | 記事 | 新規記事を作成 |
list_my_articles | 記事 | 自分の記事一覧を取得 |
get_article_markdown | 記事 | 記事の Markdown 本文を取得 |
update_markdown_article | 記事 | 記事のタイトル・本文・タグ・ステータスを更新 |
記事系ツール
create_markdown_article — 記事の作成
Markdown 本文を渡すと Snipphy に記事を新規投稿する。
| パラメータ | 必須 | 説明 |
|---|---|---|
title | ✅ | 記事タイトル |
markdown | ✅ | Markdown 形式の本文 |
module_slug | — | 紐付けるモジュールのスラッグ |
status | — | draft（デフォルト）/ private / published |
tags | — | タグ名の配列 |
research_question | — | 記事が答える問い |
research_key_message | — | 記事レベルのキーメッセージ |
list_my_articles — 記事一覧の取得
自分の記事を検索・一覧表示する。記事の slug や ID を調べるときに使う。
| パラメータ | 必須 | 説明 |
|---|---|---|
query | — | タイトルの部分一致検索 |
status | — | all（デフォルト）/ draft / private / published |
tag | — | タグ名で絞り込み |
limit | — | 取得件数（デフォルト20、最大100） |
get_article_markdown — 記事本文の取得
記事の Markdown 本文をそのまま取得する。編集前に現在の内容を確認するときに使う。
| パラメータ | 必須 | 説明 |
|---|---|---|
article_id | ✅ * | 記事 ID（article_slug とどちらか必須） |
article_slug | ✅ * | 記事スラッグ（article_id とどちらか必須） |
update_markdown_article — 記事の更新
既存記事のタイトル・本文・タグ・ステータスを上書き更新する。編集前に get_article_markdown で現在の内容を確認してから使うのが推奨。
| パラメータ | 必須 | 説明 |
|---|---|---|
article_id | ✅ * | 記事 ID（slug とどちらか必須） |
slug | ✅ * | 記事スラッグ（article_id とどちらか必須） |
title | — | 新しいタイトル |
markdown | — | 新しい Markdown 本文（全体置換） |
tags | — | 新しいタグ一覧（全体置換） |
status | — | draft / private / published |
⚠️
markdownは全体置換のため、部分編集したい場合は先にget_article_markdownで本文を取得してから渡すこと。
モジュール系ツール
create_module — モジュールの作成
複数記事をまとめるモジュール（章・カテゴリ）を新規作成する。
| パラメータ | 必須 | 説明 |
|---|---|---|
title | ✅ | モジュールタイトル |
description | — | 短い説明文 |
icon | — | アイコンキー（デフォルト: document） |
作成後に返される slug を create_markdown_article や attach_article_to_module で使う。
list_my_modules — モジュール一覧の取得
自分のモジュール一覧を取得する。モジュールの slug を調べるときに使う。
パラメータなし。
get_module_logic_tree — モジュール構造の取得
モジュールに含まれる記事の順序・構造を確認する。記事を追加・並び替える前の確認に使う。
| パラメータ | 必須 | 説明 |
|---|---|---|
module_slug | ✅ | モジュールのスラッグ |
include_markdown | — | 各記事の本文も含めるか（デフォルト: false） |
attach_article_to_module — 既存記事をモジュールに追加
すでに存在する記事を、指定したモジュールに紐付ける。
| パラメータ | 必須 | 説明 |
|---|---|---|
module_slug | ✅ | 追加先モジュールのスラッグ |
article_id | ✅ * | 記事 ID（article_slug とどちらか必須） |
article_slug | ✅ * | 記事スラッグ（article_id とどちらか必須） |
position | — | 挿入位置（0始まり）。省略時は末尾に追加 |
reorder_module_articles — モジュール内の記事順を変更
モジュール内の記事を指定した順序に並び替える。
| パラメータ | 必須 | 説明 |
|---|---|---|
module_slug | ✅ | モジュールのスラッグ |
article_ids | ✅ | 並び替え後の順序で記事 ID を配列で指定 |
指定しなかった記事 ID は、指定した記事の後ろに残る。
ガイド系ツール
get_markdown_format_guide — Markdown フォーマットガイドの取得
Snipphy 推奨の Markdown 構成・ロジックツリーの書き方を取得する。
パラメータなし。記事を書く前に Claude が自動で参照することが多い。
ユースケース別ワークフロー
新規記事をモジュールに追加する
1. list_my_modules でモジュールの slug を確認
2. create_markdown_article に module_slug を指定して記事を作成
既存記事をモジュールに後から追加する
1. list_my_articles で記事の slug/ID を確認
2. list_my_modules でモジュールの slug を確認
3. attach_article_to_module で紐付け
既存記事を編集する
1. list_my_articles で記事の slug/ID を確認
2. get_article_markdown で現在の本文を取得
3. update_markdown_article で更新
モジュール内の記事順を整理する
1. get_module_logic_tree で現在の記事順・ID を確認
2. reorder_module_articles に希望の順序で article_ids を渡す