Keboola

oficial

Construa fluxos de dados robustos, integrações e análises em uma única plataforma intuitiva.

O que você pode fazer com Keboola MCP?

  • Tabelas de armazenamento de consultas — Peça ao seu assistente para explorar buckets e tabelas, ou execute consultas SQL para encontrar os principais clientes por receita.
  • Criar transformações SQL — Descreva uma transformação em linguagem natural, como unir tabelas de clientes e pedidos, e tenha ela criada para você.
  • Gerenciar componentes e jobs — Liste extratores e gravadores, inicie jobs de extração de dados e recupere detalhes de execução para seus pipelines.
  • Construir fluxos de trabalho — Crie e gerencie Fluxos Condicionais ou Orquestradores para automatizar pipelines de dados de múltiplas etapas.
  • Implantar aplicativos de dados — Crie e gerencie Streamlit Data Apps que exibem resultados de consultas sobre seus dados de armazenamento.
  • Trabalhar em branches de desenvolvimento — Escopo de todas as operações para um branch de desenvolvimento para testar alterações com segurança sem afetar a produção.

Documentação

Ask DeepWiki

Servidor MCP Keboola

Conecte seus agentes de IA, clientes MCP (Cursor, Claude, Windsurf, VS Code ...) e outros assistentes de IA ao Keboola. Exponha dados, transformações, consultas SQL e acionadores de jobs—sem necessidade de código de integração. Entregue os dados certos aos agentes quando e onde eles precisarem.

Visão Geral

O Servidor MCP Keboola é uma ponte de código aberto entre seu projeto Keboola e ferramentas modernas de IA. Ele transforma recursos do Keboola—como acesso a armazenamento, transformações SQL e acionadores de jobs—em ferramentas acionáveis para Claude, Cursor, CrewAI, LangChain, Amazon Q e outros.

Recursos

Com o Agente de IA e o Servidor MCP, você pode:

  • Armazenamento: Consultar tabelas diretamente e gerenciar descrições de tabelas ou buckets
  • Componentes: Criar, listar e inspecionar extratores, gravadores, aplicativos de dados e configurações de transformação
  • SQL: Criar transformações SQL com linguagem natural
  • Jobs: Executar componentes e transformações, e recuperar detalhes de execução de jobs
  • Fluxos: Construir e gerenciar pipelines de fluxo de trabalho usando Fluxos Condicionais e Fluxos Orquestradores.
  • Aplicativos de Dados: Criar, implantar e gerenciar Aplicativos de Dados Streamlit do Keboola exibindo suas consultas sobre dados de armazenamento.
  • Metadados: Pesquisar, ler e atualizar documentação do projeto e metadados de objetos usando linguagem natural
  • Branches de Desenvolvimento: Trabalhar com segurança em branches de desenvolvimento fora da produção, onde todas as operações são limitadas ao branch selecionado.

🚀 Início Rápido: Servidor MCP Remoto (Forma Mais Fácil)

A forma mais fácil de usar o Servidor MCP Keboola é através do nosso Servidor MCP Remoto. Esta solução hospedada elimina a necessidade de configuração local, instalação ou preparação.

O que é o Servidor MCP Remoto?

Nosso servidor remoto é hospedado em cada stack multi-tenant do Keboola e suporta autenticação OAuth. Você pode se conectar a ele a partir de qualquer assistente de IA que suporte conexão HTTP Streamable remota e autenticação OAuth.

Como Conectar

  1. Obtenha a URL do seu servidor remoto: Navegue até Configurações do Projeto Keboola → aba MCP Server
  2. Copie a URL do servidor: Ela terá a aparência de https://mcp.<YOUR_REGION>.keboola.com/mcp
  3. Configure seu assistente de IA: Cole a URL nas configurações MCP do seu assistente de IA
  4. Autentique-se: Você será solicitado a fazer login com sua conta Keboola. Em qual(is) projeto(s) trabalhar é escolhido depois, na conversa (por exemplo, "liste meus projetos Keboola" / "use o projeto X")

Clientes Suportados

  • Cursor: Use o botão "Instalar no Cursor" nas configurações do Servidor MCP do seu projeto ou clique neste botão Install MCP Server
  • Claude Desktop: Adicione a integração via Configurações → Integrações
  • Claude Code: Instale usando claude mcp add --transport http keboola <URL> (veja abaixo para detalhes)
  • Windsurf: Configure com a URL do servidor remoto
  • Make: Configure com a URL do servidor remoto
  • Outros clientes MCP: Configure com a URL do servidor remoto

Configuração do Claude Code

O Claude Code é uma ferramenta de interface de linha de comando que permite interagir com o Claude usando seu terminal. Você pode instalar a integração do Servidor MCP Keboola usando um comando simples.

Instalação:

Execute o seguinte comando no seu terminal, substituindo <YOUR_REGION> pela sua região Keboola:

claude mcp add --transport http keboola https://mcp.<YOUR_REGION>.keboola.com/mcp

Comandos específicos por região:

RegiãoComando de Instalação
US Virgínia AWSclaude mcp add --transport http keboola https://mcp.keboola.com/mcp
US Virgínia GCPclaude mcp add --transport http keboola https://mcp.us-east4.gcp.keboola.com/mcp
EU Frankfurt AWSclaude mcp add --transport http keboola https://mcp.eu-central-1.keboola.com/mcp
EU Irlanda Azureclaude mcp add --transport http keboola https://mcp.north-europe.azure.keboola.com/mcp
EU Frankfurt GCPclaude mcp add --transport http keboola https://mcp.europe-west3.gcp.keboola.com/mcp

Uso:

Após a instalação, você pode usar o Servidor MCP Keboola no Claude Code digitando /mcp na sua conversa e selecionando as ferramentas Keboola que deseja usar.

Autenticação:

Quando você usar o Servidor MCP Keboola no Claude Code pela primeira vez, uma janela do navegador abrirá solicitando que você:

  1. Faça login com sua conta Keboola
  2. Autorize a conexão

Após a autenticação, você pode começar a usar as ferramentas Keboola diretamente do Claude Code. A seleção do projeto acontece depois, na conversa — basta perguntar ao Claude qual(is) projeto(s) Keboola usar.

Para instruções detalhadas de configuração e URLs específicas por região, veja nossa documentação de Configuração do Servidor Remoto.

Usando Branches de Desenvolvimento

Você pode trabalhar com segurança em branches de desenvolvimento do Keboola sem afetar seus dados de produção. Os Servidores MCP hospedados remotamente respeitam o parâmetro KBC_BRANCH_ID e limitarão todas as operações ao branch especificado. Você pode encontrar o ID do branch de desenvolvimento na URL ao navegar para o branch de desenvolvimento na interface, por exemplo: https://connection.us-east4.gcp.keboola.com/admin/projects/PROJECT_ID/branch/BRANCH_ID/dashboard. O ID do branch deve ser incluído em cada solicitação usando o cabeçalho X-Branch-Id: <branchId>, caso contrário, o Servidor MCP usa o branch de produção como padrão. Isso deve ser gerenciado pelo cliente de IA ou pelo ambiente que gerencia a conexão do servidor.

Autorização de Ferramentas e Controle de Acesso

Ao usar transportes baseados em HTTP (HTTP Streamable), você pode controlar quais ferramentas estão disponíveis para os clientes usando cabeçalhos HTTP. Isso é útil para restringir as capacidades dos agentes de IA ou aplicar políticas de conformidade.

Cabeçalhos de Autorização

CabeçalhoDescriçãoExemplo
X-Allowed-ToolsLista separada por vírgulas de ferramentas permitidasget_configs,get_buckets,query_data
X-Disallowed-ToolsLista separada por vírgulas de ferramentas a excluircreate_config,run_job
X-Read-Only-ModeRestringir apenas a ferramentas somente leituratrue, 1 ou yes

Comportamento dos Filtros

Os filtros são aplicados em ordem: permitidas → interseção somente leitura → exclusão de desautorizadas. Cabeçalhos vazios = sem restrição.

Ferramentas Somente Leitura

Ferramentas somente leitura são aquelas anotadas com readOnlyHint=True. Essas ferramentas apenas recuperam informações sem fazer alterações no seu projeto Keboola. Para a lista atual de ferramentas somente leitura, veja o arquivo TOOLS.md, que é um snapshot gerado automaticamente do conjunto real de ferramentas.

Exemplo: Acesso Somente Leitura

X-Read-Only-Mode: true

Para documentação detalhada, veja developers.keboola.com/integrate/mcp/#tool-authorization-and-access-control.


Configuração Local do Servidor MCP (Forma Personalizada ou de Desenvolvimento)

Execute o servidor MCP na sua própria máquina para controle total e desenvolvimento fácil. Escolha esta opção quando quiser personalizar ferramentas, depurar localmente ou iterar rapidamente. Você instalará o servidor, autenticará (um login único no navegador — sem token para colar) e o iniciará. Esta abordagem oferece máxima flexibilidade (ferramentas personalizadas, registro local, iteração offline), mas requer configuração manual e você gerencia atualizações e segredos por conta própria.

O servidor suporta múltiplas opções de transporte, que podem ser selecionadas fornecendo o argumento --transport <transport> ao iniciar o servidor:

  • stdio - Padrão quando --transport não é especificado. Entrada/saída padrão, tipicamente usado para implantação local com um único cliente.
  • streamable-http - Executa o servidor remotamente via HTTP com um canal de streaming bidirecional, permitindo que o cliente e o servidor troquem mensagens continuamente. Conecte via /mcp (por exemplo, http://localhost:8000/mcp).
  • http-compat - Um alias para streamable-http, mantido para compatibilidade retroativa.

Para trabalhar com seu projeto Keboola, o servidor precisa de duas coisas: sua Região Keboola (KBC_STORAGE_API_URL) e uma forma de autenticar. A forma recomendada é um login único no navegador — você nunca cria, copia ou cola um token. Opcionalmente, defina KBC_BRANCH_ID para trabalhar dentro de um branch de desenvolvimento.

Algumas das variáveis não são obtidas dos cabeçalhos das solicitações:

  • KBC_STORAGE_API_URL: um servidor iniciado com sua própria URL da Storage API (o parâmetro --api-url ou a variável de ambiente KBC_STORAGE_API_URL) atende apenas aquele stack Keboola. Um cabeçalho X-Storage-Api-Url solicitando um host diferente é ignorado (um aviso é registrado) — o servidor mantém sua própria URL para a solicitação. Inicie o servidor sem uma URL da Storage API própria se quiser que cada solicitação escolha seu stack.
  • KBC_KUBERNETES_TOKEN_PATH (apenas servidores implantados, veja docs/kubernetes-sa-auth.md): lido apenas do ambiente, nunca de um cabeçalho.
  • KBC_WORKSPACE_ID / KBC_WORKSPACE_SCHEMA: mesma ideia da URL da Storage API acima — um servidor iniciado com seu próprio pin de workspace (via qualquer variável, ou --workspace-id) mantém esse pin para cada solicitação; um cabeçalho X-Workspace-Id ou X-Workspace-Schema solicitando um workspace diferente é ignorado (um aviso é registrado). Um servidor sem pin próprio (o caso compartilhado multi-usuário) continua obtendo o pin da solicitação, por solicitação, conforme descrito abaixo.

Fazendo Login

Entre uma vez com seu navegador; o servidor armazena a sessão e a renova automaticamente, então não há tokens para gerenciar:

uvx keboola_mcp_server login --api-url https://connection.YOUR_REGION.keboola.com

Isso abre seu navegador para entrar no Keboola e salva a sessão do stack em ~/.keboola/mcp/credentials.json (legível apenas por você, uma entrada por stack). Depois, inicie o servidor apenas com KBC_STORAGE_API_URL definido — sem necessidade de token. Em qual(is) projeto(s) trabalhar é escolhido depois, na conversa (get_accessible_projects / set_project_scope), não durante o login.

ComandoO que faz
login --api-url <url>Entrar em um stack
login --forceEntrar novamente / trocar de conta
login --show-tokenExibir o token da sessão atual (depuração)
logout [--api-url <url>] [--all]Remover a sessão armazenada para um stack (ou todos os stacks)

Quando você inicia o servidor via stdio em um terminal interativo sem sessão armazenada, ele executa este login no navegador automaticamente na primeira inicialização. Clientes MCP (Claude, Cursor, …) iniciam o servidor em segundo plano, onde um navegador não pode abrir, então execute login uma vez você mesmo primeiro.

Iniciando sem uma conta Keboola

Você também pode iniciar o servidor apenas com KBC_STORAGE_API_URL e sem credenciais. Ele entra no modo bootstrap: ferramentas que precisam de acesso ao Keboola explicam como obter uma credencial, e uma ferramenta funciona sem uma — create_project. Ela cria um novo projeto Keboola, assina a sessão nele e retorna uma URL de confirmação. Abrir essa URL em um navegador e entrar torna o projeto permanentemente seu; até então, ele é temporário e o Keboola pode reivindicá-lo, e uma vez que você confirme, a sessão criada pela ferramenta é revogada e você continua com seu próprio login.

Isso requer um stack com provisionamento de agente habilitado; em outros lugares, a ferramenta relata que não está disponível.

Autenticando sem navegador

Para contêineres ou CI onde um login no navegador não é possível, forneça um token de acesso ou acesso pessoal do Keboola diretamente — defina KBC_STORAGE_TOKEN (variável de ambiente) ou envie o cabeçalho X-StorageAPI-Token — junto com KBC_PROJECT_ID (ou o cabeçalho X-KBC-ProjectId) para selecionar o projeto. Em transportes HTTP, estes podem ser fornecidos por solicitação como cabeçalhos, então cada solicitação carrega suas próprias credenciais.

KBC_WORKSPACE_ID

Fixar consultas a um workspace específico, já existente, pelo seu ID em vez da busca baseada em esquema acima, e tem precedência sobre KBC_WORKSPACE_SCHEMA quando ambos estão definidos. Esta é a opção que um chamador de Data App / kai-agent fornece, como o cabeçalho X-Workspace-Id, para que o Kai incorporado nesse aplicativo consulte apenas através do seu próprio workspace.

Defina via variável de ambiente KBC_WORKSPACE_ID, o sinalizador de CLI --workspace-id, ou (por solicitação, para implantações multi-usuário) o cabeçalho X-Workspace-Id.

KBC_STORAGE_API_URL (Região Keboola)

A URL da API da sua Região Keboola depende da sua região de implantação. Você pode determinar sua região observando a URL no seu navegador quando estiver logado no seu projeto Keboola:

RegiãoURL da API
AWS América do Nortehttps://connection.keboola.com
AWS Europahttps://connection.eu-central-1.keboola.com
Google Cloud UEhttps://connection.europe-west3.gcp.keboola.com
Google Cloud EUAhttps://connection.us-east4.gcp.keboola.com
Azure UEhttps://connection.north-europe.azure.keboola.com

KBC_BRANCH_ID (Opcional)

Para operar em um branch de desenvolvimento Keboola específico, defina o ID do branch usando o parâmetro KBC_BRANCH_ID. O servidor MCP limita sua funcionalidade ao branch especificado, garantindo que todas as alterações permaneçam isoladas e não afetem o branch de produção.

  • Se não for fornecido, o servidor usa o branch de produção por padrão.
  • Para trabalho de desenvolvimento, defina KBC_BRANCH_ID para o ID numérico do seu branch (por exemplo, 123456). Você pode encontrar o ID do branch de desenvolvimento na URL ao navegar para o branch de desenvolvimento na interface, por exemplo: https://connection.us-east4.gcp.keboola.com/admin/projects/PROJECT_ID/branch/BRANCH_ID/dashboard.
  • Em transportes remotos, você pode substituir por solicitação usando o cabeçalho HTTP X-Branch-Id: <branchId> ou KBC_BRANCH_ID: <branchId>.

Instalação

Certifique-se de ter:

  • Python 3.10+ instalado
  • Acesso a um projeto Keboola com direitos de administrador
  • Seu cliente MCP preferido (Claude, Cursor, etc.)

Nota: Certifique-se de ter o uv instalado. O cliente MCP o usará para baixar e executar automaticamente o Keboola MCP Server. Instalando o uv:

macOS/Linux:

#if homebrew is not installed on your machine use:
# /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install using Homebrew
brew install uv

Windows:

# Using the installer script
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# Or using pip
pip install uv

# Or using winget
winget install --id=astral-sh.uv -e

Para mais opções de instalação, consulte a documentação oficial do uv.

Executando o Keboola MCP Server

Existem quatro maneiras de usar o Keboola MCP Server, dependendo das suas necessidades:

Opção A: Modo Integrado (Recomendado)

Neste modo, o Claude ou o Cursor iniciam automaticamente o servidor MCP para você.

  1. Faça login uma vez em um terminal para que uma sessão seja armazenada (o cliente inicia o servidor em segundo plano, onde um navegador não pode abrir):
    uvx keboola_mcp_server login --api-url https://connection.YOUR_REGION.keboola.com
    
  2. Configure seu cliente MCP (Claude/Cursor) com as configurações abaixo — apenas KBC_STORAGE_API_URL é necessário.
  3. O cliente iniciará automaticamente o servidor MCP quando necessário.

Configuração do Claude Desktop

  1. Vá para Claude (canto superior esquerdo da tela) -> Configurações → Desenvolvedor → Editar Config (se você não vir o claude_desktop_config.json, crie-o)
  2. Adicione a seguinte configuração:
  3. Reinicie o Claude desktop para que as alterações tenham efeito
{
  "mcpServers": {
    "keboola": {
      "command": "uvx",
      "args": ["keboola_mcp_server --transport <transport>"],
      "env": {
        "KBC_STORAGE_API_URL": "https://connection.YOUR_REGION.keboola.com",
        "KBC_BRANCH_ID": "your_branch_id_optional"
      }
    }
  }
}

Locais dos arquivos de configuração:

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

Configuração do Cursor

  1. Vá para Configurações → MCP
  2. Clique em "+ Adicionar novo servidor MCP global"
  3. Configure com estas configurações:
{
  "mcpServers": {
    "keboola": {
      "command": "uvx",
      "args": ["keboola_mcp_server --transport <transport>"],
      "env": {
        "KBC_STORAGE_API_URL": "https://connection.YOUR_REGION.keboola.com",
        "KBC_BRANCH_ID": "your_branch_id_optional"
      }
    }
  }
}

Nota: Use nomes curtos e descritivos para servidores MCP. Como o nome completo da ferramenta inclui o nome do servidor e deve permanecer abaixo de ~60 caracteres, nomes mais longos podem ser filtrados no Cursor e não serão exibidos ao Agente.

Configuração do Cursor para Windows WSL

Ao executar o servidor MCP do Subsistema Windows para Linux com o Cursor AI, use esta configuração:

{
  "mcpServers": {
    "keboola":{
      "command": "wsl.exe",
      "args": [
          "bash",
          "-c '",
          "export KBC_STORAGE_API_URL=https://connection.YOUR_REGION.keboola.com &&",
          "export KBC_BRANCH_ID=your_branch_id_optional &&",
          "/snap/bin/uvx keboola_mcp_server --transport <transport>",
          "'"
      ]
    }
  }
}

Opção B: Modo de Desenvolvimento Local

Para desenvolvedores que trabalham no código do servidor MCP:

  1. Clone o repositório e configure um ambiente local
  2. Configure o Claude/Cursor para usar seu caminho Python local:
{
  "mcpServers": {
    "keboola": {
      "command": "/absolute/path/to/.venv/bin/python",
      "args": [
        "-m",
        "keboola_mcp_server --transport <transport>"
      ],
      "env": {
        "KBC_STORAGE_API_URL": "https://connection.YOUR_REGION.keboola.com",
        "KBC_BRANCH_ID": "your_branch_id_optional"
      }
    }
  }
}

Opção C: Modo CLI Manual (Somente para Testes)

Você pode executar o servidor manualmente em um terminal para testes ou depuração:

# Sign in once (stores a session under ~/.keboola/mcp), then start the server.
export KBC_STORAGE_API_URL=https://connection.YOUR_REGION.keboola.com
uvx keboola_mcp_server login --api-url "$KBC_STORAGE_API_URL"

uvx keboola_mcp_server --transport streamable-http

Nota: Este modo é principalmente para depuração ou testes. Para uso normal com Claude ou Cursor, você não precisa executar o servidor manualmente.

Nota: O servidor usará o transporte Streamable HTTP e escutará em localhost:8000 para conexões de entrada em /mcp. Você pode usar os parâmetros --port e --host para fazê-lo escutar em outro lugar.

Opção D: Usando Docker

Um contêiner não pode abrir um navegador, então autentique com um token (veja Autenticando sem navegador): defina KBC_STORAGE_TOKEN para um token de acesso/pessoal Keboola e KBC_PROJECT_ID para o projeto de destino. (Via HTTP, você pode passar os cabeçalhos X-StorageAPI-Token / X-KBC-ProjectId por solicitação e omitir estes.)

docker pull keboola/mcp-server:latest

docker run \
  --name keboola_mcp_server \
  --rm \
  -it \
  -p 127.0.0.1:8000:8000 \
  -e KBC_STORAGE_API_URL="https://connection.YOUR_REGION.keboola.com" \
  -e KBC_STORAGE_TOKEN="YOUR_KEBOOLA_TOKEN" \
  -e KBC_PROJECT_ID="YOUR_PROJECT_ID" \
  -e KBC_BRANCH_ID="YOUR_BRANCH_ID_OPTIONAL" \
  keboola/mcp-server:latest \
  --transport streamable-http \
  --host 0.0.0.0

Nota: O servidor usará o transporte Streamable HTTP e escutará em localhost:8000 para conexões de entrada em /mcp. Você pode alterar -p para mapear a porta do contêiner para outro lugar.

Preciso Iniciar o Servidor Eu Mesmo?

CenárioPrecisa Executar Manualmente?Use Esta Configuração
Usando Claude/CursorNãoConfigure MCP nas configurações do aplicativo
Desenvolvendo MCP localmenteNão (Claude inicia)Aponte a configuração para o caminho do python
Testando CLI manualmenteSimUse o terminal para executar
Usando DockerSimExecute o contêiner docker

Usando o Servidor MCP

Depois que seu cliente MCP (Claude/Cursor) estiver configurado e em execução, você pode começar a consultar seus dados Keboola:

Verifique Sua Configuração

Você pode começar com uma consulta simples para confirmar que tudo está funcionando:

What buckets and tables are in my Keboola project?

Exemplos do Que Você Pode Fazer

Exploração de Dados:

  • "Quais tabelas contêm informações de clientes?"
  • "Execute uma consulta para encontrar os 10 principais clientes por receita"

Análise de Dados:

  • "Analise meus dados de vendas por região no último trimestre"
  • "Encontre correlações entre idade do cliente e frequência de compra"

Pipelines de Dados:

  • "Crie uma transformação SQL que una as tabelas de clientes e pedidos"
  • "Inicie o trabalho de extração de dados para meu componente Salesforce"

Compatibilidade

Suporte a Clientes MCP

Cliente MCPStatus de SuporteMétodo de Conexão
Claude (Desktop e Web)✅ suportadostdio
Cursor✅ suportadostdio
Windsurf, Zed, Replit✅ Suportadostdio
Codeium, Sourcegraph✅ SuportadoStreamable HTTP
Clientes MCP Personalizados✅ SuportadoStreamable HTTP ou stdio

Ferramentas Suportadas

Nota: Seus agentes de IA se ajustarão automaticamente a novas ferramentas.

Para uma lista completa de ferramentas disponíveis com descrições detalhadas, parâmetros e exemplos de uso, consulte TOOLS.md.

Solução de Problemas

Problemas Comuns

ProblemaSolução
Erros de AutenticaçãoExecute novamente keboola_mcp_server login (ou, se autenticando com um token, verifique o token e KBC_PROJECT_ID)
Tempo de Conexão ExcedidoVerifique a conectividade de rede

Desenvolvimento

Instalação

Configuração básica:

uv sync --extra dev

Com a configuração básica, você pode usar uv run tox para executar testes e verificar o estilo do código.

Configuração recomendada:

uv sync --extra dev --extra tests --extra integtests --extra codestyle

Com a configuração recomendada, pacotes para testes e verificação de estilo de código serão instalados, o que permite que IDEs como VsCode ou Cursor verifiquem o código ou executem testes durante o desenvolvimento.

Testes de integração

Para executar testes de integração localmente, use uv run tox -e integtests. NOTA: Você precisará definir as seguintes variáveis de ambiente:

  • INTEGTEST_POOL_STORAGE_API_URL
  • INTEGTEST_STORAGE_TOKENS
  • INTEGTEST_STORAGE_TOKEN_STORAGE_BRANCHES

Para obter esses valores, você precisa de projetos Keboola dedicados para testes de integração. Cada sessão de teste cria seu próprio workspace somente leitura, portanto, nenhum esquema de workspace precisa ser configurado. Consulte integtests/README.md para instruções detalhadas de configuração e documentação de design.

Atualizando uv.lock

Atualize o arquivo uv.lock se você adicionou ou removeu dependências. Considere também atualizar o lock com versões mais recentes de dependências ao criar um release (uv lock --upgrade).

Atualizando a Documentação de Ferramentas

Quando você fizer alterações em qualquer descrição de ferramenta (docstrings em funções de ferramenta), você deve regenerar o arquivo de documentação TOOLS.md para refletir essas alterações:

uv run python -m src.keboola_mcp_server.generate_tool_docs

Lançamento (Release)

Nós não fazemos um release para cada PR mesclado. O trabalho chega ao trunk (main) continuamente, e lançamos periodicamente depois que as alterações são re-testadas juntas — isso evita quebrar configurações de trabalho para os usuários.

Um release é feito enviando uma ou duas tags git:

  • vX.Y.Z — o release do servidor MCP (sempre)
  • agent-vX.Y.Z — o release do In Platform Agent (somente quando o agente também está sendo lançado)

Qualquer tag aciona o CI release.yml, que compila e publica a imagem Docker. O KaiBench é executado apenas em tags de produção vX.Y.Z (não agent-vX.Y.Z, e não pré-lançamentos -dev.). Use a habilidade release-notes — ela prepara as notas de release e o rascunho do PR e orienta na marcação de ambas vX.Y.Z e agent-vX.Y.Z.

Suporte e Feedback

⭐ A principal maneira de obter ajuda, relatar bugs ou solicitar recursos é abrindo uma issue no GitHub. ⭐

A equipe de desenvolvimento monitora ativamente as issues e responderá o mais rápido possível. Para informações gerais sobre Keboola, use os recursos abaixo.

Recursos

Conecte-se