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 serveInicia o servidor MCP via stdio. Este comando e usado internamente pelo Claude Code.
Instalar Configuracao
runner mcp installInstala a configuracao MCP no Claude Code.
O que faz:
- Localiza config do Claude Code
- Adiciona entrada
runnernos MCP servers - 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 uninstallRemove a configuracao MCP do Claude Code.
Verificar Status
runner mcp statusOutput:
MCP Server Status:
Version: 1.1.0
Config: /home/user/.config/claude/claude_desktop_config.json
Status: installed
Tools: 25
Resources: 9
Prompts: 5Configuracao 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/overviewrunner://instructions/deploy-flowrunner://instructions/canaryrunner://instructions/stagingrunner://instructions/config-formatrunner://instructions/troubleshooting
Status Dinamico
runner://status/apps- JSON com apps registradasrunner://status/staging- JSON com stagings ativosrunner://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