> ## Documentation Index
> Fetch the complete documentation index at: https://docs.visk.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> The handful of issues that account for nearly all connection problems

The handful of issues that account for nearly all connection problems, and how to fix them.

<AccordionGroup>
  <Accordion title="The client can't connect, or requests come back as 307 redirects">
    Make sure the URL ends with a trailing slash: `https://api.visk.com/mcp/`. Without it the server redirects, and some MCP clients don't follow the redirect.
  </Accordion>

  <Accordion title="Requests fail with 406 Not Acceptable">
    Visk uses the MCP streamable HTTP transport, which requires the header `Accept: application/json, text/event-stream`. MCP clients send this automatically; if you're calling the endpoint by hand, add it yourself. Responses come back framed as server-sent events.
  </Accordion>

  <Accordion title="My client only supports local (stdio) MCP servers">
    Bridge through `mcp-remote`: `npx -y mcp-remote https://api.visk.com/mcp/`. The Other clients tab on the [setup page](/setup) has details.
  </Accordion>

  <Accordion title="A tool call failed with session_expired (410)">
    The workspace behind that session id is gone. Ask the AI to start a fresh session and re-upload the file — or just re-run your request; agents normally recover from this on their own.
  </Accordion>

  <Accordion title="The download link stopped working">
    Export links are valid for 6 hours. Ask for the deck to be exported again — the session still has the latest state, so it's a single call.
  </Accordion>

  <Accordion title="The AI built a deck without using Visk">
    Check the server is actually connected (e.g. `claude mcp list` in Claude Code), then mention Visk explicitly: "use Visk to build a PowerPoint about…". Once it has used the tools once, it picks them up naturally.
  </Accordion>
</AccordionGroup>

Still stuck? Reach us at [contact@visk.com](mailto:contact@visk.com).