¿Cuándo usar esta guía?

Algunos clientes MCP, principalmente los IDEs, no soportan la autenticación OAuth para los conectores remotos. Necesitan una clave API de Aidoo transmitida en la cabecera Authorization:

Cursor, Windsurf y otros IDEs compatibles con MCP
Cualquier cliente MCP que no ofrezca el flujo OAuth

Para Claude.ai, ChatGPT, Claude Desktop y Claude Code, utiliza la guía Conectarse con Claude (OAuth, sin clave API).

Requisitos previos

Una cuenta Aidoo activa con una conexión Odoo configurada
Una clave API de Aidoo (prefijo aid_live_). Sigue la guía Claves API para generar una.

El servidor MCP está alojado por Aidoo en https://mcp.aidoo.fr. No hace falta ninguna instalación local.

Cursor

Añade el servidor MCP en ~/.cursor/mcp.json:

{
  "mcpServers": {
    "aidoo": {
      "url": "https://mcp.aidoo.fr/sse",
      "headers": {
        "Authorization": "Bearer aid_live_tu_clave_aqui"
      }
    }
  }
}

Recarga la ventana del IDE (Cmd/Ctrl+Shift+P → Reload Window) para activar el conector.

Windsurf

Añade el servidor MCP en ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "aidoo": {
      "url": "https://mcp.aidoo.fr/sse",
      "headers": {
        "Authorization": "Bearer aid_live_tu_clave_aqui"
      }
    }
  }
}

Recarga la ventana de Windsurf para activar el conector.

Otros clientes MCP

Para cualquier otro IDE o cliente compatible con MCP, consulta su documentación para conocer la ubicación del archivo de configuración. El bloque que hay que añadir es el mismo: URL https://mcp.aidoo.fr/sse, transporte SSE, cabecera Authorization: Bearer aid_live_….

Probar la conexión

Hazle una pregunta a tu cliente:

¿Cuáles son mis 5 últimos pedidos de compra en Odoo?

Deberías ver al asistente proponer una llamada a una herramienta aidoo_*. Apruébala para ejecutar la consulta.

Seguridad

No compartas nunca tu clave API públicamente (repositorio Git, captura de pantalla, etc.)
Una clave por usuario: no compartas las claves entre miembros del equipo
En caso de duda, revoca la clave desde el panel de Aidoo y genera una nueva
Limita los permisos de cada clave al mínimo estricto (ver Claves API)

Resolución de problemas

El icono MCP no aparece en el IDE

Comprueba que el archivo mcp.json sea JSON válido (una herramienta como jq o un linter en línea ayuda)
Recarga por completo la ventana del IDE (Reload Window); reiniciar solo el terminal no basta
Consulta los logs del IDE: Cursor (Output → MCP), Windsurf (View → Output → MCP)

Error 401 / «Unauthorized»

Comprueba que tu clave API empiece por aid_live_
Asegúrate de que la clave no haya sido revocada en el panel
Comprueba que el permiso MCP correspondiente esté activado en la clave

El servidor MCP es inaccesible

Prueba https://mcp.aidoo.fr/health desde tu navegador — deberías ver {"status":"ok"}
Comprueba tu firewall / VPN corporativa (HTTPS saliente en el puerto 443)