プラグインで PaPut を導入する

PaPut は Claude / Codex のプラグインとして配布しています。プラグインを入れると、PaPut への接続（remote MCP connector）と PaPut skills がワンステップで揃います。

対応クライアント

• Claude Code
• claude.ai（web）/ Claude Desktop / Claude Cowork（Claudeの有料プランのみ）
• Codex（App / CLI / VS Code 拡張）

ChatGPT 本体はプラグイン非対応のため、従来どおり connector（URL設定）で接続します。

インストール

Claude Code

/plugin marketplace add mizulba-dev/paput-mcp
/plugin install paput@paput

claude.ai / Claude Desktop / Cowork

サイドバーの Customize > Plugins から、マーケットプレイスとして https://github.com/mizulba-dev/paput-mcp を追加し、PaPut をインストールします。

Codex

codex plugin marketplace add mizulba-dev/paput-mcp
codex plugin add paput@paput

いずれも初回ツール利用時に OAuth 認証画面が表示されるので、PaPut にログインして連携を許可してください。

スキルの呼び出し

プラグインのスキルは paput 名前空間で呼び出します（例: /paput:capture、/paput:save）。CLI（setup-ai）で導入した場合の paput-capture などと同じ内容です。

プロジェクト固定（project alias）

• Claude Code: プラグインは作業ディレクトリからaliasを解決します。~/.paput/projects に、alias・空白・絶対パスの順で1行ずつ書きます。

# alias        path
paput          /Users/you/repos/paput
gaikodb        /Users/you/repos/gaiko-db
mydefault

パスは完全一致または親ディレクトリとして一致し、最長一致が優先されます。モノレポのサブディレクトリは、個別に登録しない限り親のaliasを引き継ぎます。aliasだけの行は、どのパスにも一致しなかったときの既定値です。手で書いてもよいですが、対象リポジトリ内で npx -y paput-mcp set-project-alias <alias> を実行しても登録できます。PAPUT_PROJECT_ALIAS で1セッションだけ上書きできます。

• Codex: プラグイン同梱の接続はalias指定に対応していません。プロジェクトに固定する場合は、そのプロジェクトの .codex/config.toml に次を追加し、<alias> を置き換えます。

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

URLは https://mcp.paput.io/mcp のままにし、aliasをURL queryへ入れないでください。同名 paput の手動設定があるとプラグイン側の接続は自動的に無効になるため、二重接続にはなりません。

ChatGPT と、カスタムヘッダーを設定できない claude.ai connector はプロジェクト固定なしで接続できますが、project aliasには固定できません。

すでに connector で接続している場合

• Claude 系: プラグイン同梱の接続は別サーバー（plugin:paput:paput）として共存します。両方を認証すると同じツールが2セット表示されるため、どちらか一方に寄せることをおすすめします。
• Codex: 同名 paput の手動設定が優先され、プラグイン側は自動的にスキップされます。

CLI（setup-ai）からの移行

CLI で導入したスキルを削除し、利用ルールだけ最新に保ちます。スキルはプラグイン側から提供されます。

npx -y paput-mcp setup-ai --remove-skills
npx -y paput-mcp setup-ai --rules-only --force