• READY
  • PENDING
  • ERROR
  • HUMAN

How to monitor bot sync status with your AI

Connect Cody AI to your agent to track document processing. Once linked, your AI can tell you exactly when your knowledge base is ready to use.

Ask AI about this page

Short answer

How can I tell if my AI has finished reading my documents?

Ask your AI to check the status of your knowledge base. It will verify if files are fully processed or still syncing, so you know when the data is reliable.

Sync outcomes

Status check results

What you see when you ask about your files.

READY

Full knowledge access

The AI confirms all files are indexed. You can start asking questions immediately without missing context.

PENDING

Sync in progress

The AI identifies that files are still being processed. It will tell you to wait before relying on the data.

ERROR

Processing issues

The AI flags documents that failed to sync. You'll know which specific files need your attention.

HUMAN

Manual fix needed

If a sync fails, the AI identifies the problem but cannot fix the file. You'll need to re-upload the source document.

The workflow

What your AI does when you check status.

The AI handles the backend checks so you don't have to manually watch progress bars.

  1. Find documents

    The AI pulls a list of all files in your knowledge base to see what is currently stored.

    list_documents

  2. Check individual status

    The AI looks at the specific processing state of each file to see if it's finished.

    get_document_status

  3. Verify readiness

    The AI checks the status of your files to confirm the knowledge base is ready for queries.

    get_document_status

  4. Report findings

    The AI summarizes whether the sync is complete or if errors occurred during processing.

    get_document_status

Try it

Copy these to start.

Use these prompts to get immediate updates from your agent.

Starting points

These are opening lines. Swap out the folder names or document titles to match your actual files.

Cody AI Connector

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

Connector linkhttps://edge.vinkius.com/vk_preview_3sdhdxz69A9PNCbHGNcvaVvLSXZIq9OFM5te4LTv/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 — Cody AI capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "cody-ai-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_3sdhdxz69A9PNCbHGNcvaVvLSXZIq9OFM5te4LTv/mcp"
    }
  }
}
Copy into chat04

  • Are all my documents in the 'Project Alpha' folder fully synced?

  • Check the sync status for the 'Q3 Financials' document.

  • List my documents and tell me if any are still processing.

  • Is the knowledge base ready for the 'Marketing Strategy' task?

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

Start here

Connect Cody AI once, then ask.

Connect your account once and your credentials stay encrypted. You can then jump straight into asking your AI about your files.

Connect Cody AI to your AI

FAQ

How the sync monitoring behaves

  • 01

    Can the AI fix a document that failed to sync?

    No. The AI can only report the status. You have to fix the file and re-upload it yourself.

  • 02

    Does the AI delete documents if a sync fails?

    No. The AI only reads the status of your documents. It cannot delete or modify your files.

  • 03

    How often does the AI check the status?

    The AI only checks the status when you specifically ask it to via a prompt.

  • 04

    Can I see a list of all my files?

    Yes. The AI can pull a full list of your documents to show you what is in the knowledge base.

  • 05

    Will the AI tell me if a file is still being processed?

    Yes. It will tell you if a document is still in a pending state.

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

Connect Cody AI to Claude, Cursor, ChatGPT & more