Agent-readable docs index: /llms.txt. Full docs in one file: /llms-full.txt. Download /docs.zip to grep all markdown files locally.

Fix Collabute connection and empty-data issues

Use this page when an integration is connected but not behaving as expected.

Quick diagnosis order

  1. Check status in Settings > Integrations.
  2. Confirm your role is allowed for that integration.
  3. Re-run one validation prompt from the integration doc.
  4. Check provider-side permissions (workspace, project, channel, team).
Status in Settings? ├── Not connected re-run OAuth in the same browser session ├── Connected, access denied admin updates role policy └── Connected, empty data ├── Wrong project / team / channel / date └── Provider account lacks that resource

Integration shows "Not connected"

  • Re-run connect flow from Settings > Integrations.
  • Complete provider auth in the same browser session.
  • If it still fails, ask admin to disconnect and reconnect once.

"You don't have access" error

  • Your org role is restricted for that integration.
  • Ask admin to update role access settings.

No data appears in chat

  • Confirm you are querying the right context (project, team, channel, date).
  • Narrow your prompt with explicit scope (environment, timeframe, channel).
  • Check provider-side permissions for the connected account.

Prompts are too broad

Use more specific prompts:
  • Bad: What's happening?
  • Better: Show prod runtime errors in the last hour for project X.

Vercel-specific issues

  • No deployments found: verify project and team selection. See Vercel.
  • Logs empty: widen time range or remove strict filters.
  • Preview check fails: use access-link flow for protected URLs.

Linear-specific issues

  • Task create/update not working: check default team is selected. See Linear.
  • Assignee not found: ensure user belongs to workspace and team.

Slack-specific issues

  • No thread replies: check that you can open the conversation in Slack. See Slack.
  • Missing private channel data: invite the Slack app to the channel if your workspace allows it.

Google-specific issues

  • No calendar events: confirm the intended Google account is connected. See Google.
  • Integration unavailable: your workspace may be on maintenance rollout.

When to contact support

Contact support when:
  • OAuth repeatedly succeeds but status stays disconnected.
  • Data is consistently missing despite verified provider access.
  • You see recurring permission errors for users who should have access.
Email team@collabute.com if the dashboard is healthy but MCP still cannot authorize.
Start in Settings > Integrations, then re-run one validation prompt from the matching integration page before you change provider permissions.