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
TransporteHTTP transmisible
AutenticaciónOAuth 2.0 (Código de autorización + PKCE, registro dinámico de clientes)
AlojamientoGestionado por DrillerDB, LLC. Nada que instalar ni autoalojar.
CuentaRequiere una cuenta activa de DrillerDB (app.drillerdb.com)
Nombre del registrocom.drillerdb/drillerdb
Documentación completadrillerdb.com/connectors/mcp

Este repositorio contiene la documentación pública y el server.json manifiesto 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

ÁmbitoOtorga
mcp:readLectura 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:lowEscrituras trivialmente reversibles, como adjuntar una nota o enviar un informe de campo
mcp:write:highEscrituras que cambian el estado, como programar o despachar un trabajo o enviar una factura
mcp:proposals:writeGeneració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_id vinculado 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)

HerramientaTítulo
ar_aging_reportInforme de antigüedad de cuentas por cobrar
customer_ltv_reportInforme de valor de vida del cliente
get_communication_detailObtener detalle de comunicación
get_company_proposal_habitsObtener hábitos de propuesta de la empresa
get_compliance_formObtener formulario de cumplimiento
get_equipment_detailObtener detalle de equipo
get_geology_at_locationObtener geología en ubicación
get_invoice_detailObtener detalle de factura
get_job_profitabilityObtener rentabilidad del trabajo
get_maintenance_dueObtener mantenimiento pendiente
get_project_compliance_statusObtener estado de cumplimiento del proyecto
get_project_detailObtener detalle del proyecto
get_project_financialsObtener finanzas del proyecto
get_proposal_detailObtener detalle de propuesta
get_quote_detailObtener detalle de cotización
get_quote_engagementObtener participación de cotización
get_timecard_summaryObtener resumen de tarjetas de tiempo
get_work_order_detailObtener detalle de orden de trabajo
list_communicationsListar comunicaciones
list_contactsListar contactos
list_crewsListar cuadrillas
list_customersListar clientes
list_equipmentListar equipos
list_field_reportsListar informes de campo
list_inventoryListar inventario
list_invoicesListar facturas
list_my_projectsListar mis proyectos
list_project_filesListar archivos del proyecto
list_projects_by_customerListar proyectos por cliente
list_proposalsListar propuestas
list_timecardsListar tarjetas de tiempo
list_work_ordersListar órdenes de trabajo
query_scheduleConsultar programación
query_well_logsConsultar registros de pozos
revenue_pipelineCanal de ingresos
run_reportEjecutar informe
total_billed_by_contactTotal facturado por contacto

Herramientas de escritura (8)

HerramientaTítuloÁmbitoSujeta a aprobación
attach_note_to_projectAdjuntar nota al proyectomcp:write:lowno
dispatch_projectDespachar proyectomcp:write:high
import_vendor_invoiceImportar factura de proveedormcp:write:high
plan_crew_routePlanificar ruta de cuadrillamcp:write:lowno
schedule_projectProgramar proyectomcp:write:high
send_invoiceEnviar facturamcp:write:high
submit_field_reportEnviar informe de campomcp:write:lowno
update_project_statusActualizar estado del proyectomcp:write:high
Todas las herramientas declaran openWorldHint: false — cada una opera solo sobre los datos
del inquilino de DrillerDB de la empresa que llama.

Soporte

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.