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. It provides the same features as configuring the MCP URL manually.

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: you can set a Project alias when enabling the plugin (leave it empty to connect without a project). To use a different alias in a specific project, add the following to that project's .claude/settings.local.json.

{
  "pluginConfigs": {
    "paput@paput": {
      "options": { "project_alias": "<alias>" }
    }
  }
}

• Codex: the bundled connection does not take an alias. To use one, configure the server manually with codex mcp add paput --url "https://mcp.paput.io/mcp?project_alias=<alias>". When a manually configured server named paput exists, the plugin-bundled connection steps aside automatically, so there is no duplicate connection.

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