Conecta ByDomu a Claude (MCP)

Deja que Claude u otro cliente MCP consulte tu inmobiliaria, en solo lectura.

GuíaSolo lecturaClave secreta

Antes de empezar. Necesitas un plan Business o Enterprise (en Individual y Profesional, con acceso aprobado), el correo verificado y estar fuera de la prueba gratis.

Crea una clave secreta de solo lectura

En ByDomu, ve a Configuración › API Keys › Nueva clave, elige A la medida y marca solo estos permisos de lectura. Copia la clave: la completa se ve una sola vez.

Para quéPermiso

Buscar y ver propiedadesportal:read

Buscar y ver contactoscontacts:read

Agenda y próximas citasappointments:read

Embudos y negociosdeals:read

Tareas pendientestasks:read

Mensajes de un contacto (opcional)conversations:read

Conecta tu cliente

Pega la dirección del servidor y la clave en tu cliente. En Claude Code es un solo comando:

claude mcp add --transport http bydomu https://mcp.bydomu.com/mcp \
  --header "Authorization: Bearer domu_sk_live_XXXXXXXX"

Claude Desktop usa mcp-remote; Cursor y VS Code, la URL y el encabezado en su configuración. En claude.ai o ChatGPT, agrega un conector con la dirección del servidor e inicia sesión con tu cuenta de ByDomu.

Prueba la conexión

Pídele a tu asistente un resumen. Debe usar la herramienta get_summary y contestar con el plan, los permisos de la clave y los conteos de tu cuenta.

O pruébalo sin asistente, con cURL:

cURL

curl -s https://mcp.bydomu.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'Authorization: Bearer domu_sk_live_XXXXXXXX' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_summary","arguments":{}}}'

Si algo falla

La herramienta devuelve el error de la API en palabras:

401La clave falta o no es válida. Revisa que el encabezado diga «Bearer» y la clave completa.
403Usaste una clave publicable (domu_pk_) o a la clave le falta el permiso de esa herramienta.
429Pasaste el límite por minuto. El error dice en cuántos segundos reintentar.