• LOGS
  • AUTH
  • DATA
  • HUMAN

How to debug integration sync failures with your AI

Connect Nango once to give your agent direct access to your integration health. It handles the heavy lifting of scanning logs and metadata to find the root cause of errors.

Ask AI about this page

Short answer

How do I find out why my syncs are failing?

Your AI pulls the latest sync status and connection details to identify broken credentials or malformed data. You get a clear breakdown of the error source and the specific integration involved.

Where every issue lands.

Debug outcomes

The AI categorizes every failure into actionable buckets.

LOGS

Error identification

The AI scans recent sync attempts to find the specific error message. You get the exact reason the data didn't move.

AUTH

Credential checks

The agent checks if the connection is still valid. It tells you if a token expired or a user revoked access.

DATA

Schema mismatches

The AI looks for discrepancies between the source and destination. You'll see if a field type or missing value caused the crash.

HUMAN

Manual intervention

The AI flags issues it can't fix, like a user needing to re-authenticate. You get a direct instruction on what to do next.

The workflow

What your AI does when a sync fails.

Instead of you digging through dashboards, your agent performs a targeted investigation.

  1. Identify failed runs

    The agent pulls a list of recent synchronization attempts to find the ones marked as failed.

    list_syncs

  2. Inspect connection health

    It looks up the specific connection details to see if the underlying link is still active.

    get_connection

  3. Verify integration settings

    The agent checks the configuration of the specific integration to ensure the setup is correct.

    get_integration

  4. Summarize the fix

    The AI combines the logs and metadata into a plain English explanation of the error.

    list_syncs

Try it

Copy these to start.

Use these prompts to kick off an investigation.

Starting points

Replace the bracketed text with your specific integration or sync ID.

Nango Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_7jENP9QLzi7Gc6CTWDiT6gMRkMOQLbLXLM9KXnBO/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Nango capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "nango-unified-api-integration-platform-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_7jENP9QLzi7Gc6CTWDiT6gMRkMOQLbLXLM9KXnBO/mcp"
    }
  }
}
Copy into chat04

  • Check the status of my Salesforce syncs and tell me why the last one failed.

  • Look at the connection for my HubSpot integration and see if the credentials are still valid.

  • Why did the sync for the Shopify integration fail this morning?

  • List all recent sync failures and tell me which one needs my attention.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Nango once, then ask.

One connection gives your agent access to all your integration metadata. Your credentials stay encrypted and secure on our side.

Connect Nango to your AI

FAQ

Common questions

  • 01

    Can my AI fix the sync error automatically?

    No. The AI identifies the cause, but you must manually fix credentials or data issues in the source system.

  • 02

    Does the AI have access to my actual customer data?

    No. The AI only sees the metadata and logs required to diagnose the connection and sync status.

  • 03

    Can the AI delete an integration?

    No. The tools only allow the AI to read syncs, connections, and integration details.

  • 04

    How often does the AI check for failures?

    The AI only checks when you ask it to via your AI client.

  • 05

    Can I use this with any AI client?

    Yes, it works with any MCP-compatible client like Claude, Cursor, or Windsurf.

  • More questions about Nango? The Connector page answers them. See everything the Nango Connector can do

Connect Nango to Claude, Cursor, ChatGPT & more