MCP Tools
O MCP Server disponibiliza 25+ tools para operacoes de deploy.
Deploy Operations
runner_deploy
Executa pipeline de deploy completo.
Parametros:
| Nome | Tipo | Obrigatorio | Descricao |
|---|---|---|---|
app |
string | Sim | Caminho ou nome da app |
version |
string | Nao | Versao especifica |
instance |
string | Nao | Instancia alvo |
skip_tests |
boolean | Nao | Pular testes |
Retorno:
{
"success": true,
"version": "v1.2.0",
"instance": "production",
"duration_ms": 45000
}runner_rollback
Reverte para versao anterior.
Parametros:
| Nome | Tipo | Obrigatorio | Descricao |
|---|---|---|---|
app |
string | Sim | Caminho ou nome da app |
instance |
string | Nao | Instancia alvo |
to |
string | Nao | Versao especifica |
Application Management
runner_list_apps
Lista todas as aplicacoes registradas.
Parametros: Nenhum
Retorno:
{
"apps": [
{
"name": "meu-app",
"path": "/apps/usuario_meu-app",
"instances": ["production", "staging"]
}
]
}runner_app_status
Retorna status detalhado de uma app.
Parametros:
| Nome | Tipo | Obrigatorio | Descricao |
|---|---|---|---|
app |
string | Sim | Caminho ou nome da app |
runner_add_app
Registra nova aplicacao.
Parametros:
| Nome | Tipo | Obrigatorio | Descricao |
|---|---|---|---|
repo |
string | Sim | Repositorio GitHub |
deploy |
boolean | Nao | Executar deploy apos add |
Instance Management
runner_instances
Lista instancias de um projeto.
Parametros:
| Nome | Tipo | Obrigatorio | Descricao |
|---|---|---|---|
project |
string | Sim | Nome do projeto |
runner_versions
Lista versoes de uma instancia.
Parametros:
| Nome | Tipo | Obrigatorio | Descricao |
|---|---|---|---|
project |
string | Sim | Nome do projeto |
instance |
string | Sim | Nome da instancia |
runner_destroy_instance
Remove instancia completamente.
Parametros:
| Nome | Tipo | Obrigatorio | Descricao |
|---|---|---|---|
project |
string | Sim | Nome do projeto |
instance |
string | Sim | Nome da instancia |
Canary Deployment
runner_weights
Mostra distribuicao de trafego.
Parametros:
| Nome | Tipo | Obrigatorio | Descricao |
|---|---|---|---|
project |
string | Sim | Nome do projeto |
instance |
string | Sim | Nome da instancia |
Retorno:
{
"distribution": {
"v1.0.0": 90,
"v1.0.1-rc1": 10
}
}runner_set_weight
Ajusta peso de versao.
Parametros:
| Nome | Tipo | Obrigatorio | Descricao |
|---|---|---|---|
project |
string | Sim | Nome do projeto |
instance |
string | Sim | Nome da instancia |
version |
string | Sim | Versao |
weight |
integer | Sim | Peso (0-100) |
runner_promote
Promove versao para 100%.
Parametros:
| Nome | Tipo | Obrigatorio | Descricao |
|---|---|---|---|
project |
string | Sim | Nome do projeto |
instance |
string | Sim | Nome da instancia |
version |
string | Sim | Versao a promover |
Staging (PR Environments)
runner_stage_deploy
Cria ambiente de staging para PR.
Parametros:
| Nome | Tipo | Obrigatorio | Descricao |
|---|---|---|---|
repo |
string | Sim | Repositorio GitHub |
pr |
integer | Sim | Numero da PR |
Retorno:
{
"id": "staging_meu-app_pr42",
"url": "https://pr-42.staging.meusite.com.br",
"ttl_hours": 48
}runner_stage_list
Lista ambientes de staging ativos.
Parametros: Nenhum
runner_stage_destroy
Remove ambiente de staging.
Parametros:
| Nome | Tipo | Obrigatorio | Descricao |
|---|---|---|---|
id |
string | Sim | ID do staging |
runner_stage_cleanup
Limpa stagings expirados.
Parametros: Nenhum
Environment Management
runner_env_status
Mostra variaveis de ambiente.
Parametros:
| Nome | Tipo | Obrigatorio | Descricao |
|---|---|---|---|
app |
string | Sim | Caminho da app |
runner_env_set
Define variavel de ambiente.
Parametros:
| Nome | Tipo | Obrigatorio | Descricao |
|---|---|---|---|
app |
string | Sim | Caminho da app |
key |
string | Sim | Nome da variavel |
value |
string | Sim | Valor |
secret |
boolean | Nao | Se e secret |
runner_env_validate
Valida variaveis obrigatorias.
Parametros:
| Nome | Tipo | Obrigatorio | Descricao |
|---|---|---|---|
app |
string | Sim | Caminho da app |
required |
string | Sim | Lista separada por virgula |
Configuration
runner_validate_config
Valida arquivo .deploy.yml.
Parametros:
| Nome | Tipo | Obrigatorio | Descricao |
|---|---|---|---|
path |
string | Sim | Caminho do arquivo |
runner_generate_config
Gera template de configuracao.
Parametros: Nenhum
Retorno: Template YAML completo
Maintenance
runner_fetch
Busca atualizacoes nas apps.
Parametros:
| Nome | Tipo | Obrigatorio | Descricao |
|---|---|---|---|
deploy |
boolean | Nao | Executar deploy se houver mudancas |
runner_cleanup
Limpa versoes antigas.
Parametros:
| Nome | Tipo | Obrigatorio | Descricao |
|---|---|---|---|
expired |
boolean | Nao | Incluir instancias expiradas |
Logs
runner_logs_history
Historico de deploys.
Parametros:
| Nome | Tipo | Obrigatorio | Descricao |
|---|---|---|---|
app |
string | Sim | Caminho da app |
limit |
integer | Nao | Numero de entradas |
runner_logs_tail
Ultimas linhas de log.
Parametros:
| Nome | Tipo | Obrigatorio | Descricao |
|---|---|---|---|
app |
string | Sim | Caminho da app |
lines |
integer | Nao | Numero de linhas |