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

# Troubleshooting

Most issues come down to the API key, the plugin, or the skills. This table covers the common cases.

| Symptom                                                 | Likely cause                                                            | Fix                                                                                              |
| ------------------------------------------------------- | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
| Key creation fails with a connection error              | Identity service unreachable (for example, VPN off)                     | Reconnect and retry                                                                              |
| 401 or 403 on tool calls                                | Invalid or revoked key, or a non-owner action                           | Re-check the key; mint a new one if needed                                                       |
| "Create key" button missing                             | You are not a workspace owner                                           | Ask your workspace owner to mint a key                                                           |
| Nothing happens in the regular Claude.ai chat           | The plugin runs in Claude Cowork and Claude Code, not the standard chat | Use Claude Cowork or Claude Code                                                                 |
| Claude Desktop "Add custom connector" fails             | That dialog is now OAuth-only, the old connector URL no longer connects | Use the **plugin** instead: download it from the key dialog and upload it under Personal plugins |
| Plugin upload is rejected                               | The `.zip` was unzipped before uploading                                | Upload `dapta-ai-plugin.zip` as-is, do not unzip it                                              |
| Can't download the plugin again                         | The plugin is generated once, from the key reveal dialog                | Revoke the key and mint a new one to get a fresh plugin                                          |
| Claude Code does not know how to do a task              | Skills bundle not installed (Claude Code)                               | Re-download and unzip the bundle into `.claude/skills/`                                          |
| Claude Code reaches tools but skips the guided workflow | Skills bundle not installed or not paired                               | Reinstall the bundle, then start a new session                                                   |
| Can't mint a new key                                    | An active key already exists                                            | Revoke the current key first (one per workspace)                                                 |

***

## Still stuck?

If none of the above fixes it, open a tracked ticket from your AI client. Just say:

> **Open a support ticket: the Dapta MCP isn't connecting.**

The `create_support_ticket` skill will preview the ticket and file it once you confirm. See [Support](/dapta-mcp/skills/support.md) for details.

***

## Related

{% content-ref url="/pages/OD9WDmDwZ4XnWpq0R1gZ" %}
[Verify your connection](/dapta-mcp/setup/verify.md)
{% endcontent-ref %}

{% content-ref url="/pages/rZHgP7MaYxEYKZWNWWUE" %}
[Mint your API key](/dapta-mcp/setup/mint-your-api-key.md)
{% endcontent-ref %}


---

# 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:

```
GET https://docs.dapta.ai/dapta-mcp/troubleshooting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.