What you need

• A PinBridge account — create one for free
• Claude Desktop or Codex installed
• A Pinterest account connected to your PinBridge workspace

Step 1 — Get your API key

Log into the PinBridge dashboard and navigate to API Keys. Create a new key and copy it.

Your key will look like this:

pb_4d4981104a0a0e415ae6ca800ede4449b71146db53404544807d301e92379d0c

Keep it private — anyone with this key can publish to your connected Pinterest accounts.

Step 2 — Connect a Pinterest account

If you haven't already, go to Pinterest Accounts in the PinBridge dashboard and connect your Pinterest account via OAuth. This takes about 30 seconds and only needs to be done once.

Your AI assistant will only be able to publish to Pinterest accounts connected to your workspace.

Step 3 — Configure your AI assistant

Claude Desktop

1. Open Claude Desktop and go to Settings → Developer.
2. Click Edit Config to open the MCP configuration file.
3. Add the following block inside the mcpServers object:

{
  "mcpServers": {
    "pinbridge": {
      "url": "https://mcp.pinbridge.io",
      "headers": {
        "Authorization": "Bearer pb_your_api_key"
      }
    }
  }
}

4. Replace pb_your_api_key with your actual PinBridge API key.
5. Save the file and restart Claude Desktop.

Once restarted, you'll see a hammer (🔨) icon in the input bar — that means MCP tools are active.

Codex

1. Open Codex and go to Settings → MCP Servers.
2. Click Add Server and fill in:

3. Replace pb_your_api_key with your actual key.
4. Save and restart Codex.

PinBridge tools will appear in the agent's tool list in your next session.

Step 4 — Verify the connection

Open a new conversation and ask your AI assistant:

"List my Pinterest accounts"

If everything is working, it will return your connected account details. If you see an error, check that:

• The API key is correct and has no extra spaces
• The client was fully restarted after saving the config
• Your Pinterest account is connected in the PinBridge dashboard

Step 5 — Publish your first pin

Try this in a new conversation:

"Publish a pin to my [board name] board with the title 'My first AI pin' and this image: https://images.unsplash.com/photo-1506905925346-21bda4d32df4?w=800"

Your assistant will call the create_pin tool, PinBridge will queue the publish, and the pin will appear on Pinterest within seconds.

What your AI assistant can do

Once connected, your AI assistant has access to:

• Publish pins — immediately or at a scheduled time
• List and create boards — browse and manage your Pinterest boards
• Schedule content — queue pins for future delivery with a specific date and time
• Check status — see what's been published, scheduled, or failed
• Browse pins — list and inspect existing pins in your workspace

Write tools (create, schedule, delete) are enabled by default. If they are unavailable, check that your PinBridge plan includes write access.

Troubleshooting

Tools not showing up Restart the client fully after saving the config. Some clients require a complete quit and reopen.

Authentication error Double-check the API key — copy it fresh from the dashboard to avoid hidden characters.

"No Pinterest accounts found" Connect a Pinterest account from the PinBridge dashboard first. The MCP server only sees accounts linked to your workspace.

"Quota exceeded" Your plan's weekly MCP request limit has been reached. Upgrade your plan or wait for the quota to reset on Monday.

Next steps

• MCP Overview — learn more about what PinBridge exposes
• MCP Usage Policy — Pinterest's guidelines for AI-assisted publishing
• Pricing — weekly request limits per plan