Quickstart
One URL, one browser approval. The connector URL is the same everywhere:
https://api.peak-pim.com/mcp
You need a Peak PIM account with at least one linked store. The Peak PIM account you're signed in to in the browser during authorization is the account the assistant will see.
Claude (web & desktop)
- Open Settings → Connectors (or ask your Claude admin for organization-level connectors).
- Choose Add custom connector and paste the connector URL.
- Click Connect — a Peak PIM window opens. Sign in, pick a permission tier (start with Read), and approve.
- In a chat, enable the Peak PIM connector from the tools menu and try a prompt below.
See also Anthropic's guide to custom connectors using remote MCP.
Claude Code
claude mcp add --transport http peak-pim https://api.peak-pim.com/mcp
Then run /mcp inside Claude Code to authenticate — your browser opens
the same consent page. Tools appear as mcp__peak-pim__*.
ChatGPT
- Enable Developer mode (Settings → Apps & Connectors → Advanced) — see OpenAI's developer mode & MCP guide.
- Create a new connector with the connector URL; authentication is OAuth (discovered automatically).
- Approve in the Peak PIM window, then enable the connector in a conversation.
Cursor and other MCP clients
Any client that supports remote MCP servers with OAuth works. For JSON-configured clients:
{
"mcpServers": {
"peak-pim": {
"url": "https://api.peak-pim.com/mcp"
}
}
}
The client discovers the OAuth endpoints via the standard well-known metadata, registers itself dynamically, and sends you to the browser consent page on first use. No pre-shared client id or API key is needed.
Verify the connection
Ask your assistant:
- "List my products in Peak PIM and show me which ones have unpublished changes."
- "Show me the details of product <name> on each of my stores — where do the titles differ?"
- "Find every variant missing a SKU."
With the write or publish tiers (re-authorize to upgrade):
- "Update the SEO title of product <name> to <value> as a draft." (read & write)
- "Publish product <name> to all my stores and tell me exactly what succeeded and what failed." (read, write & publish)
Changing a connection's permissions
A connection's tier is fixed when you approve it. To upgrade or downgrade, disconnect the client in Settings → AI assistants (MCP) in Peak PIM (or remove the connector in the client), then reconnect and pick the new tier at the consent screen.
Troubleshooting
| Symptom | Likely cause & fix |
|---|---|
| Authorization window shows a sign-in form | You weren't signed in to Peak PIM in that browser. Sign in, then approve — the connection binds to that account. |
| A tool fails with a permission error | The tool needs a scope outside the tier you approved. Reconnect and choose a higher tier. |
| Everything fails with 401 after working fine | The connection was revoked or its tokens expired without refresh. Re-authorize from the client. |
| Writes fail with a 423 "locked" error | A store import/refresh is being reconciled in Peak PIM. Finish (or resolve) the reconciliation in the app, then retry. |
| Publish call timed out | Publishes can take a while — the server-side publish may still have completed. Ask the assistant to re-read the item and check its publish state. |