Conectarse con Claude

¿Qué es el protocolo MCP?

El Model Context Protocol (MCP) es un estándar abierto que permite a los asistentes de IA como Claude o ChatGPT interactuar con herramientas externas. Aidoo expone tus datos y acciones de Odoo a través de MCP, directamente en la conversación.

Requisitos previos

Antes de empezar, asegúrate de tener:

• Una cuenta Aidoo activa (prueba gratuita de 14 días disponible)
• Una conexión Odoo configurada en tu panel de Aidoo

No hay clave API que generar ni copiar. La autenticación se realiza mediante OAuth 2.1: te conectas a Aidoo desde Claude.ai o ChatGPT y autorizas el acceso con un solo clic.

Conectar Claude.ai

1. En Claude.ai, abre Ajustes → Conectores → Añadir un conector personalizado
2. Rellena:

3. Haz clic en Conectar
4. Eres redirigido a la página de inicio de sesión de Aidoo
5. Inicia sesión y selecciona la empresa que quieres autorizar
6. Haz clic en Autorizar: vuelves a Claude.ai, el conector está activo

El conector está disponible inmediatamente, en cualquier conversación. No hace falta reiniciar.

Conectar varias empresas a la vez

Claude solo permite una URL por conector. Para usar varios conectores Aidoo simultáneamente en la misma conversación —por ejemplo, una empresa por conector, o un entorno de producción y otro de pruebas— añade un conector para cada una de las URLs siguientes. Todas apuntan al mismo servicio Aidoo y funcionan de forma idéntica:

Para cada conector:

1. Dale un nombre descriptivo (p. ej. Aidoo — Empresa A, Aidoo — Producción) para distinguirlos en Claude
2. Introduce una de las URLs anteriores
3. Sigue el mismo flujo OAuth: inicia sesión en Aidoo y elige la empresa que quieres autorizar

Cada conector realiza su propia autorización y queda vinculado a la empresa que elijas. Así puedes consultar varias instancias de Odoo dentro de una misma conversación.

Consejo: la URL no influye en los datos. Es la empresa seleccionada durante la autorización la que determina a qué Odoo accede el conector. Simplemente usa una URL diferente por conector para sortear el límite de una sola URL de Claude.

Conectar ChatGPT

1. En ChatGPT, abre Ajustes → Conectores → Crear
2. Rellena:

3. Haz clic en Crear
4. Eres redirigido a la página de inicio de sesión de Aidoo
5. Inicia sesión, selecciona la empresa y haz clic en Autorizar

Probar la conexión

Hazle una pregunta sencilla para comprobar que todo funciona:

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

Claude (o ChatGPT) va a:

1. Identificar que debe usar las herramientas Aidoo
2. Pedirte que apruebes la llamada a la herramienta
3. Consultar tu Odoo a través de Aidoo
4. Mostrarte los resultados

Resolución de problemas

El conector no aparece en las herramientas disponibles

• Refresca la conversación o abre una nueva
• Comprueba en Ajustes → Conectores que el estado sea Conectado
• Si el estado es Reconectar, haz clic en el conector y luego en Reconectar

Error «Couldn't reach the MCP server»

• Comprueba que https://mcp.aidoo.ai/health sea accesible desde tu red
• En Claude.ai, la URL es https://mcp.aidoo.ai/mcp
• En ChatGPT, la URL es https://mcp.aidoo.ai/sse

La redirección OAuth falla

• Desactiva temporalmente los bloqueadores de ventanas emergentes y las extensiones de rastreo
• Asegúrate de haber iniciado sesión en tu cuenta Aidoo en el mismo navegador
• Comprueba que tu suscripción Aidoo esté activa (un banner de prueba expirada bloquea OAuth)

Error de conexión a Odoo

• Comprueba que tu conexión Odoo esté bien configurada en el panel de Aidoo
• Prueba la conexión desde Aidoo → Conexión Odoo → Probar
• Asegúrate de que las credenciales de Odoo siguen siendo válidas