開発AIエージェントで PaPut MCP を使う

このページでは、Claude Code や Codex でコーディング中に得られた知見を PaPut に残すための Local CLI Mode の手順を紹介します。

session scan、pending knowledge candidates、local cache を使う場合は、Remote MCP ではなく Local CLI Mode を使います。 Remote MCP はメモ、ノート、スキルシートなどの通常操作向けで、ローカルセッションの読み取りや pending cache 系のツールは提供しません。

事前準備

Node.js / npx が使えること
PaPut アカウントがあること
Claude Code または Codex が利用できること

OAuth login

まず、Local CLI Mode で使う OAuth トークンを取得します。

npx -y paput-mcp login

ブラウザで PaPut にログインし、連携を許可する
token は ~/.paput/oauth.json に保存される
ログアウトする場合は以下を実行する

npx -y paput-mcp logout

MCP 設定例

Claude Code または Codex の MCP 設定に以下を追加します。

"paput": {
  "command": "npx",
  "args": ["-y", "paput-mcp"],
  "env": {
    "PAPUT_PROJECT_MATCH": "任意のプロジェクト名の一部"
  }
}

PAPUT_PROJECT_MATCH は任意
設定すると、メモ作成・更新時に一致するスキルシートプロジェクトへ自動紐付けできます

setup-ai

Claude / Codex 向けに PaPut skills とグローバルルールを追加します。

npx -y paput-mcp setup-ai

このコマンドは、PaPut の初期化、同期、知見候補の抽出、保存確認に使うスキルと、作業完了時に再利用可能な知見を検出して pending に追加するための利用ルールを追加します。

既存設定を更新したい場合は、--force を付けます。

npx -y paput-mcp setup-ai --force

Claude のみを対象にする場合は、--claude-only を付けます。

npx -y paput-mcp setup-ai --claude-only

自動で pending に追加される流れ

setup-ai 後は、Claude Code や Codex のグローバルルールに PaPut の知見候補抽出ルールが追記されます。そのため、作業が完了したとき、問題が解決したとき、設計判断が固まったときなどに、AI が再利用可能な技術知識を検出し、重複・機密・プロジェクト固有性を確認したうえで pending 候補へ追加します。

通常は /paput-capture を毎回手動で実行する必要はありません。特定の会話やトピックを明示的に取り込みたい場合だけ、補助的に /paput-capture を使います。

使えるスキル例

/paput-init: 初期化、既存メモ同期、未処理セッション確認
/paput-sync: 既存 PaPut メモをローカルキャッシュへ同期
/paput-capture: 現在の会話や指定トピックから知見候補を手動で pending に追加
/paput-save: pending 候補を確認し、明示承認したものだけ PaPut に保存

推奨ワークフロー

/paput-init
作業する
必要に応じて /paput-save

作業中に有用な知見が生まれた場合、基本的には自動で pending に追加されます
保存前に /paput-save で候補を確認し、重複やプロジェクト固有情報を除外できます
特定の内容を明示的に候補化したい場合だけ /paput-capture を使います
スキルシートのプロジェクト要約を作成する場合は、MCPでプロジェクトのAI要約を作成するも確認してください

注意事項

Remote HTTP Mode では local session scan、pending cache、transcript 読み取りは使えません
API key は不要で、OAuth を使います
local token と cache は ~/.paput 配下に保存されます
Claude Code や Codex 側で MCP 設定を変更した場合は、再起動または再読み込みが必要な場合があります