Quickbase MCP Server

Um servidor MCP para Quickbase, permitindo integração perfeita com assistentes de IA como o Claude Desktop.

GitHub
15
Experimente este MCPPatrocinado

Documentação

Servidor MCP Quickbase

Um servidor Model Context Protocol (MCP) baseado em TypeScript para Quickbase, projetado para integração perfeita com Claude Desktop e outros assistentes de IA.

📋 Aviso de Projeto Comunitário
Esta é uma integração desenvolvida pela comunidade e não é um produto oficial da Quickbase. Embora utilize as APIs públicas da Quickbase, não é oficialmente suportado pela Quickbase, Inc. Este projeto é fornecido "como está" e mantido pela comunidade. Para produtos e suporte oficiais da Quickbase, visite quickbase.com.

🚀 Início Rápido para Claude Desktop

Verificação de Configuração em Uma Linha

curl -fsSL https://raw.githubusercontent.com/danielbushman/MCP-Quickbase/main/check_dependencies.sh | bash

Configurar Claude Desktop

Adicione isto ao seu arquivo de configuração do Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "quickbase": {
      "command": "npx",
      "args": ["-y", "mcp-quickbase"],
      "env": {
        "QUICKBASE_REALM_HOST": "your-realm.quickbase.com",
        "QUICKBASE_USER_TOKEN": "your-user-token",
        "QUICKBASE_APP_ID": "your-app-id"
      }
    }
  }
}

É isso! Reinicie o Claude Desktop e você poderá começar a usar as ferramentas do Quickbase.

📦 Opções de Instalação

Opção 1: NPM (Recomendado)

# Use directly with npx (no installation needed)
npx -y mcp-quickbase

# Or install globally
npm install -g mcp-quickbase

Opção 2: A partir do Código Fonte

# Clone the repository
git clone https://github.com/danielbushman/MCP-Quickbase.git
cd MCP-Quickbase

# Install dependencies
npm install

# Build the project
npm run build

Para instalação a partir do código fonte, use esta configuração do Claude Desktop:

{
  "mcpServers": {
    "quickbase": {
      "command": "node",
      "args": ["/path/to/MCP-Quickbase/dist/mcp-stdio-server.js"],
      "env": {
        "QUICKBASE_REALM_HOST": "your-realm.quickbase.com",
        "QUICKBASE_USER_TOKEN": "your-user-token",
        "QUICKBASE_APP_ID": "your-app-id"
      }
    }
  }
}

🔧 Configuração

O servidor pode iniciar sem variáveis de ambiente configuradas, mas as ferramentas não funcionarão até que a configuração adequada seja fornecida. Use a ferramenta check_configuration para verificar sua configuração.

Variáveis de Ambiente Obrigatórias

  • QUICKBASE_REALM_HOST - Seu realm do Quickbase (ex.: company.quickbase.com)
  • QUICKBASE_USER_TOKEN - Seu token de API do Quickbase (Obtenha um aqui)

Variáveis de Ambiente Opcionais

  • QUICKBASE_APP_ID - ID de aplicativo padrão

Configurações Opcionais

  • QUICKBASE_CACHE_ENABLED - Ativar cache (true/false, padrão: true)
  • QUICKBASE_CACHE_TTL - Duração do cache em segundos (padrão: 3600)
  • DEBUG - Ativar registro de depuração (true/false, padrão: false)
  • LOG_LEVEL - Nível de registro (DEBUG/INFO/WARN/ERROR, padrão: INFO)

🛠️ Ferramentas Disponíveis (25)

Conexão e Configuração

  • check_configuration - Verificar se a configuração do Quickbase está corretamente definida
  • test_connection - Testar conexão com o Quickbase
  • configure_cache - Configurar comportamento de cache

Gerenciamento de Aplicativos

  • create_app - Criar novos aplicativos Quickbase
  • update_app - Atualizar aplicativos existentes
  • list_tables - Listar todas as tabelas em um aplicativo

Operações de Tabela

  • create_table - Criar novas tabelas
  • update_table - Atualizar propriedades de tabela
  • get_table_fields - Obter informações de campos de uma tabela

Gerenciamento de Campos

  • create_field - Criar novos campos em tabelas
  • get_field - Obter propriedades de um campo específico
  • update_field - Atualizar propriedades de campo
  • delete_field - Excluir um campo de uma tabela

Operações de Registros

  • query_records - Consultar registros com filtragem, ordenação e groupBy
  • create_record - Criar registros individuais
  • update_record - Atualizar registros existentes
  • bulk_create_records - Criar múltiplos registros
  • bulk_update_records - Atualizar múltiplos registros

Operações de Arquivos

  • upload_file - Enviar arquivos para campos de anexo de arquivo
  • download_file - Baixar arquivos de registros

Gerenciamento de Relacionamentos

  • get_relationships - Obter relacionamentos de tabela
  • create_relationship - Criar um novo relacionamento de tabela
  • update_relationship - Atualizar um relacionamento existente
  • delete_relationship - Excluir um relacionamento de tabela

Relatórios

  • run_report - Executar relatórios do Quickbase

📚 Exemplos de Uso

Consulta Básica de Registros

Query all customers from the Customers table

Criar um Novo Registro

Create a new customer record with name "Acme Corp" and status "Active"

Enviar um Arquivo

Upload invoice.pdf to the Documents field in record 123

🔒 Segurança

  • Tokens de API são tratados com segurança e nunca são registrados
  • Todas as operações de arquivo são isoladas no diretório de trabalho
  • Suporta permissões em nível de campo e controles de acesso

📋 Requisitos

  • Node.js 18+
  • Conta Quickbase válida com acesso à API
  • Claude Desktop (para integração MCP)

🤝 Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

📄 Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para detalhes.

🔗 Links