# MCP Resources

O MCP Server expoe 9 resources para consulta de informacoes.

# Recursos Estaticos (Instrucoes)

Documentacao embarcada no binario.

# runner://instructions/overview

Visao geral do sistema Runner.

Conteudo:

• O que e o Runner
• Features principais
• Arquitetura basica
• Links para documentacao

# runner://instructions/deploy-flow

Fluxo detalhado de deploy.

Conteudo:

• Etapas do pipeline
• Blue-green deployment
• Health checks
• Rollback automatico

# runner://instructions/canary

Guia de canary deployments.

Conteudo:

• O que e canary deployment
• Como funciona no Runner
• Comandos de canary
• Exemplos praticos

# runner://instructions/staging

Documentacao de staging de PRs.

Conteudo:

• Ambientes efemeros
• Configuracao
• Comandos de staging
• TTL e cleanup

# runner://instructions/config-format

Referencia do .deploy.yml.

Conteudo:

• Estrutura do arquivo
• Campos disponiveis
• Exemplos por tipo
• Validacao

# runner://instructions/troubleshooting

Solucao de problemas comuns.

Conteudo:

• Problemas de deploy
• Health check falha
• Staging nao funciona
• Erros de configuracao

# Recursos Dinamicos (Status)

Dados em tempo real do sistema.

# runner://status/apps

Lista de aplicacoes registradas em JSON.

Exemplo de retorno:

{
  "apps": [
    {
      "name": "meu-app",
      "path": "/apps/usuario_meu-app",
      "current_version": "v1.2.0",
      "instances": {
        "production": {
          "domain": "app.meusite.com.br",
          "version": "v1.2.0",
          "status": "healthy"
        },
        "staging": {
          "domain": "staging.meusite.com.br",
          "version": "develop-abc123",
          "status": "healthy"
        }
      },
      "last_deploy": "2026-02-12T10:30:00Z"
    }
  ],
  "total": 1,
  "timestamp": "2026-02-12T11:00:00Z"
}

# runner://status/staging

Ambientes de staging ativos em JSON.

Exemplo de retorno:

{
  "staging_environments": [
    {
      "id": "staging_meu-app_pr42",
      "project": "meu-app",
      "pr": 42,
      "branch": "feature/login",
      "domain": "pr-42.staging.meusite.com.br",
      "status": "healthy",
      "created_at": "2026-02-12T08:00:00Z",
      "expires_at": "2026-02-14T08:00:00Z",
      "ttl_remaining_hours": 45
    }
  ],
  "total": 1,
  "max_allowed": 20,
  "timestamp": "2026-02-12T11:00:00Z"
}

# runner://status/config

Configuracao global do Runner em JSON.

Exemplo de retorno:

{
  "runner_version": "1.1.0",
  "config": {
    "apps_path": "/apps",
    "traefik_dynamic_path": "/etc/traefik/dynamic",
    "state_path": "/opt/runner/state",
    "logs_path": "/opt/runner/logs",
    "keep_versions": 3,
    "staging": {
      "enabled": true,
      "default_ttl_hours": 48,
      "max_total_instances": 20
    }
  },
  "registered_apps": 5,
  "active_stagings": 2,
  "timestamp": "2026-02-12T11:00:00Z"
}

# Uso no Claude Code

Resources podem ser consultados diretamente:

User: Quais apps estao registradas?

Claude: [le resource runner://status/apps]
        Existem 5 apps registradas:
        1. meu-app (production v1.2.0, staging develop-abc123)
        2. outro-app (production v2.0.0)
        ...

User: Qual a configuracao do Runner?

Claude: [le resource runner://status/config]
        O Runner esta configurado com:
        - Apps path: /apps
        - Keep versions: 3
        - Staging: habilitado (max 20 instancias)
        ...

# Diferenca entre Tools e Resources