For the complete documentation index, see llms.txt. This page is also available as Markdown.

Ask AI about your surveys

Ask Shopify Sidekick, ChatGPT, Claude, or Gemini questions about your survey answers.

Ask questions about your surveys in everyday words, such as:

  • "What did customers complain about most this month?"

  • "How did people hear about us last week?"

  • "Which products get the lowest ratings?"

Shopify Sidekick

Nothing to set up. Open Sidekick in your Shopify admin and ask about your surveys.

Sidekick panel answering What did customers complain about most this month with delivery speed as the top complaint from 29 completed survey responses
Sidekick reads your survey answers and tells you what customers mention most.

ChatGPT, Claude, or Gemini

  1. Go to Settings → AI assistants and select Allow access.

  2. Select Copy next to Server URL, and next to Access key. Keep the key somewhere safe — it's only shown once, and you need it to approve each assistant.

  3. Follow the steps for your assistant below.

AI assistants section of Settings with Allow access turned on, the Server URL with a Copy link, and the Access key shown masked
Turn on Allow access (1), copy the Server URL (2), and keep your Access key (3) for approving each assistant.

Every assistant connects the same way: you paste the Server URL, an Askly page opens, you paste your access key there and select Allow.

Claude

Works on Claude.ai and Claude Desktop, on every plan. The Free plan allows one custom connector.

  1. In Claude, open Customize, then Connectors.

  2. Select +, then Add custom connector.

  3. Give it a name, such as Askly, and paste the Server URL.

    Claude Add custom connector modal showing the Server URL field (1), Sign in now (2), and Use Claude's published identity (3)
    Paste your Server URL (1), choose Sign in now (2), and select Use Claude's published identity (3).
  4. Under Authentication, keep Sign in now. Under OAuth client, choose Use Claude's published identity.

  5. Select Add. On the Askly page that opens, paste your access key and select Allow.

    The Askly approval page showing the access key field with demo key and the Allow button
    Paste your access key into the field (1) and select Allow (2) to connect the assistant.
  6. To use it in a chat, select +, then Connectors, and turn Askly on.

On Team and Enterprise plans, only an Owner can add the connector, in Organization settings → Connectors → Add → Custom → Web. Each member then opens Customize → Connectors, selects Connect next to Askly, and approves it with the access key.

ChatGPT

  1. In ChatGPT, open Settings → Plugins (or Integrations).

  2. Select Add → Add MCP server.

  3. Under Name, enter Askly Customer Surveys. Under Type, choose Streamable HTTP.

  4. Paste your Server URL under URL, then select Save.

    ChatGPT Connect to a custom MCP screen showing Type set to Streamable HTTP (1), the URL field (2), and the Save button (3)
    Choose Streamable HTTP (1), paste your Server URL (2), and select Save (3) to register the MCP server.
  5. In the servers list, select Authenticate next to Askly. On the page that opens, paste your access key and select Allow.

  6. In any chat, mention or choose Askly from your tools to ask questions about your survey data.

Gemini

  1. In the Gemini app or at gemini.google.com, open Settings, then Connected Apps.

  2. Under Custom Apps for Spark, select Add custom app.

Gemini settings with Connected Apps selected and the Add custom app button under Custom Apps for Spark
Custom apps live under Connected Apps in Gemini's settings.
  1. Choose Cloud MCP, paste your Server URL under Add a custom app link, and select Next. Leave Client ID and Client secret empty.

Gemini's Set up a custom connected app window with Cloud MCP selected and the custom app link field
Pick Cloud MCP and paste the Server URL. Nothing else is needed.
  1. On the Askly page, paste your access key and select Allow.

Gemini custom apps only work for personal Google accounts in the US, in English, with Keep Activity turned on. They don't work with work or school accounts. If your account doesn't qualify, Gemini shows a Google "500. That's an error" page after you select Next.

If your assistant asks for a Client ID

Some assistants let you type your own Client ID and Client secret. You don't need them. If you use them, both are required, and this only works with Claude, ChatGPT, and Gemini:

  • Client ID: the last part of your Server URL, after /mcp/.

  • Client secret: your access key.

Not connecting?

  • Check that Allow access is on in Settings → AI assistants.

  • Paste the whole Server URL, with nothing added at the end.

  • On the Askly page, paste the access key exactly as you copied it. After 5 wrong tries, wait 15 minutes.

  • If the Askly page says it expired, start again from your assistant. The page lasts 30 minutes.

  • Lost the key? Select Replace key, then connect again with the new one.

  • In Claude, choose Sign in now, not Sign in when needed.

  • Gemini shows a Google "500" page? That comes from Google, not from Askly. Check that your Google account meets the requirements above.

AI assistants can only read your surveys and answers. They can't change, publish, or delete anything. Each connection lasts 90 days, then you approve it again with your access key.

To stop access: turn off Allow access. If the key was shared by mistake, select Replace key. The old key stops working right away, and every connected assistant is disconnected. Connect each one again with the new key.

AI assistants settings showing Allow access turned on and Replace key next to the masked access key
Turn off Allow access to stop all assistants, or select Replace key to disconnect them and start fresh.

Something not working? Contact support.

Last updated

Was this helpful?