The plugin bundles its own MCP configuration, so it sets up the Postman MCP Server for you automatically.

1. Clone the plugin repo:

   Copy

   git clone https://github.com/Postman-Devrel/postman-claude-code-plugin.git

2. Start Claude Code with the plugin loaded, from your API project directory:

   Copy

   cd your-api-project/
   claude --plugin-dir /path/to/postman-claude-code-plugin

Requires Claude Code v1.0.33+. No Python, Node, or other runtime dependencies needed for the plugin itself.

Setup is what authenticates the plugin with your Postman account and confirms the connection is live before you start issuing natural-language commands.

1. In Claude Code, run:

   Copy

   /postman:setup

2. Authenticate when prompted:

   • OAuth (recommended) — opens a browser sign-in, no key copying required.
   • API key — set export POSTMAN_API_KEY=PMAK-your-key-here (add it to ~/.zshrc or ~/.bashrc to persist it). Get one at go.postman.co/settings/me/api-keys.

3. The plugin verifies your connection and lists your workspaces — confirm your [Your Name] - AI Basics workspace from Getting Started with Agent Mode appears in the list.