開発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 設定

Remote HTTP URLは次の固定URLを使います。スキルシートプロジェクトに固定する場合は、URL queryではなく X-PaPut-Project-Alias ヘッダーでaliasを指定します。

Claude Code

次のJSON設定を追加し、<alias> を置き換えます。

"paput": {
  "type": "http",
  "url": "https://mcp.paput.io/mcp",
  "headers": {
    "X-PaPut-Project-Alias": "<alias>"
  }
}

Codex

プロジェクトの .codex/config.toml に次を追加し、<alias> を置き換えます。

[mcp_servers.paput]
url = "https://mcp.paput.io/mcp"
http_headers = { "X-PaPut-Project-Alias" = "<alias>" }

Codexでは、環境変数で切り替える必要がある場合に env_http_headers も使えます。カスタムヘッダーを設定できないクライアントはPaPutへ接続できますが、プロジェクトには固定できません。

setup-ai

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

npx -y paput-mcp setup-ai

このコマンドは、AIクライアントによる過去ローカルセッションからの知見収穫、知見候補の抽出、保存確認に使うスキルと、作業完了時に再利用可能な知見を検出して 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-harvest: ローカルファイルを読めるAIクライアントで、未処理のローカルセッションを確認し、再利用可能な知見候補を作る
• /paput-capture: 現在の会話や指定トピックから知見候補を手動で pending に追加
• /paput-save: pending 候補を確認し、明示承認したものだけ PaPut に保存

推奨ワークフロー

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

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

注意事項

• PaPut MCP自体はローカルファイルを読み取りません
• 過去セッション取り込みは、AIクライアント自身のローカルファイルアクセスに依存します
• API key は不要で、OAuth を使います
• 生成されたskillは ~/.paput 配下に保存されます
• Claude Code や Codex 側で MCP 設定を変更した場合は、再起動または再読み込みが必要な場合があります