Connecting Your Store

Before MageDrop can stage and deploy changes, you need to connect your Magento 2 store. The setup wizard will guide you through each step.

Step 1: Add your store

  1. Log in to your MageDrop dashboard.
  2. Navigate to Stores.
  3. Click Connect Store.
  4. Enter your store's details:
    • Store Name — a friendly label (e.g. "Production UK" or "Staging US").
    • Store URL — the full base URL of your Magento store, including the protocol (e.g. https://www.example.com). Do not include a trailing slash.
  5. Click Continue — you'll be taken to the setup wizard.

Step 2: Create a Magento REST API integration

The setup wizard will guide you through creating an Integration in Magento. This gives MageDrop permission to read and update your CMS content.

  1. In Magento Admin, go to System > Integrations > Add New Integration.
  2. On the Integration Info tab, set the Name to MageDrop.
  3. On the API tab, set Resource Access to Custom and enable:
ResourceWhy it's needed
Content > Elements > PagesRead and update CMS pages
Content > Elements > BlocksRead and update CMS blocks
  1. Click Save, then Activate on the integration row.
  2. A popup will show four OAuth credentials — copy all four into the setup wizard:
    • Consumer Key
    • Consumer Secret
    • Access Token
    • Access Token Secret

Tip: If you lose the credentials, go to System > Integrations, edit the integration, save, and click Reauthorize to generate new ones.

Step 3: Configure the Magento module

After saving the API token, the setup wizard will show you two values to enter in the Magento module config:

  1. In Magento Admin, go to Stores > Configuration > MageDrop > Connection.
  2. Set Enabled to Yes.
  3. Set Module Token to the value shown in the setup wizard.
  4. Click Save Config.

The Module Token authenticates the module so only your Magento instance can send data to your MageDrop account.

Verifying the connection

Once configured, click Test Connection in the MageDrop dashboard to verify that everything is working. You should see a green success message.

If the test fails, check the Troubleshooting page for common issues.

Development environments

If you're connecting a local development store, MageDrop won't be able to reach it directly. Use a tunnelling tool like ngrok to expose your local Magento instance:

ngrok http 443 --host-header=rewrite

Then use the ngrok HTTPS URL (e.g. https://abc123.ngrok.io) as your Store URL in the dashboard.

← Getting Started Installing the Module →