InstaPods

Implante e gerencie pods de hospedagem a partir do Claude, Cursor ou qualquer cliente MCP. De localhost para URL ativa em uma única etapa.

Documentação

InstaPods SDK

Ferramentas e integrações para implantar e gerenciar aplicativos no InstaPods com assistentes de IA.

InstaPods é hospedagem de contêineres para desenvolvedores — implante aplicativos Node.js, Python, PHP e estáticos com um único comando. Este SDK oferece duas maneiras de integrar o InstaPods ao Claude:

Caminhos de Integração

Claude Code (CLI Skill)

Uma skill que ensina o Claude Code a implantar e depurar aplicativos usando a CLI instapods.

Configuração:

  1. Instale a CLI:

    curl -fsSL https://instapods.com/install.sh | sh
    instapods auth login
    
  2. Copie a skill para o seu projeto:

    mkdir -p .claude/skills/instapods-cli
    curl -fsSL https://raw.githubusercontent.com/instapods/sdk/main/skills/instapods-cli/SKILL.md \
      -o .claude/skills/instapods-cli/SKILL.md
    
  3. Peça ao Claude Code para implantar:

    > deploy my app to instapods
    > my app is returning 502, help me debug
    > add a PostgreSQL database to my pod
    

Claude Desktop / Claude.ai (MCP Skill)

Duas opções — use a skill MCP para fluxos de trabalho guiados ou conecte-se diretamente via MCP.

Opção A: Skill MCP (recomendada)

Copie a skill para o seu projeto:

mkdir -p .claude/skills/instapods-mcp
curl -fsSL https://raw.githubusercontent.com/instapods/sdk/main/skills/instapods-mcp/SKILL.md \
  -o .claude/skills/instapods-mcp/SKILL.md

Opção B: Conexão MCP direta

Adicione à configuração do Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "instapods": {
      "url": "https://app.instapods.com/api/mcp"
    }
  }
}

No primeiro uso, o Claude o guiará pela autenticação OAuth. Consulte mcp/README.md para o guia de configuração completo.

O servidor MCP inclui prompts integrados:

  • deploy-app — Fluxo de trabalho de implantação guiado
  • debug-pod — Diagnóstico sistemático de pod
  • getting-started — Visão geral das ferramentas e recursos disponíveis

O que há neste repositório

sdk/
├── README.md                              # This file
├── server.json                            # MCP Registry manifest (see below)
├── skills/
│   ├── instapods-cli/
│   │   └── SKILL.md                       # Skill for Claude Code (uses CLI)
│   └── instapods-mcp/
│       └── SKILL.md                       # Skill for Claude Desktop/Claude.ai (uses MCP tools)
├── mcp/
│   └── README.md                          # MCP server setup guide
└── cli/
    └── README.md                          # CLI quick reference

MCP Registry

InstaPods está listado no MCP Registry oficial como com.instapods/instapods. server.json neste repositório é a fonte da verdade para essa listagem:

curl -s "https://registry.modelcontextprotocol.io/v0/servers?search=instapods"

Para publicar uma atualização, incremente version em server.json e envie uma tag correspondente:

git tag mcp-v1.1.0 && git push origin mcp-v1.1.0

Isso executa .github/workflows/publish-mcp-registry.yml, que publica via mcp-publisher. O registro rejeita uma versão que já existe, então cada publicação precisa de um novo version.

A autenticação é baseada em domínio: o namespace do registro com.instapods/* é comprovado pela chave pública Ed25519 servida em https://instapods.com/.well-known/mcp-registry-auth. O fluxo de trabalho assina com a chave privada correspondente do segredo do repositório MCP_REGISTRY_PRIVATE_KEY. O GitHub OIDC não é uma opção aqui — ele só concede o namespace io.github.*.

Links

Licença

MIT