# Mollie setup for PopMCP Nothing is typed into PopMCP. You click Connect Mollie, sign in to Mollie and approve PopMCP, then choose a website profile if your organization has several. There is no developer app, callback URL or key to deal with. If you prefer not to sign in, an API key or advanced access token from Developers, API keys in Mollie can be used under More options instead. - Auth: OAuth authorization - Setup time: 1 min - API base URL: https://api.mollie.com/v2 - Credentials screen: https://my.mollie.com/dashboard/developers/api-access-tokens - Provider docs: https://docs.mollie.com/reference/authentication ## Before you begin - A Mollie account. Taking real payments needs Mollie's onboarding to be finished, and test data works before that - Your role in Mollie decides what a sign-in can do: you can only approve permissions your role already has - Pop-up blockers must allow the Mollie sign-in window to open - Only if the AI should create, refund or change anything: an owner or admin in PopMCP to allow write actions ## Get your credentials ### 1. Start the connection from PopMCP Open the Mollie connector in PopMCP and click Connect Mollie. There are no fields to fill in: no API key, no developer app and nothing to register. ### 2. Sign in to Mollie and approve The sign-in window opens on my.mollie.com. Sign in if you are not already, read the permissions PopMCP is asking for, and approve. You can only ever approve what your own role in Mollie allows. Your password stays with Mollie. ### 3. Choose a website profile Back in PopMCP, pick the website profile this connection should work on, and the workspace to put it in. Payments and customers belong to a profile, so each connection stays on the one you choose. If your organization has one profile, it is the only choice. ### 4. Prefer a key? Copy one from Mollie Only if you would rather not sign in, or want a connection that can only touch test data. In Mollie open Developers, then API keys, and create or copy a key. A live_ key reaches live data and a test_ key only test data; either reaches one website profile's payments, customers and subscriptions, but not balances, settlements, invoices or webhooks. For those, create an advanced access token on the same page (only Admins can) and tick its permissions. Mollie shows a secret once, so copy it right away, then paste it in PopMCP under More options and click Connect Mollie. Screen: https://my.mollie.com/dashboard/developers/api-access-tokens ### 5. Check the connection in PopMCP The Mollie card in PopMCP reads Connected, with the profile name. The everyday tools load at once, and the whole API is one search away. Refunds, charges and every other change wait until an owner or admin allows write actions in PopMCP. ## Fields PopMCP asks for - How you connect (connectionType): Click Connect Mollie, sign in and approve. If your organization has several website profiles, you choose which one next. Your Mollie password is never shared with us. - API key or access token (instead of signing in) (apiKey): Only if you prefer not to sign in. In Mollie go to Developers, API keys, and copy a key, or create an advanced access token. A test_ key only reaches test data. An API key reaches one profile's payments, but not balances, settlements, invoices or webhooks. Mollie shows a key once. Stored encrypted. ## Scopes requested - balance-reports.read - balance-transfers.read - balance-transfers.write - balances.read - business-account-draft-transfers.read - business-account-draft-transfers.write - business-account-payee-verifications.write - business-account-transfers.read - business-account-transfers.write - business-accounts.read - clients.read - clients.write - customers.read - customers.write - events.read - invoices.read - mandates.read - mandates.write - onboarding.read - onboarding.write - orders.read - orders.write - organizations.read - payment-links.read - payment-links.write - payments.read - payments.write - payouts.read - payouts.write - profiles.read - profiles.write - refunds.read - refunds.write - sales-invoices.read - sales-invoices.write - sessions.read - sessions.write - settlements.read - shipments.read - shipments.write - subscriptions.read - subscriptions.write - terminals.read - terminals.write - unmatched-credit-transfers.read - unmatched-credit-transfers.write - webhooks.read - webhooks.write ## Verify The Mollie card in PopMCP shows Connected with the website profile name. Asking the AI for the connection profile (`mollie_connection_profile`) says whether it is on live or test data, and asking who this connection is (`mollie_account_overview`) returns your organization and payment methods rather than an authorization error. ## Troubleshooting ### The sign-in window never opens Cause: A pop-up blocker is stopping the Mollie sign-in window. Fix: Allow pop-ups for PopMCP in your browser and click Connect Mollie again. ### "Mollie did not accept that key" Cause: The key was copied in part, or was removed in Mollie. Fix: Under Developers, API keys in Mollie, create a new key, since a secret is shown only once, and paste that. ### "An API key cannot use this tool" Cause: A live_ or test_ key reaches one website profile's payment data only, and this tool needs organization access, such as balances, settlements or webhooks. Fix: Reconnect Mollie by signing in, or paste an advanced access token with the permission the message names. ### "This connection is missing permission" Cause: The sign-in was not approved for it, your role in Mollie does not allow it, or an access token was made without it. Fix: Reconnect and approve it, ask an Admin to change your role, or create a token with that permission. mollie_list_permissions shows what the connection has. ### A payment the AI should find comes back as not found Cause: It is on the other side: test and live data never mix, and a key reaches only its own website profile. Fix: On a sign-in, ask for test data. With a key, connect the key for that mode and profile. ### "Your Mollie sign-in has ended" Cause: PopMCP's access was removed in Mollie, or the sign-in can no longer be renewed. Fix: Reconnect Mollie in PopMCP. It takes one click and a sign-in. --- Source: https://www.docs.popmcp.com/docs/integrations/mollie/