---
title: "Troubleshooting"
description: "Start from what you see: an agent says done, a status reads unknown, an MCP client cannot connect, or the Desk refused a card."
url: "https://docs.octo.ad/troubleshooting/"
id: "troubleshooting"
type: "map"
audience: "operator"
dateModified: "2026-11-06"
keywords: ["troubleshooting"]
---

# Troubleshooting

> Start from what you see: an agent says done, a status reads unknown, an MCP client cannot connect, or the Desk refused a card.

Each page names the condition, how to check it, why it happens and what to do.

- [An agent says done, but the work is not](/troubleshooting/agent-says-done/): When an agent reports a task finished and the change is not there.
- [A status shows unknown](/troubleshooting/status-unknown/): Why a lane, worker or check reads unknown, and what to check.
- [The MCP client cannot connect](/troubleshooting/mcp-cannot-connect/): Checks for the address, the transport and the tool list when a client cannot reach https://octo.ad/mcp.
- [The Desk refused a card](/troubleshooting/desk-refused-a-card/): A card was refused before it reached a person. The fix is on the Desk page for refused cards.