> For the complete documentation index, see [llms.txt](https://replai-1.gitbook.io/replai-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://replai-1.gitbook.io/replai-docs/connectors-sources/troubleshooting-connectors.md).

# Troubleshooting connectors

## Troubleshooting connectors

Most connector issues come from three things.

The token is wrong, the scope is wrong, or the latest sync did not finish cleanly.

### What should you check first?

{% stepper %}
{% step %}

### Check access

Make sure the source still has valid access.

Reconnect it if the token or source access changed.
{% endstep %}

{% step %}

### Check scope

Make sure the expected spaces, pages, or paths are still in scope.

Tight scopes usually work better than broad ones.
{% endstep %}

{% step %}

### Check the latest sync

Run a manual sync if you need a fresh result now.

Then review the updated page list.
{% endstep %}
{% endstepper %}

<details>

<summary>GitBook connector issues</summary>

If spaces or pages are missing, check the GitBook token first.

If you want to change selected spaces or pages, re-enter the token before you edit the scope.

If new pages do not appear, confirm whether the connector is set to **All pages** or a manual subset.

</details>

<details>

<summary>Website crawler issues</summary>

Make sure the site is public.

Check `robots.txt`, path filters, and the max pages setting.

If the crawl finds too many pages, narrow the scope before you sync again.

</details>

<details>

<summary>Q&#x26;A snippet issues</summary>

Only **Published** snippets are indexed.

Draft or deleted snippets do not appear in answers.

</details>

{% hint style="info" %}
Most answer-quality issues start with source quality.

Clean scope beats broad scope.
{% endhint %}

### Related links

* [Sources overview](/replai-docs/connectors-sources/sources-overview.md)
* [GitBook connector](/replai-docs/connectors-sources/gitbook-connector.md)
* [Website crawler](/replai-docs/connectors-sources/website-crawler.md)
* [Q\&A snippets](/replai-docs/connectors-sources/q-and-a-snippets.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://replai-1.gitbook.io/replai-docs/connectors-sources/troubleshooting-connectors.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.