Install PaPut via Plugin

PaPut is distributed as a plugin for Claude and Codex. Installing the plugin sets up the PaPut connection (remote MCP connector) and the PaPut skills in one step.

Supported clients

• Claude Code
• claude.ai (web) / Claude Desktop / Claude Cowork (paid Claude plans only)
• Codex (App / CLI / VS Code extension)

ChatGPT itself does not support plugins; connect it with a connector (URL setup) as before.

Install

Claude Code

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

claude.ai / Claude Desktop / Cowork

Open Customize > Plugins in the sidebar, add https://github.com/mizulba-dev/paput-mcp as a marketplace, and install PaPut.

Codex

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

In every client, the OAuth authorization screen appears on first tool use. Log in to PaPut and allow the connection.

Invoking skills

Plugin skills live under the paput namespace (e.g. /paput:capture, /paput:save). They are the same skills as paput-capture and friends installed via the CLI (setup-ai).

Pinning a project (project alias)

• Claude Code: the plugin resolves the alias from your working directory. List projects in ~/.paput/projects, one per line, as the alias, whitespace, then the absolute path.

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

Paths match exactly or as a parent directory, and the longest match wins. A monorepo subdirectory inherits its parent's alias unless you register it separately. A line with only an alias is the fallback for directories that match nothing. Edit the file by hand, or run npx -y paput-mcp set-project-alias <alias> inside the repository. Set PAPUT_PROJECT_ALIAS to override it for one session.

• Codex: the bundled connection does not take an alias. To pin a project, add this to that project's .codex/config.toml, replacing <alias>.

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

The URL must remain https://mcp.paput.io/mcp; do not put the alias in a URL query. A manually configured server named paput takes precedence over the plugin-bundled connection, so there is no duplicate connection.

ChatGPT and a Claude connector that cannot set custom headers can connect without a project context, but cannot pin a project alias.

Already connected via a connector?

• Claude: the plugin-bundled connection registers separately as plugin:paput:paput. Authenticating both shows every tool twice, so we recommend keeping only one.
• Codex: your manually configured paput server wins and the bundled one is skipped automatically.

Migrating from the CLI (setup-ai)

Remove the CLI-installed skills and keep only the usage rules up to date. The skills are then provided by the plugin.

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