Guide/Troubleshooting

Troubleshooting

Quick fixes for common issues.

Get help with common issues

Connection Issues

"Connection failed" when linking AI

Try:

  • Make sure you're signed in to Contextable first
  • Clear your browser cookies and try again
  • Use an incognito window to rule out extension conflicts
  • Check that your AI platform subscription supports integrations

Contextable tools not appearing in chat

Try:

  • Look for a "connectors" or "tools" toggle in your chat interface
  • Start a new conversation (some AIs cache tool lists)
  • Disconnect and reconnect Contextable in your AI's settings
  • Refresh the page

"Unauthorized" or "Authentication failed"

Try:

  • Your connection may have expired - reconnect in AI settings
  • Check that your Contextable account is still active
  • Sign out of Contextable and sign back in

Claude Code connection issues

Debug the MCP connection:

  • Run /mcp to see your connected servers
  • Check if Contextable shows as "connected" with available tools
  • Run /mcp reset contextable to reconnect
  • If OAuth fails, try /mcp remove contextable and add again
Claude Code /mcp command showing connected MCP servers and tools
Use /mcp to check your connection status

Saving Issues

AI generates content but doesn't save it

Try:

  • Use the "Force Save" prompt from your dashboard
  • Some AIs need explicit permission - look for approval buttons
  • Check if the AI mentioned any errors in its response

"Blocked on safety" error (ChatGPT)

ChatGPT sometimes blocks tool calls for certain content types (finance, legal, medical). This is OpenAI's safety filter, not Contextable.

Try:

  • Rephrase sensitive content in more general terms
  • Try saving with Claude instead (fewer restrictions)
  • Copy the generated content and paste it manually in Contextable

Save seems to work but project doesn't appear

Try:

  • Refresh your Contextable dashboard
  • Check if the "Live" indicator is green (realtime connected)
  • Look for error messages in the AI's response
  • Check browser console for errors (F12 → Console)

"Parse error" when saving complex content

Content with code blocks (triple backticks), complex markdown tables, or certain special characters can sometimes fail to save.

Try:

  • Use simpler formatting without code blocks
  • Replace triple backticks with indented code (4 spaces)
  • Split very complex content into smaller pieces
  • If saving code, describe it in plain text instead

This is a known limitation with how some AI clients serialize content. We're working with platform providers to improve this.

Loading Issues

AI can't find my projects

Try:

  • Make sure the Contextable connector is enabled for this chat
  • Check that you're connected with the same account that has the projects
  • Try the "What Have I Saved?" prompt to list all projects

Content is truncated or incomplete

This is normal for very large documents.

  • We limit loaded content to ~50,000 characters to fit in AI context
  • View the full content in your Contextable dashboard
  • Consider splitting very large projects into focused documents

General Tips

Start a new conversation

Many issues are resolved by starting fresh. AI platforms can cache stale connection data.

Reconnect the integration

In your AI's settings, disconnect Contextable and reconnect it. This refreshes the authentication.

Check the status page

If nothing is working, there may be a service issue. Check our status at status.contextable.me

Still Need Help?

Contact Support

Can't find a solution? Email us at support@contextable.me and we'll help you out.

Please include:

  • Which AI platform you're using
  • What you were trying to do
  • Any error messages you saw
  • Screenshots if possible