DrillerDB

Servidor MCP remoto para contratantes de poços de água e perfuração: consulte e atue em trabalhos, clientes, faturas, equipes, cronogramas e registros de poços.

GitHubExperimente este MCPPatrocinado

Documentação

Servidor MCP DrillerDB

Servidor remoto Model Context Protocol para DrillerDB, o sistema operacional para contratantes de poços de água e perfuração. Conecte sua conta DrillerDB ao Microsoft Copilot, Claude, ChatGPT, Codex, Cursor, VS Code ou qualquer cliente MCP e trabalhe com seus trabalhos reais, clientes, faturas, equipes e registros de poços em inglês simples.

https://mcp.drillerdb.com


Transporte	HTTP Streamable
Autenticação	OAuth 2.0 (Código de Autorização + PKCE, Registro Dinâmico de Cliente)
Hospedagem	Gerenciado pela DrillerDB, LLC. Nada para instalar ou auto-hospedar.
Conta	Requer uma conta DrillerDB ativa (app.drillerdb.com)
Nome do registro	`com.drillerdb/drillerdb`
Documentação completa	drillerdb.com/connectors/mcp

Este repositório contém a documentação pública e o server.json manifesto de registro para o servidor MCP DrillerDB hospedado. O servidor em si é um serviço gerenciado e seu código-fonte não é aberto.

Início rápido

Adicione a URL do servidor como um conector personalizado no seu cliente MCP. O login OAuth acontece automaticamente no primeiro uso, e o acesso é limitado à sua própria empresa DrillerDB.

Claude Code

claude mcp add --transport http drillerdb https://mcp.drillerdb.com

Claude (web e desktop)

Configurações -> Conectores -> Adicionar conector personalizado, depois cole https://mcp.drillerdb.com.

Microsoft Copilot

A DrillerDB está preparando o servidor para a certificação MCP da Microsoft. Após a Microsoft publicar o conector certificado, os administradores podem habilitá-lo no catálogo de agentes e conectores da Microsoft. O mesmo login OAuth DrillerDB e permissões de nível de empresa se aplicam.

Gemini CLI

Instale a extensão DrillerDB diretamente deste repositório:

gemini extensions install https://github.com/CraigVG/drillerdb-mcp

O Gemini CLI carrega o endpoint gerenciado de gemini-extension.json e inicia o fluxo de login OAuth DrillerDB quando você autentica o servidor.

Cursor / VS Code / outros clientes

{
  "mcpServers": {
    "drillerdb": {
      "type": "http",
      "url": "https://mcp.drillerdb.com"
    }
  }
}

Seu cliente descobre os endpoints OAuth automaticamente a partir de /.well-known/oauth-protected-resource e o cabeçalho WWW-Authenticate em um 401, então nenhum ID de cliente ou segredo precisa ser configurado manualmente.

O que você pode perguntar

"Quais trabalhos estão prontos para agendar esta semana?"
"O que a Acme Farms ainda nos deve, e há quanto tempo?"
"Mostre-me o registro do poço para o projeto Johnson."
"Como está o ritmo da receita neste trimestre comparado ao anterior?"
"Quais sondas têm manutenção prevista?"
"Redija o relatório de campo para a equipe de hoje e anexe-o ao trabalho."

Escopos de permissão

Escopo	Concede
`mcp:read`	Ler projetos, clientes, faturas, propostas, ordens de serviço, equipes, agenda, relatórios de campo, equipamentos, cartões de ponto, comunicações, inventário e registros de poços
`mcp:write:low`	Gravações trivialmente reversíveis, como anexar uma nota ou enviar um relatório de campo
`mcp:write:high`	Gravações que alteram o estado, como agendar ou despachar um trabalho ou enviar uma fatura
`mcp:proposals:write`	Geração e entrega de propostas

Ferramentas de gravação de maior risco são controladas por aprovação: a ferramenta retorna um resultado approval-required primeiro, e a ação só é executada após você aprová-la no console DrillerDB. Nada que entre em contato com um cliente ou mova dinheiro acontece sem uma confirmação explícita.

Segurança

Isolamento de locatário. Cada consulta é filtrada pelo company_id vinculado ao seu token OAuth, nunca pela entrada da ferramenta. Não há como acessar dados de outro contratante.
Registro de auditoria. Cada chamada de ferramenta é registrada: quem chamou, qual ferramenta, quando, e o resultado.
Revogável. Você pode revogar o acesso do conector a qualquer momento na sua conta DrillerDB, o que invalida imediatamente seus tokens.
Limite de taxa. Limites por consumidor protegem o serviço e sua conta.
Primeira parte. A DrillerDB é proprietária da API e dos dados. Nenhum dado do conector é vendido ou usado para publicidade.

Consulte a Política de Privacidade da DrillerDB para saber como os dados são coletados, usados e retidos.

Catálogo de ferramentas

Ferramentas de leitura (37)

Ferramenta	Título
`ar_aging_report`	Relatório de Envelhecimento de Contas a Receber
`customer_ltv_report`	Relatório de Valor do Ciclo de Vida do Cliente
`get_communication_detail`	Obter Detalhe de Comunicação
`get_company_proposal_habits`	Obter Hábitos de Proposta da Empresa
`get_compliance_form`	Obter Formulário de Conformidade
`get_equipment_detail`	Obter Detalhe de Equipamento
`get_geology_at_location`	Obter Geologia no Local
`get_invoice_detail`	Obter Detalhe de Fatura
`get_job_profitability`	Obter Rentabilidade do Trabalho
`get_maintenance_due`	Obter Manutenção Prevista
`get_project_compliance_status`	Obter Status de Conformidade do Projeto
`get_project_detail`	Obter Detalhe do Projeto
`get_project_financials`	Obter Financeiro do Projeto
`get_proposal_detail`	Obter Detalhe da Proposta
`get_quote_detail`	Obter Detalhe do Orçamento
`get_quote_engagement`	Obter Engajamento do Orçamento
`get_timecard_summary`	Obter Resumo do Cartão de Ponto
`get_work_order_detail`	Obter Detalhe da Ordem de Serviço
`list_communications`	Listar Comunicações
`list_contacts`	Listar Contatos
`list_crews`	Listar Equipes
`list_customers`	Listar Clientes
`list_equipment`	Listar Equipamentos
`list_field_reports`	Listar Relatórios de Campo
`list_inventory`	Listar Inventário
`list_invoices`	Listar Faturas
`list_my_projects`	Listar Meus Projetos
`list_project_files`	Listar Arquivos do Projeto
`list_projects_by_customer`	Listar Projetos por Cliente
`list_proposals`	Listar Propostas
`list_timecards`	Listar Cartões de Ponto
`list_work_orders`	Listar Ordens de Serviço
`query_schedule`	Consultar Agenda
`query_well_logs`	Consultar Registros de Poços
`revenue_pipeline`	Pipeline de Receita
`run_report`	Executar Relatório
`total_billed_by_contact`	Total Faturado por Contato

Ferramentas de gravação (8)

Ferramenta	Título	Escopo	Aprovação necessária
`attach_note_to_project`	Anexar Nota ao Projeto	`mcp:write:low`	não
`dispatch_project`	Despachar Projeto	`mcp:write:high`	sim
`import_vendor_invoice`	Importar Fatura de Fornecedor	`mcp:write:high`	sim
`plan_crew_route`	Planejar Rota da Equipe	`mcp:write:low`	não
`schedule_project`	Agendar Projeto	`mcp:write:high`	sim
`send_invoice`	Enviar Fatura	`mcp:write:high`	sim
`submit_field_report`	Enviar Relatório de Campo	`mcp:write:low`	não
`update_project_status`	Atualizar Status do Projeto	`mcp:write:high`	sim
Todas as ferramentas declaram `openWorldHint: false` — cada uma opera apenas nos dados do locatário
DrillerDB da própria empresa que está chamando.

Suporte

Documentação: https://drillerdb.com/connectors/mcp
E-mail: support@drillerdb.com
Problemas com esta documentação: abra um problema neste repositório.

Sobre a DrillerDB

A DrillerDB é gerenciamento de projetos, registro de poços, agendamento, propostas, faturamento, rastreamento de equipamentos e histórico de clientes para contratantes de poços de água e perfuração, em um único sistema. Saiba mais em drillerdb.com.

Licença

A documentação neste repositório é licenciada sob MIT. O uso do servidor MCP DrillerDB hospedado é regido pelos Termos de Serviço da DrillerDB.