Common Issues

Connection issues

Claude can't see my data after the flow runs successfully

This usually means the Coupler.io extension or connector isn't active in your Claude session. Check the following:

• Claude Desktop: Go to Settings > Extensions and confirm the Coupler.io extension is toggled on.
• Claude Web: Open the Connectors menu and verify that Coupler.io shows as connected.
• Start a new chat after confirming the connection — existing chats may not pick up a newly activated extension.

If the extension is active but Claude still can't see the data, try re-authenticating by removing and re-adding the access token.

MCP connector timeouts or the "Get-dataflow" tool gets stuck

Intermittent timeouts when Claude calls the Get-dataflow tool are a known issue with the MCP connector. This can happen when datasets are large or the connection experiences latency.

If you're hitting this frequently, try reducing the amount of data sent to Claude by filtering at the source level in Coupler.io. Sending a focused, smaller dataset is more reliable than sending everything.

If the problem persists across multiple sessions, contact Coupler.io support — this may require investigation by the engineering team.

Claude Web connector won't connect — no option to authenticate

Team and Enterprise Claude accounts require admin permissions to add a new connector. If you don't see the option to connect or the button is greyed out, ask your workspace admin to complete the connection or grant you admin access.

Data issues

Claude sees fewer rows than the Coupler.io preview shows

A mismatch between the Preview in Coupler.io and the data Claude receives can occur when the same identifier (for example, an ad_id) appears multiple times, and deduplication logic affects the export differently than the preview.

Don't rely on the Preview tab alone to confirm what Claude will receive. Always check the actual row count in Claude after running the flow. You can also configure a Google Sheet export to verify that the number of rows is the same and to check what's missing.

If you notice specific rows are missing, note the relevant IDs and contact Coupler.io support with the data flow details — this type of discrepancy requires engineering investigation.

Permission errors

"You've reached your destination limit" or AI usage is restricted

Coupler.io plans have limits on destination type. If you're using Claude as a destination and also sending data elsewhere (for example, Google Sheets), you may hit this limit.

To resolve this, either:

• Remove the other destination and use only Claude, or
• Upgrade to a higher Coupler.io plan that supports multiple destination types.

Each active data flow counts toward your plan limits. If you created a test flow with a different destination, delete it to free up your destination slot or upgrade to a higher plan.