Conectores de IA

Qué es un conector

SitesAI publica dos servidores MCP (Model Context Protocol, el estándar abierto que usan los asistentes de IA para acceder a sistemas externos). Una vez que conectas uno, puedes hacerle a tu asistente de IA preguntas sobre los datos de tus obras en lenguaje natural —“¿qué trabajos tienen presupuesto pero no están programados?”, “¿cuánto excavamos en la obra de Kilsyth?”— y te responde con los registros en vivo de tu cuenta.

• Conector de la SitesAI App: tus datos de operaciones en campo: oportunidades y presupuestos, tareas, obras, servicios y artículos, horas y turnos programados, partes de trabajo firmados, miembros, documentos de obra y cumplimiento de subcontratistas, etiquetas NFC/QR, procesos y listas de verificación. Endpoint: https://app.sitesai.net/api/mcp/mcp (añade ?profile=full para obtener todas las herramientas — consulta los perfiles de herramientas)
• Conector de SitesAI Estimate: tus proyectos de cubicación y presupuesto: capas de planos, hojas, grupos de medición, elementos de movimiento de tierras y el propio presupuesto. Endpoint: https://takeoff.sitesai.net/api/mcp

Ambos usan MCP streamable HTTP sobre HTTPS y admiten OAuth 2.1 (código de autorización + PKCE), además de claves API personales.

Cómo activar un conector

Los conectores están desactivados por defecto: no se comparte nada con ningún asistente de IA hasta que tú conectes uno deliberadamente.

1. Revisa tu plan. El conector de SitesAI App requiere el complemento de IA en tu empresa; SitesAI Estimate requiere el plan de IA en tu cuenta — o inicia la prueba gratuita de IA de 14 días en la app (menú Cuenta → Iniciar prueba gratuita de IA; sin tarjeta, una por cuenta).
2. Añade el conector en tu cliente de IA con el endpoint indicado arriba y completa el inicio de sesión que te solicite. En la SitesAI App, la pantalla de consentimiento está reservada a los propietarios y gerentes de la empresa, y es ahí donde eliges qué puede hacer la conexión: solo lectura o lectura y escritura. El acceso de escritura nunca es automático: si un propietario o gerente no elige la opción de lectura y escritura en esa pantalla, la conexión es de solo lectura y todas las herramientas de escritura se rechazan.
3. O usa una clave de API — créala en app.sitesai.net/ai-keys (SitesAI Estimate: menú Cuenta → Acceso para asistentes de IA (MCP)) y pégala en tu cliente de IA. Una clave puede ser de solo lectura o de lectura y escritura, y pertenece a una sola empresa.

SitesAI Estimate, cliente por cliente

La dirección del conector es https://takeoff.sitesai.net/api/mcp. Mantén abierta una pestaña de SitesAI Estimate con tu sesión iniciada mientras el asistente trabaja — verás los cambios en tiempo real.

• Claude (claude.ai o la app de escritorio) — Configuración → Conectores → Agregar conector personalizado → pega la dirección → inicia sesión con tu cuenta de SitesAI Estimate. Sin token.
• Claude Code — claude mcp add --transport http 3dx https://takeoff.sitesai.net/api/mcp; se abre una ventana del navegador para iniciar sesión.
• Codex (escritorio) — en la app: menú Cuenta → Acceso para asistentes de IA (MCP) → Crear token. En Codex: Conectar a un MCP personalizado → Nombre 3DX, Tipo Streamable HTTP, la dirección y un encabezado Authorization: Bearer <your token>.
• Codex CLI — en ~/.codex/config.toml: [mcp_servers.threedx] url = "https://takeoff.sitesai.net/api/mcp" http_headers = { Authorization = "Bearer <your token>" }.
• ChatGPT — Configuración → Apps y conectores → Avanzado → activa el modo desarrollador → crea un conector con la dirección → inicia sesión. (Nombres de menú verificados el 3 de octubre de 2026; cambian entre versiones — la dirección y el inicio de sesión no.)

¿Quieres que el asistente presupueste trabajos con tus tarifas y factores cada vez? Lee Enseña a Claude o Codex a presupuestar trabajos a tu manera y descarga la habilidad de inicio.

Revocar el acceso: todas las claves y conexiones OAuth aparecen en app.sitesai.net/ai-keys y puedes revocarlas en cualquier momento; dejan de funcionar de inmediato.

Qué puede ver y qué no un asistente conectado

• Ve los datos de una sola empresa: la empresa a la que pertenece la clave o el consentimiento. Cada solicitud se limita a esa empresa en nuestros servidores, por lo que un conector nunca puede acceder a los registros de otra empresa.
• Las herramientas de lectura y las de escritura son herramientas separadas, cada una etiquetada con lo que hace, para que tu cliente de IA pueda preguntarte antes de cambiar algo. Una clave o conexión OAuth de solo lectura no puede usar las herramientas de escritura en absoluto.
• Las solicitudes tienen un límite de frecuencia por clave y se registran en el registro de auditoría de IA de la empresa (que se elimina a los 90 días).
• Los datos devueltos a tu cliente de IA quedan a cargo de ese proveedor según su política; consulta nuestra Política de privacidad, sección 8.

SitesAI App — herramientas

El conector de la App expone 148 herramientas: 71 de lectura y 77 de escritura. Todas aparecen a continuación.

Perfiles de herramientas. Algunos clientes de IA limitan cuántas herramientas puede ofrecer un conector, así que el conector de la App ofrece un subconjunto elegido: añade ?profile= al endpoint. ops (91 herramientas) es el predeterminado y no necesita cadena de consulta: el conjunto operativo del día a día. lite (18 herramientas) es el conjunto reducido de bandeja de entrada / agente telefónico, y full (148 herramientas) es todo, incluidas las herramientas de creación y de administración. Misma clave, mismos datos — solo cambia la lista de herramientas, y todas las herramientas de esta página están en full.

Herramientas de lectura (seguras, nunca cambian nada):

Herramientas de escritura (solo disponibles con una clave o conexión de lectura y escritura; cada una es una acción única y acotada). Hay tres tipos, y cada herramienta lleva su tipo como anotación MCP legible por máquina, para que tu cliente de IA sepa cuál es cuál antes de ejecutarla:

Agregar algo nuevo — crea un registro y no sobrescribe nada (anotada como no destructiva): create_lead, create_lead_type, create_quote, add_quote_line, create_account, create_contact, offer_action, add_comment, create_process, create_sop, add_sop_next, create_checklist, assign_flow, register_tag, file_capture, create_doc_type, create_document, submit_document, assign_to_site, grant_site_company, add_process_step, start_flow_offer, create_job_site, create_contract, record_stock_use, create_action, assign_action, plan_shift_actions, create_sow_item, import_quote_sow, issue_progress_claim.

Cambiar o eliminar algo que ya existe — anotadas como destructivas, para que tu cliente de IA pueda preguntar antes de ejecutarlas: attach_lead_contact, detach_lead_contact, update_lead_type, update_quote_line, delete_quote_line, update_account, delete_account, update_contact, delete_contact, update_worktime, delete_lead, delete_task, update_comment, delete_comment, update_process, update_sop, remove_sop_next, unassign_flow, revoke_tag, update_capture, update_doc_type, set_site_document_requirements, review_submission, revoke_site_company, remove_process_step, move_process_step, set_process_steps, delete_process, delete_sop, void_contract, update_action, update_sow_item, unassign_action.

Llegan a una persona fuera de la app — además de modificar un registro, envían un correo o una notificación a alguien, por eso están anotadas como destructivas y de mundo abierto (el mensaje no se puede recuperar): update_quote, create_task, create_shift, respond_shift, cancel_shift, reoffer_shift, create_shifts_bulk, reassign_shift, update_lead, update_task, add_member, send_contract_for_signature, send_variation_for_approval.

SitesAI Estimate — herramientas

SitesAI Estimate puede funcionar en vivo en la pestaña abierta de tu navegador (los cambios aparecen a medida que el asistente los hace) o en modo en segundo plano, sin pestaña. Encontrarás notas técnicas más detalladas en la documentación MCP del producto.

Qué puedes preguntar

• “¿Qué oportunidades entraron este mes y cuáles todavía no tienen presupuesto?”
• “¿Quién está programado mañana en la obra de Ringwood, y quién no se presentó hoy?”
• “Resume las horas registradas en el trabajo 142 la semana pasada.”
• “¿Qué partes de trabajo de la semana pasada siguen sin firmar, y quién fue el operador en cada uno?”
• “¿A quién se le vencen licencias y seguros en los próximos 30 días, y en qué obras quedan cortos?”
• “Abre mi plano de Kilsyth, calibra la escala con la barra de 10 m y dame los volúmenes de corte y relleno.”
• “Pon la partida de excavación masiva a $28/m³ y muéstrame el nuevo total de la estimación.”

Preguntas frecuentes

Soporte

¿Problemas para conectarte, o una herramienta hace algo que no esperabas? Escribe a admin@sitesai.net — normalmente respondemos en un día hábil. Consulta también nuestra página de soporte y nuestra política de privacidad.