---
title: "Solucionar una conexión MCP"
canonical: https://www.billabex.com/es/ayuda/billabex-con-ia/solucionar-una-conexion-mcp/
lang: es
alternate: https://www.billabex.com/fr/aide/billabex-avec-ia/depanner-connexion-mcp.md
alternates:
  fr: https://www.billabex.com/fr/aide/billabex-avec-ia/depanner-connexion-mcp.md
  es: https://www.billabex.com/es/ayuda/billabex-con-ia/solucionar-una-conexion-mcp.md
  en: https://www.billabex.com/en/help/billabex-with-ai/troubleshoot-mcp-connection.md
updated: 2026-07-17
index: https://www.billabex.com/llms.txt
---

# Solucionar una conexión MCP

<section class="help-summary" aria-labelledby="resumen"><h2 id="resumen">En resumen</h2><p>Trate una avería de MCP siguiendo un orden fijo: confirme la URL oficial, observe el paso por OAuth, compruebe los scopes y pruebe después una lectura sencilla en la organización correcta. Abrir la URL directamente en un navegador no prueba el conector. Conserve el mensaje exacto y la hora si el error persiste.</p></section>

## Resultado esperado

Identifica si el bloqueo procede de la configuración del cliente, de la autorización de Billabex, del alcance o de una llamada demasiado frecuente.

## Antes de empezar

- Mantenga el acceso a los ajustes del cliente de IA y a **Configuración > Integraciones** en Billabex.
- No comparta ningún secreto en una captura ni en una solicitud de soporte.

## Procedimiento

1. Compare la URL del cliente con la que muestra Billabex, carácter por carácter.
2. Desconecte y vuelva a conectar una sola vez para terminar OAuth con la cuenta correcta.
3. Compruebe `mcp:read` para una lectura y `mcp:write` únicamente para una modificación.
4. Pruebe la lista de organizaciones y después una lectura concreta con un identificador conocido.
5. Si el error menciona un límite, espacie las llamadas; si no, conserve la hora, el cliente, la herramienta y el mensaje exacto para el soporte.

## Qué hace Billabex

El servidor exige una autenticación válida, limita las llamadas demasiado frecuentes y rechaza una herramienta cuando el scope o la organización no coinciden. Los códigos y formatos de error que debe interpretar el cliente se describen en la documentación para desarrolladores versionada.

## Si el resultado no es el esperado

- Una respuesta obtenida al abrir la URL en el navegador no prueba que el servidor no esté disponible.
- Unos datos vacíos pueden corresponder a la organización equivocada y no a una avería de transporte.
- Oculte tokens, cookies y encabezados Authorization antes de enviar cualquier captura al soporte.