# MCP Server

O Runner inclui um servidor MCP (Model Context Protocol) para integracao com Claude Code.

# Visao Geral

O MCP Server permite que Claude Code interaja diretamente com o sistema de deploy, executando operacoes como:

• Verificar status de aplicacoes
• Executar deploys
• Gerenciar canary deployments
• Criar ambientes de staging
• Consultar logs e historico

# Instalacao

# Automatica

runner mcp install

# Manual

Adicione ao config do Claude Code:

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

# Arquitetura

Claude Code
    |
    | stdio (JSON-RPC 2.0)
    |
    v
Runner MCP Server
    |
    | subprocess
    |
    v
Runner CLI
    |
    v
Docker / Traefik / Git

O servidor MCP atua como ponte entre Claude Code e o sistema de deploy:

1. Recebe requests JSON-RPC via stdio
2. Traduz para comandos CLI do Runner
3. Executa via subprocess
4. Retorna resultado formatado

# Componentes

# Tools (25+)

Operacoes executaveis que modificam estado:

• Deploy, rollback, canary
• Staging de PRs
• Gerenciamento de ambiente

Documentacao completa de Tools

# Resources (9)

Dados para consulta (read-only):

• Instrucoes estaticas de documentacao
• Status dinamico de apps e staging

Documentacao completa de Resources

# Prompts (5)

Workflows guiados para tarefas complexas:

• Setup de novo projeto
• Diagnostico de falhas
• Canary deployment

Documentacao completa de Prompts

# Verificar Status

runner mcp status

Output:

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

  Tools: 25
  Resources: 9
  Prompts: 5

# Uso no Claude Code

Apos instalacao, as tools ficam disponiveis naturalmente:

User: Liste as aplicacoes registradas no Runner

Claude: [executa runner_list_apps]
        Aqui estao as apps registradas:
        - meu-app (production)
        - outro-app (production, staging)

User: Faca deploy do meu-app

Claude: [executa runner_deploy com app="meu-app"]
        Deploy iniciado para meu-app v1.2.0
        Status: success

# Seguranca

• O servidor executa com as mesmas permissoes do binario Runner
• Comandos sao executados via subprocess isolado
• Logs de execucao em /opt/runner/logs/mcp.json

# Troubleshooting

# Server nao inicia

# Verificar permissoes
ls -la /opt/runner/runner

# Testar manualmente
/opt/runner/runner mcp serve

# Config nao encontrada

# Verificar local
runner mcp status

# Reinstalar
runner mcp uninstall
runner mcp install

# Claude Code nao reconhece

1. Reinicie o Claude Code apos instalar
2. Verifique se o binario esta no PATH ou use caminho absoluto