Claude: claude.ai, Desktop y Code

Agrega el conector en claude.ai

Funciona en Free (un conector personalizado), Pro y Max, y queda en la web, en Claude Desktop y en el celular. No pegas ninguna clave: inicias sesión con tu cuenta de ByDomu.

Los nombres del menú son los de la documentación de Anthropic en inglés; en otro idioma salen traducidos. Claude Desktop usa los mismos conectores de tu cuenta: no hace falta configurar nada más. Si prefieres una clave en Desktop, usa mcp-remote (un paquete de la comunidad):

// claude_desktop_config.json: solo si necesitas una clave en vez de iniciar sesión
{
  "mcpServers": {
    "bydomu": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.bydomu.com/mcp", "--header", "Authorization:${BYDOMU_AUTH}"],
      "env": { "BYDOMU_AUTH": "Bearer domu_sk_live_XXXXXXXX" }
    }
  }
}

En Team y Enterprise

Un Owner lo agrega para toda la organización en Organization settings › Connectors › Add › Custom › Web, con la misma URL. Después cada persona lo conecta en Customize › Connectors › Connect e inicia sesión con su cuenta de ByDomu; solo quien administra las claves de API de la inmobiliaria puede permitirlo. Cada conexión lee la inmobiliaria completa en solo lectura, no solo lo asignado a esa persona.

Claude Code

Agrégalo sin clave y autentícate con /mcp (abre el navegador para permitir el acceso en ByDomu), o pásale una clave secreta de solo lectura por encabezado. Para compartirlo con tu equipo, .mcp.json admite variables de entorno: la clave nunca queda en el repositorio.

# Con inicio de sesión (sin clave)
claude mcp add --transport http bydomu https://mcp.bydomu.com/mcp
# luego, dentro de Claude Code:
/mcp        # elige bydomu → Authenticate → Permitir en ByDomu

Pruébalo

Pregúntale «Dame un resumen de la inmobiliaria»: debe usar get_summary y contestar con el plan, los permisos y los conteos. Luego algo como «¿Qué citas tengo mañana?» o «Busca apartamentos en arriendo en Medellín de menos de 4 millones».

• 403En la pantalla de ByDomu: tu plan no incluye conectar apps, estás en la prueba gratis, falta verificar el correo o no administras las claves de API.
• 401Alguien quitó el acceso en Apps conectadas o pasaron 30 días sin uso: vuelve a conectar.

Qué puede hacer, cómo se revoca y buenas prácticas

El servidor es de solo lectura: la IA puede consultar, pero no crea, cambia ni borra nada, y nunca envía mensajes a tus clientes. Ve solo lo que permiten estos permisos, con el límite de una clave secreta (60 peticiones por minuto).

Con inicio de sesión, cada conexión recibe su propia credencial de solo lectura. Para quitarla, ve a Configuración › API Keys › Apps conectadas › Quitar acceso: la siguiente llamada de la app falla y tendrá que pedir permiso otra vez. Ahí ves quién la conectó, cuándo se usó por última vez y cuántas llamadas hizo en 30 días. El acceso dura mientras se use; tras 30 días sin uso hay que volver a permitirlo.