MCP
MCP Setup Guide
Step-by-step instructions to connect the PinBridge MCP server to Claude Desktop and Codex.
Overview
The PinBridge MCP server runs at https://mcp.pinbridge.io. Connect it to Claude Desktop or Codex by adding a short configuration block with your PinBridge API key. Once connected, your AI assistant can publish, schedule, and manage Pinterest pins through natural conversation.
What You Will Learn
- How to get a PinBridge API key.
- How to add PinBridge to Claude Desktop's MCP configuration.
- How to add PinBridge to Codex's MCP configuration.
- How to verify the connection is working.
Implementation Checklist
- Create a PinBridge account and generate an API key from the dashboard.
- Copy the MCP server URL: https://mcp.pinbridge.io
- Add the configuration block to your Claude Desktop or Codex settings file.
- Restart the client and verify PinBridge tools appear in the assistant's tool list.
- Connect a Pinterest account from the PinBridge dashboard if not already done.
Important Resources
Official package and source links for direct installation and version tracking.
Deep Dive
Step 1 — Get your API key
Sign up at pinbridge.io and open the dashboard. Navigate to API Keys and create a new key. Copy it — it starts with pb_ and will be used in both setup guides below.
- Free plan includes 100 MCP requests per week — enough to get started.
- Keep the key private. Anyone with it can publish pins to your connected Pinterest accounts.
- Revoke and regenerate keys from the dashboard at any time.
Step 2a — Claude Desktop setup
Claude Desktop supports MCP servers via a JSON configuration file. Open the Claude Desktop settings, navigate to the "Developer" tab, and click "Edit Config". Add the following block inside the mcpServers object:
- { "mcpServers": { "pinbridge": { "url": "https://mcp.pinbridge.io", "headers": { "Authorization": "Bearer pb_your_api_key" } } } }
- Replace pb_your_api_key with your actual PinBridge API key.
- Save the file and restart Claude Desktop.
- Open a new conversation. Claude will show a hammer icon in the input bar indicating MCP tools are available.
- Type "list my Pinterest accounts" to verify the connection.
Step 2b — Codex setup
Codex supports MCP servers through its settings panel. Open Codex, go to Settings → MCP Servers, and add a new server entry with the following values:
- Name: PinBridge
- URL: https://mcp.pinbridge.io
- Header — Authorization: Bearer pb_your_api_key (replace with your actual key)
- Save and restart Codex. PinBridge tools will appear in the agent's available tool list.
- Open a new session and ask the agent to list your Pinterest boards to confirm the connection.
Step 3 — Verify and start publishing
Once connected, your AI assistant has access to all PinBridge tools. A good first command is to ask it to list your connected Pinterest accounts or boards. From there you can publish pins, schedule content, or manage boards — all through conversation.
- Try: "List my Pinterest boards" to confirm read access.
- Try: "Publish a pin to my [board name] board with title X and this image URL" to test write access.
- If tools are not showing, restart the client and check that the API key has no extra spaces.
- Pinterest account must be connected from the PinBridge dashboard before the AI can publish.