InstaPods

InstaPods SDK

AI アシスタントを使って InstaPods 上でアプリをデプロイおよび管理するためのツールとインテグレーションです。

InstaPods は開発者向けのアプリホスティングサービスです。実際の Linux サーバーを、コマンド 1 つで利用できます。Node.js、Python、PHP、静的アプリを数秒でデプロイできます。この SDK では、Claude と InstaPods を連携する 2 つの方法を提供します。

インテグレーション方法

Claude Code（CLI スキル）

instapods CLI を使ってアプリをデプロイ、デバッグする方法を Claude Code に教えるスキルです。

セットアップ：

1. CLI をインストールします：

   curl -fsSL https://instapods.com/install.sh | sh
   instapods auth login
   

2. スキルをプロジェクトにコピーします：

   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. Claude Code にデプロイを依頼します：

   > 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 スキル）

2 つの方法があります。ガイド付きワークフローには MCP スキルを使用するか、MCP 経由で直接接続します。

オプション A：MCP スキル（推奨）

スキルをプロジェクトにコピーします：

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

オプション B：MCP への直接接続

Claude Desktop の設定（~/Library/Application Support/Claude/claude_desktop_config.json）に追加します：

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

初回利用時に、Claude が OAuth 認証を案内します。セットアップの詳細は、mcp/README.md を参照してください。

MCP サーバーには、以下の組み込みプロンプトがあります：

• deploy-app — ガイド付きデプロイワークフロー
• debug-pod — システマティックなポッド診断
• getting-started — 利用可能なツールとリソースの概要

このリポジトリの内容

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 レジストリ

InstaPods は公式の MCP Registry に com.instapods/instapods として登録されています。このリポジトリの server.json が登録情報の正となるファイルです：

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

更新を公開するには、server.json の version を更新してから、一致するタグをプッシュします：

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

これにより .github/workflows/publish-mcp-registry.yml が実行され、 mcp-publisher 経由で公開されます。レジストリは既存のバージョンを拒否するため、公開するたびに新しい version が必要です。

認証はドメインベースです。レジストリの名前空間 com.instapods/* は、https://instapods.com/.well-known/mcp-registry-auth で提供される Ed25519 公開鍵によって証明されます。ワークフローでは、リポジトリシークレット MCP_REGISTRY_PRIVATE_KEY にある対応する秘密鍵で署名します。GitHub OIDC は利用できません。許可されるのは io.github.* 名前空間のみです。

リンク

• InstaPods ダッシュボード
• ドキュメント
• CLI リリース
• MCP Registry の登録情報

ライセンス

MIT