DrillerDB
Servidor MCP remoto para contratistas de pozos de agua y perforación: consulta y actúa sobre trabajos, clientes, facturas, cuadrillas, horarios y registros de pozos.
Documentación
Servidor MCP de DrillerDB
Servidor remoto de Model Context Protocol para DrillerDB, el sistema operativo para contratistas de pozos de agua y perforación. Conecta tu cuenta de DrillerDB a Microsoft Copilot, Claude, ChatGPT, Codex, Cursor, VS Code o cualquier cliente MCP y trabaja con tus trabajos reales, clientes, facturas, cuadrillas y registros de pozos en lenguaje natural.
https://mcp.drillerdb.com
| Transporte | HTTP transmisible |
| Autenticación | OAuth 2.0 (Código de autorización + PKCE, registro dinámico de clientes) |
| Alojamiento | Gestionado por DrillerDB, LLC. Nada que instalar ni autoalojar. |
| Cuenta | Requiere una cuenta activa de DrillerDB (app.drillerdb.com) |
| Nombre del registro | com.drillerdb/drillerdb |
| Documentación completa | drillerdb.com/connectors/mcp |
Este repositorio contiene la documentación pública y el
server.jsonmanifiesto de registro para el servidor MCP de DrillerDB alojado. El servidor en sí es un servicio gestionado y su código fuente no es abierto.
Inicio rápido
Agrega la URL del servidor como conector personalizado en tu cliente MCP. El inicio de sesión OAuth ocurre automáticamente en el primer uso, y el acceso está limitado a tu propia empresa de DrillerDB.
Claude Code
claude mcp add --transport http drillerdb https://mcp.drillerdb.com
Claude (web y escritorio)
Configuración -> Conectores -> Agregar conector personalizado, luego pega
https://mcp.drillerdb.com.
Microsoft Copilot
DrillerDB está preparando el servidor para la certificación MCP de Microsoft. Después de que Microsoft publique el conector certificado, los administradores podrán habilitarlo desde el catálogo de agentes y conectores de Microsoft. Se aplican el mismo inicio de sesión OAuth de DrillerDB y los permisos a nivel de empresa.
Gemini CLI
Instala la extensión de DrillerDB directamente desde este repositorio:
gemini extensions install https://github.com/CraigVG/drillerdb-mcp
Gemini CLI carga el endpoint gestionado desde gemini-extension.json e inicia
el flujo de inicio de sesión OAuth de DrillerDB cuando autenticas el servidor.
Cursor / VS Code / otros clientes
{
"mcpServers": {
"drillerdb": {
"type": "http",
"url": "https://mcp.drillerdb.com"
}
}
}
Tu cliente descubre los endpoints OAuth automáticamente desde
/.well-known/oauth-protected-resource y el encabezado WWW-Authenticate en un
401, por lo que no es necesario configurar un ID de cliente o secreto manualmente.
Lo que puedes preguntar
- "¿Qué trabajos están listos para programar esta semana?"
- "¿Cuánto nos debe todavía Acme Farms y desde cuándo?"
- "Muéstrame el registro de pozo del proyecto Johnson."
- "¿Cómo va el ritmo de ingresos este trimestre comparado con el anterior?"
- "¿Qué equipos de perforación tienen mantenimiento próximo?"
- "Redacta el informe de campo para la cuadrilla de hoy y adjúntalo al trabajo."
Ámbitos de permiso
| Ámbito | Otorga |
|---|---|
mcp:read | Lectura de proyectos, clientes, facturas, propuestas, órdenes de trabajo, cuadrillas, programación, informes de campo, equipos, tarjetas de tiempo, comunicaciones, inventario y registros de pozos |
mcp:write:low | Escrituras trivialmente reversibles, como adjuntar una nota o enviar un informe de campo |
mcp:write:high | Escrituras que cambian el estado, como programar o despachar un trabajo o enviar una factura |
mcp:proposals:write | Generación y entrega de propuestas |
Las herramientas de escritura de mayor riesgo están sujetas a aprobación: la herramienta devuelve un
resultado approval-required primero, y la acción solo se ejecuta una vez que la apruebas
en la consola de DrillerDB. Nada que contacte a un cliente o mueva dinero
ocurre sin una confirmación explícita.
Seguridad
- Aislamiento de inquilinos. Cada consulta se filtra por el
company_idvinculado a tu token OAuth, nunca por la entrada de la herramienta. No hay forma de acceder a los datos de otro contratista. - Registro de auditoría. Cada llamada de herramienta se registra: quién la llamó, qué herramienta, cuándo y el resultado.
- Revocable. Puedes revocar el acceso del conector en cualquier momento desde tu cuenta de DrillerDB, lo que invalida inmediatamente sus tokens.
- Límite de velocidad. Los límites por consumidor protegen el servicio y tu cuenta.
- De primera parte. DrillerDB es propietario de la API y los datos. Ningún dato del conector se vende ni se utiliza para publicidad.
Consulta la Política de privacidad de DrillerDB para saber cómo se recopilan, utilizan y conservan los datos.
Catálogo de herramientas
Herramientas de lectura (37)
| Herramienta | Título |
|---|---|
ar_aging_report | Informe de antigüedad de cuentas por cobrar |
customer_ltv_report | Informe de valor de vida del cliente |
get_communication_detail | Obtener detalle de comunicación |
get_company_proposal_habits | Obtener hábitos de propuesta de la empresa |
get_compliance_form | Obtener formulario de cumplimiento |
get_equipment_detail | Obtener detalle de equipo |
get_geology_at_location | Obtener geología en ubicación |
get_invoice_detail | Obtener detalle de factura |
get_job_profitability | Obtener rentabilidad del trabajo |
get_maintenance_due | Obtener mantenimiento pendiente |
get_project_compliance_status | Obtener estado de cumplimiento del proyecto |
get_project_detail | Obtener detalle del proyecto |
get_project_financials | Obtener finanzas del proyecto |
get_proposal_detail | Obtener detalle de propuesta |
get_quote_detail | Obtener detalle de cotización |
get_quote_engagement | Obtener participación de cotización |
get_timecard_summary | Obtener resumen de tarjetas de tiempo |
get_work_order_detail | Obtener detalle de orden de trabajo |
list_communications | Listar comunicaciones |
list_contacts | Listar contactos |
list_crews | Listar cuadrillas |
list_customers | Listar clientes |
list_equipment | Listar equipos |
list_field_reports | Listar informes de campo |
list_inventory | Listar inventario |
list_invoices | Listar facturas |
list_my_projects | Listar mis proyectos |
list_project_files | Listar archivos del proyecto |
list_projects_by_customer | Listar proyectos por cliente |
list_proposals | Listar propuestas |
list_timecards | Listar tarjetas de tiempo |
list_work_orders | Listar órdenes de trabajo |
query_schedule | Consultar programación |
query_well_logs | Consultar registros de pozos |
revenue_pipeline | Canal de ingresos |
run_report | Ejecutar informe |
total_billed_by_contact | Total facturado por contacto |
Herramientas de escritura (8)
| Herramienta | Título | Ámbito | Sujeta a aprobación |
|---|---|---|---|
attach_note_to_project | Adjuntar nota al proyecto | mcp:write:low | no |
dispatch_project | Despachar proyecto | mcp:write:high | sí |
import_vendor_invoice | Importar factura de proveedor | mcp:write:high | sí |
plan_crew_route | Planificar ruta de cuadrilla | mcp:write:low | no |
schedule_project | Programar proyecto | mcp:write:high | sí |
send_invoice | Enviar factura | mcp:write:high | sí |
submit_field_report | Enviar informe de campo | mcp:write:low | no |
update_project_status | Actualizar estado del proyecto | mcp:write:high | sí |
Todas las herramientas declaran openWorldHint: false — cada una opera solo sobre los datos | |||
| del inquilino de DrillerDB de la empresa que llama. |
Soporte
- Documentación: https://drillerdb.com/connectors/mcp
- Correo electrónico: support@drillerdb.com
- Problemas con esta documentación: abre un issue en este repositorio.
Acerca de DrillerDB
DrillerDB es gestión de proyectos, registro de pozos, programación, propuestas, facturación, seguimiento de equipos e historial de clientes para contratistas de pozos de agua y perforación, en un solo sistema. Obtén más información en drillerdb.com.
Licencia
La documentación en este repositorio tiene licencia MIT. El uso del servidor MCP de DrillerDB alojado se rige por los Términos de servicio de DrillerDB.