Slide MCP Server

Slide MCP Server

slide-mcp-server conecta assistentes de IA à API Slide BCDR. É um único binário Go com ferramentas orientadas a tarefas para saúde de backup, recuperação de arquivos, snapshots, alertas, VMs de recuperação, exportações de imagem, redes de DR e administração de conta.

Ele suporta os dois principais ecossistemas MCP locais:

• Anthropic: um pacote MCP do Claude Desktop de arrastar e soltar, além do registro no Claude Code.
• OpenAI: registro no Codex desktop, CLI e IDE por meio da configuração MCP compartilhada.

O servidor usa stdio JSON-RPC, não tem dependências de runtime e nunca grava o token da API Slide neste repositório.

Instalação

Claude Desktop: arrastar e soltar

1. Baixe slide-mcp-server.mcpb.
2. Arraste-o para Claude Desktop → Configurações → Extensões.
3. Cole um token da API Slide de console.slide.tech em Minhas Configurações → Tokens de API.

O pacote contém binários macOS universal, Linux amd64/arm64 e Windows amd64. Seu binário macOS é assinado com Developer ID e notarizado pela Apple, portanto uma verificação normal do Gatekeeper online é executada sem aviso.

A URL de download estável sempre aponta para a versão mais recente do GitHub. O instalador pré-MCPB descontinuado também continua funcionando: as versões publicam seus nomes históricos de artefatos macos-x64, macos-arm64, linux-x64, linux-arm64 e windows-x64.

Pacotes privados do Claude Desktop instalados manualmente não se atualizam automaticamente no momento. Reinstale o .mcpb estável para atualizar enquanto a extensão for privada. A Anthropic permite atualizações automáticas de extensões distribuídas por meio de seu diretório oficial; o manifesto está preparado para esse caminho de envio. Consulte o guia de extensões locais da Anthropic.

OpenAI Codex

A partir de um clone:

make build
SLIDE_API_KEY=tk_... make install-codex
codex mcp get slide

Ou registre qualquer binário baixado diretamente:

codex mcp add slide --env SLIDE_API_KEY=tk_... -- /absolute/path/to/slide-mcp-server

As superfícies Codex desktop, CLI e IDE compartilham a configuração MCP. Reexecutar make install-codex substitui o registro slide existente com segurança.

Claude Code

make build
SLIDE_API_KEY=tk_... make install-claude-code
claude mcp list

O registro direto também funciona:

claude mcp add slide --env SLIDE_API_KEY=tk_... -- /absolute/path/to/slide-mcp-server

Cursor e outros hosts MCP stdio

Baixe o binário para sua plataforma e configure o equivalente a:

{
  "mcpServers": {
    "slide": {
      "command": "/absolute/path/to/slide-mcp-server",
      "env": {
        "SLIDE_API_KEY": "tk_...",
        "SLIDE_TOOLS": "safe"
      }
    }
  }
}

O que perguntar

• "Todos os meus boxes Slide estão saudáveis?"
• "Os backups foram executados ontem à noite para a ACME?"
• "Encontre Q4-budget.xlsx no laptop do Bob e restaure a versão de terça-feira."
• "Quais alertas não resolvidos eu tenho? Ordene os piores primeiro."
• "Inicie uma VM de recuperação para DC-01."
• "O que mudou nas últimas 24 horas?"
• "Não sei por onde começar—o que você pode fazer?"

Você não precisa memorizar os identificadores a_..., d_... ou c_.... As operações voltadas ao usuário aceitam name_hint; a correspondência determinística no lado do servidor resolve nomes de exibição e hostnames ou retorna candidatos quando um nome é ambíguo.

Superfície MCP

O servidor expõe 12 ferramentas orientadas a tarefas, além de um alias de compatibilidade. Cada ferramenta principal usa um parâmetro operation em vez de criar uma ferramenta de nível superior separada para cada endpoint da API.

Ferramenta	Finalidade
slide_help	Onboarding integrado, exemplos, glossário, solução de problemas e diagnósticos
slide_overview	Inventário completo, saúde e resumos de clientes/dispositivos
slide_files	Pesquisar, navegar, restaurar e enviar arquivos
slide_recovery	VMs de recuperação, exportações de imagem e redes de DR
slide_audit	Consultas ao log de auditoria da conta
slide_clients	Gerenciamento de clientes
slide_admin	Gerenciamento de usuários e contas
slide_devices	Detalhes do dispositivo, rede e ações do appliance
slide_agents	Configurações do sistema protegido, serviços, agendamentos e retenção
slide_snapshots	Pontos de restauração e resultados de verificação
slide_backups	Status do backup e inicialização de backup
slide_alerts	Revisão, triagem e resolução de alertas
list_all_clients_devices_and_agents	Alias de inventário compatível com versões anteriores

Ele também fornece seis Prompts MCP—incluindo slide.welcome, slide.daily-status e slide.restore-file—e Recursos slide:// estáticos/dinâmicos.

Segurança e confiabilidade

O nível de permissão padrão safe permite trabalho operacional de recuperação, mas bloqueia exclusões, desligamento e reinicialização. Os modos disponíveis são:

Modo	Operações permitidas
read-only	Operações de listar, obter, pesquisar, navegar e diagnosticar
safe	Operações de leitura, além de restaurações, backups e configurações reversíveis
full	Tudo, incluindo operações de exclusão e ciclo de energia

Os nomes legados reporting, restores e full-safe continuam aceitos para que as configurações existentes continuem iniciando.

As proteções de confiabilidade incluem:

• validação de inicialização que nunca bloqueia o handshake de inicialização do MCP;
• prazos de operação de 45 segundos e corpos de resposta upstream limitados;
• repetição/backoff apenas para leituras idempotentes, evitando mutações duplicadas;
• paginação completa e segura contra loops para inventário e saúde de toda a conta;
• erros de API tipados com token oculto e remediação acionável;
• validação de JSON Schema no lado do servidor para entradas e saídas estruturadas;
• diagnósticos --doctor e --debug com segredos mascarados.

Configuração

As flags da CLI substituem as variáveis de ambiente.

Flag	Ambiente	Padrão
--api-key	SLIDE_API_KEY	obrigatório para operação normal
--base-url	SLIDE_BASE_URL	https://api.slide.tech
--tools	SLIDE_TOOLS	safe
--disabled-tools	SLIDE_DISABLED_TOOLS	nenhum
--doctor	—	executar verificações e sair
--debug	—	imprimir um pacote de diagnóstico mascarado e sair
--skip-startup-validation	—	pular a sondagem de conta em segundo plano
--tool / --args	—	executar uma chamada de ferramenta sem um host MCP
--version	—	imprimir a versão e sair

URLs base de API fora de loopback devem usar HTTPS. HTTP simples é aceito apenas para servidores de teste em localhost.

Ambiente de teste

O repositório tem três camadas de teste:

# Deterministic offline suite: API failure injection, permissions, schemas,
# MCP protocol profiles, distribution contracts, and a real stdio subprocess.
make test

# Live, read-only demo/account smoke. Loads ignored .env when present and
# always rebuilds the repository binary before testing.
./smoke_test.sh

# Cross-platform binaries, MCPB structure, checksums, compatibility aliases.
make release

A CI executa testes Go com detecção de corrida, go vet, compilação cruzada, ShellCheck, verificação de artefatos de versão e o validador oficial de manifesto MCPB da Anthropic. Os perfis de protocolo cobrem o caminho 2025-06-18 estabelecido do Claude Desktop e o caminho 2025-11-25 do Codex/MCP atual.

Para inspeção interativa:

SLIDE_API_KEY=tk_... npx @modelcontextprotocol/inspector ./build/slide-mcp-server

Desenvolver

git clone https://github.com/amcchord/slideMCP.git
cd slideMCP
make setup-dev
make test
make build

O cliente da API acompanha a Slide API v1.27.0; o documento OpenAPI em cache é docs/openapi.json. Adicione o comportamento de novos endpoints como uma operação na meta-ferramenta existente mais próxima, a menos que o fluxo de trabalho seja melhor representado por um Prompt ou Recurso MCP.

Diagnósticos úteis:

SLIDE_API_KEY=tk_... build/slide-mcp-server --doctor
build/slide-mcp-server --debug | jq .

Lançamento

Leia docs/SIGNING.md antes de tocar no pipeline de assinatura. Uma versão de produção é intencionalmente cortada de um branch main limpo e já commitado:

./scripts/setup-signing.sh       # first machine only
make doctor-signing
./scripts/release-all-in-one.sh vX.Y.Z

O pipeline de lançamento:

1. verifica se as versões Makefile, config.go e dxt/manifest.json concordam;
2. executa testes de corrida e go vet;
3. compila todos os alvos a partir de um diretório build/ limpo;
4. assina com Developer ID e notariza o executável macOS universal;
5. empacota e verifica o .mcpb;
6. compila nomes de artefatos de instalador atuais e legados, além de somas de verificação SHA-256;
7. reforça a assinatura/notarização novamente antes de criar a tag;
8. envia main, cria a tag e publica a versão no GitHub.

A Apple não pode anexar um ticket a um executável Mach-O bruto. stapled: no é esperado; codesign --test-requirement="=notarized" executa a verificação correta de notarização online.

Licença

MIT