開発AIエージェントで PaPut MCP を使う
このページでは、Claude Code や Codex でコーディング中に得られた知見を PaPut に残すための手順を紹介します。
PaPut MCP toolsはAPI-backedです。ローカルのClaude / Codexセッションを確認したい場合は、paput-harvest skillの手順に沿ってAIクライアント自身がファイルを読み、抽出した候補だけをPaPut MCPへ送ります。
Claude Code / Codex はプラグインでの導入が最も簡単です。このページでは手動セットアップ（MCP設定 + setup-ai）の手順を説明します。
事前準備
- Node.js / npx が使えること
- PaPut アカウントがあること
- Claude Code または Codex が利用できること
OAuth login
Remote HTTP ModeではMCPクライアント側のOAuth flowを使います。Remote HTTP URLを設定し、クライアントに認証画面が表示されたらPaPutへログインして連携を許可してください。
MCP 設定例
Claude Code や Codex などの MCP 設定に Remote HTTP MCP を追加します。
ツール呼び出しを特定のスキルシートプロジェクトに固定したい場合は、PaPutでproject aliasを設定し、https://mcp.paput.io/mcp?project_alias=<alias> を使います。
setup-ai
Claude / Codex 向けに PaPut skills とグローバルルールを追加します。
このコマンドは、AIクライアントによる過去ローカルセッションからの知見収穫、知見候補の抽出、保存確認に使うスキルと、作業完了時に再利用可能な知見を検出して pending に追加するための利用ルールを追加します。
既存設定を更新したい場合は、--force を付けます。
Claude のみを対象にする場合は、--claude-only を付けます。
自動で pending に追加される流れ
setup-ai 後は、Claude Code や Codex のグローバルルールに PaPut の知見候補抽出ルールが追記されます。
そのため、作業が完了したとき、問題が解決したとき、設計判断が固まったときなどに、AI が再利用可能な技術知識を検出し、重複・機密・プロジェクト固有性を確認したうえで pending 候補へ追加します。
通常は /paput-capture を毎回手動で実行する必要はありません。
特定の会話やトピックを明示的に取り込みたい場合だけ、補助的に /paput-capture を使います。
使えるスキル例
-
/paput-harvest: ローカルファイルを読めるAIクライアントで、未処理のローカルセッションを確認し、再利用可能な知見候補を作る -
/paput-capture: 現在の会話や指定トピックから知見候補を手動で pending に追加 -
/paput-save: pending 候補を確認し、明示承認したものだけ PaPut に保存
推奨ワークフロー
- 作業中に有用な知見が生まれた場合、基本的には自動で pending に追加されます
- 保存前に
/paput-saveで候補を確認し、重複やプロジェクト固有情報を除外できます - 特定の内容を明示的に候補化したい場合だけ
/paput-captureを使います
注意事項
- PaPut MCP自体はローカルファイルを読み取りません
- 過去セッション取り込みは、AIクライアント自身のローカルファイルアクセスに依存します
- API key は不要で、OAuth を使います
- 生成されたskillは
~/.paput配下に保存されます - Claude Code や Codex 側で MCP 設定を変更した場合は、再起動または再読み込みが必要な場合があります