runner mcp

Comandos para gerenciar o servidor MCP (Model Context Protocol).

Visao Geral

O MCP Server permite integracao com Claude Code, disponibilizando tools para gerenciamento de deploys diretamente no assistente.

Comandos

Iniciar Servidor

runner mcp serve

Inicia o servidor MCP via stdio. Este comando e usado internamente pelo Claude Code.

Instalar Configuracao

runner mcp install

Instala a configuracao MCP no Claude Code.

O que faz:

  1. Localiza config do Claude Code
  2. Adiciona entrada runner nos MCP servers
  3. Configura comando e argumentos

Locais de config:

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

Desinstalar Configuracao

runner mcp uninstall

Remove a configuracao MCP do Claude Code.

Verificar Status

runner mcp status

Output:

MCP Server Status:
  Version: 1.1.0
  Config: /home/user/.config/claude/claude_desktop_config.json
  Status: installed

  Tools: 25
  Resources: 9
  Prompts: 5

Configuracao Manual

Se preferir configurar manualmente, adicione ao config do Claude Code:

{
  "mcpServers": {
    "runner": {
      "command": "/opt/runner/runner",
      "args": ["mcp", "serve"]
    }
  }
}

Tools Disponiveis

Apos instalar, o Claude Code tera acesso a:

Deploy

Tool Descricao
runner_deploy Executa deploy
runner_rollback Rollback para versao anterior

Gerenciamento

Tool Descricao
runner_list_apps Lista apps registradas
runner_app_status Status de uma app
runner_add_app Registra nova app

Instancias

Tool Descricao
runner_instances Lista instancias
runner_versions Lista versoes
runner_destroy_instance Remove instancia

Canary

Tool Descricao
runner_weights Mostra distribuicao
runner_set_weight Ajusta peso
runner_promote Promove versao

Staging

Tool Descricao
runner_stage_deploy Deploy de PR
runner_stage_list Lista stagings
runner_stage_destroy Remove staging
runner_stage_cleanup Cleanup expirados

Environment

Tool Descricao
runner_env_status Mostra variaveis
runner_env_set Define variavel
runner_env_validate Valida variaveis

Manutencao

Tool Descricao
runner_fetch Busca atualizacoes
runner_cleanup Limpa versoes antigas
runner_validate_config Valida .deploy.yml
runner_generate_config Gera template

Logs

Tool Descricao
runner_logs_history Historico de deploys
runner_logs_tail Ultimas linhas

Resources

O MCP Server expoe resources para consulta:

Documentacao

  • runner://instructions/overview
  • runner://instructions/deploy-flow
  • runner://instructions/canary
  • runner://instructions/staging
  • runner://instructions/config-format
  • runner://instructions/troubleshooting

Status Dinamico

  • runner://status/apps - JSON com apps registradas
  • runner://status/staging - JSON com stagings ativos
  • runner://status/config - JSON com configuracao

Prompts

Workflows guiados disponiveis:

Prompt Descricao
setup_new_project Configura novo projeto
diagnose_deploy Diagnostica falha de deploy
canary_workflow Guia canary deployment
migrate_config Migra para config v1.0.0
staging_pr Deploy de PR para staging
By Borlot.com.br on 12/02/2026