MinTo は静的サイト（HTML / CSS / JS / 画像）のホスティングサービスです。すべての操作は MCP リモートサーバーとして公開されており、
同じ API を minto-cli と GitHub Actions 連携からも利用できます。
API サーバー：https://api.mintoai.net
MCP エンドポイント：https://api.mintoai.net/mcp
認証：OAuth 2.1（PKCE）／ JWT
目次
MCP リモートサーバーとツール一覧
MinTo の全機能は MCP（Model Context Protocol）サーバーとして公開されています。エンドポイントは
https://api.mintoai.net/mcp（StreamableHTTP、OAuth 2.1 認証）。
接続手順は MCP 設定ガイド を参照してください。
提供している MCP ツール
アカウント・組織
get_current_user list_organizations list_teamsサイト
list_sites create_site update_site delete_site get_site_download_urlデプロイ
get_deployment_upload_url finalize_deployment check_deployment_statusフォーム・コメント
form_create form_update form_list form_delete form_submissions_list form_submission_thread comment_moderateプラン・請求
list_plans create_checkout_session get_billing_portal_urlデプロイの流れ（API）
MCP 経由でも CLI 経由でも、内部では同じ 3 ステップで動いています。自前のツールから叩く場合もこの順序です。
get_deployment_upload_url(site_id)
pending 状態のデプロイが作られ、署名付き S3 互換 URL と deployment_id が返ります（有効期限 15 分）。
ZIP を HTTP PUT
サイト一式を ZIP 化し、返ってきた URL に Content-Type: application/zip で PUT します。ZIP のルートに index.html を置いてください。
finalize_deployment → check_deployment_status
finalize で公開が確定します。レスポンスの seo_check と status 確認時の seo_audit に、title / description / 見出し構造などの自動監査結果が入ります（advisory。デプロイ自体は成功済み）。
get_site_download_url(site_id) で現在公開中のファイルの ZIP を取得し、それに対して編集してから再デプロイしてください。デプロイは差分ではなく全置換です。
form_create / form_update が返す embed_snippet には Cloudflare Turnstile のウィジェットが含まれます。古いスニペットを含む HTML はデプロイ時に拒否されるため、常に最新のレスポンスのスニペットを使ってください。
minto-cli リファレンス
コマンドラインからサイトの作成・デプロイを行うツールです。認証はブラウザによる OAuth 2.1（PKCE）で、トークンは ~/.minto/token に保存されます。
# 1. ログイン（ブラウザが開きます） $ minto-cli login # 2. サイトを作成 $ minto-cli create-site --name "My Site" --subdomain my-site # 3. ビルド成果物をデプロイ（ディレクトリは自動で ZIP 化） $ minto-cli deploy ./dist --site-id <Site ID> # 4. デプロイ状況を確認 $ minto-cli status <Deployment ID> # AI エージェント用のスキルを生成（.agents/skills, .claude/skills） $ minto-cli skills
| コマンド | 説明 | 主なフラグ |
|---|---|---|
login | ブラウザで OAuth ログイン | --server |
create-site | サイト作成（フラグ省略で対話形式） | --name --subdomain --custom-domain --basic-auth --basic-auth-user --basic-auth-password |
deploy <path> | ZIP またはディレクトリをデプロイ | --site-id（省略で一覧から選択） |
update-site | サイト設定の変更（指定した項目だけ更新） | --site-id --name --custom-domain --basic-auth* |
status <id> | デプロイ状況の確認 | — |
sites list / sites delete | サイト一覧・削除 | --site-id |
skills | AI エージェント用スキルファイルを生成 | — |
共通フラグ：--server（既定 https://api.mintoai.net）、--token（省略時は保存済みトークンを使用）
GitHub Actions 連携（プロプラン以上）
サイトに GitHub リポジトリ（owner/repo）とブランチを紐づけると、ワークフローで site という名前のアーティファクトをアップロードするだけで自動デプロイされます。
指定ブランチの実行結果が本番に反映され、それ以外のブランチはプレビューデプロイになります。
name: Deploy to MinTo on: push: branches: [main] jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - run: npm ci && npm run build - uses: actions/upload-artifact@v4 with: name: site # この名前が必須 path: dist
連携の設定は AI に「my-site を GitHub の owner/repo の main ブランチに連携して」と頼むか、update_site の github_repo / github_branch で行います。
リソース構造
すべてのリソースは 組織（Organization）→ チーム（Team）→ サイト（Site） の階層です。ID はすべて UUID（v7）で、get_current_user を最初に呼ぶと所属する組織・チームの ID がまとめて取得できます。
- Organization：課金単位。プラン（free / essential / pro / enterprise）と Stripe の顧客がここに紐づく
- Team：サイトの所属先。
list_sitesは team_id 単位 - Site：name / subdomain / custom_domain / basic_auth / github_repo / github_branch を持つ
- Deployment：サイトに対する各公開。状態は pending → deployed
- Form：サイトに紐づく inquiry（問い合わせ）または comments（コメント欄）
トラブルシューティング
form_list で最新の embed_snippet を取得して差し替えてください。site になっているか、サイトに紐づけたブランチ名と push 先が一致しているかを確認してください。別ブランチの実行はプレビューデプロイとして扱われます。https://api.mintoai.net/mcp です。トークン失効時は各クライアントのコネクタ設定から再認証してください。手順は MCP 設定ガイド にあります。