> 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-docs-es/dapta-mcp/troubleshooting.md).

# Solución de Problemas

La mayoría de los problemas se reducen a la clave de API o a la conexión. Esta tabla cubre los casos más comunes.

| Síntoma                                                                         | Causa probable                                                                                     | Solución                                                                                                                                                                            |
| ------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| La creación de la clave falla con un error de conexión                          | Los sistemas protegidos de Dapta estuvieron brevemente inalcanzables (por ejemplo, la VPN apagada) | Vuelve a conectarte e inténtalo de nuevo                                                                                                                                            |
| Aparece "no autorizado" o no regresa ningún dato                                | Puede que la clave esté revocada, o que pertenezca a otro workspace (espacio de trabajo)           | Genera una clave nueva para el workspace que quieres y conéctate otra vez                                                                                                           |
| Falta el botón "Create API key" (Crear clave de API)                            | No eres propietario del workspace                                                                  | Pídele a la persona propietaria del workspace que cree una clave                                                                                                                    |
| Las herramientas no aparecen en Claude Desktop                                  | El plugin aún no está conectado                                                                    | Abre la pestaña **Connectors** (Conectores) del plugin y haz clic en **Install** (Instalar) junto a **dapta-ai**, luego cierra Claude por completo con **Cmd+Q** y vuelve a abrirlo |
| No pasa nada en el chat normal de Claude.ai                                     | El plugin funciona en Claude Cowork y en Claude Code, no en el chat estándar                       | Usa Claude Cowork o Claude Code                                                                                                                                                     |
| Falla "Add custom connector" (Agregar conector personalizado) en Claude Desktop | Ese cuadro de diálogo ahora es solo para iniciar sesión, la antigua URL del conector ya no conecta | Usa el **plugin** en su lugar: descárgalo desde el cuadro de diálogo de la clave y súbelo en Personal plugins (Plugins personales)                                                  |
| Se rechaza la subida del plugin                                                 | El archivo `.zip` fue descomprimido antes de subirlo                                               | Sube `dapta-ai-plugin.zip` tal cual, no lo descomprimas                                                                                                                             |
| Perdiste tu clave                                                               | La clave se muestra una sola vez y no se puede recuperar                                           | Revócala y genera una nueva                                                                                                                                                         |
| No puedes volver a descargar el plugin                                          | El plugin se genera una sola vez, desde el cuadro de diálogo que revela la clave                   | Revoca la clave y genera una nueva para obtener un plugin nuevo                                                                                                                     |
| No puedes generar una clave nueva                                               | Ya existe una clave activa                                                                         | Revoca primero la clave actual (una por workspace)                                                                                                                                  |

***

## ¿Sigues atascado?

Si nada de lo anterior lo resuelve, abre un ticket con seguimiento desde tu cliente de IA. Solo di:

> **Abre un ticket de soporte: el MCP de Dapta no se conecta.**

Claude mostrará una vista previa del ticket y lo registrará una vez que confirmes. Consulta [Soporte](/dapta-docs-es/dapta-mcp/skills/support.md) para más detalles.

***

## Relacionado

{% content-ref url="/pages/YjqSi8sNMity7yIJrL6w" %}
[Verifica tu conexión](/dapta-docs-es/dapta-mcp/setup/verify.md)
{% endcontent-ref %}

{% content-ref url="/pages/H5CyEzM9NRIPupJxrUsd" %}
[Genera tu clave de API](/dapta-docs-es/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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.